nanobot 的 Busabase 接入

把 nanobot 接上 Busabase

香港大学数据智能实验室(HKUDS)的超轻量开源自托管个人智能体(Python,PyPI 包名 `nanobot-ai`),带网页界面、终端界面、聊天渠道、技能与 MCP。

粘贴到 nanobot 里

请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。

阅读 nanobot 的 Skill 官方文档
Busabase
Agent Skill
Busabase 工作区里的一张文章数据表,包含记录、视图和 Agent 提示词

把这一句话交给你的 agent

你拿到的比一个连接器多:busabase skill 里带着完整的变更请求工作流、CLI 和全部 API——以后每个会话都在,不用再粘一遍。

先问你

Busabase Cloud 还是本地桌面版——动手之前先由你决定。

完成连接

帮你登录并自己保管凭证,不用手工复制 API Key。

建好第一个 Base

创建并填充数据,工作区打开时不会是一片空白。

装上常驻 skill

busabase 与 busabase-app-creator 长期驻留,此后每次会话都能直接用。

这个 agent 的注意事项

技能是带 `SKILL.md` 的目录(YAML 头信息 `name`、`description`、`metadata` 加 Markdown 正文),格式改编自 OpenClaw;自定义技能放在智能体工作区 `~/.nanobot/workspace/skills/`。网页界面(Skills -> Discover)可从 skills.sh 与 SkillHub 安装(skills.sh 需要 `npx`),也可用自带的 `clawhub` 技能。文档没有声明是否遵循 agentskills.io 开放规范,只说沿用 OpenClaw 约定。受限访问模式下,shell 和文件操作被限制在所选项目内。

更想要连接器?

如果你不打算让 agent 自己装 skill,而是想把 Busabase 作为 MCP 工具接入,用下面这个服务器地址。

接入概览

厂商
HKUDS (HKU Data Intelligence Lab)
接入方式
MCP + OAuth · MCP + API Key · 插件 / Skill · busabase-cli · REST API
传输方式
Streamable HTTP
认证方式
OAuth(动态注册)
配置文件
~/.nanobot/config.json -> tools.mcpServers.<name>; OAuth tokens in <data dir>/auth/mcp.json
执行这段命令
curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh   (or: uv tool install nanobot-ai)

nanobot 能使用 shell 和网页抓取,因此走 Skill 路径:把上面的提示词发给网页界面、终端界面或已接入的聊天应用即可。

更想用连接器?

nanobot 支持带浏览器 OAuth 和动态客户端注册的远程 MCP。

  1. 打开网页界面(nanobot webui)-> Apps -> MCP -> Add MCP server -> Custom。
  2. 选择 HTTP,填入 https://busabase.com/api/mcp,把 Authentication 设为 OAuth,保存。
  3. 点击 Connect,在弹出的浏览器窗口里授权。
  4. 让智能体调用 auth_verify。

也可以手动编辑 ~/.nanobot/config.json,然后到 Apps -> MCP 点 Connect:

{
  "tools": {
    "mcpServers": {
      "busabase": {
        "type": "streamableHttp",
        "url": "https://busabase.com/api/mcp",
        "auth": "oauth"
      }
    }
  }
}

API Key 方案:把 "auth": "oauth" 换成 "headers": { "Authorization": "Bearer ${BUSABASE_KEY}" }(密钥来自 Busabase 设置 -> API Keys)。

nanobot MCP 配置文档

已知的坑

HTTP/SSE 的 MCP 地址会经过 SSRF 防护(默认拦截内网、回环、CGNAT 地址段)。如果远程访问的网页界面走的是纯 HTTP,nanobot 会注册一个 localhost 回调,授权后需要你粘贴完整回调地址;建议使用 HTTPS 并配置 `channels.websocket.publicWsUrl`。OAuth 令牌不在 config.json 里,而在 `auth/mcp.json`。文档没有说明请求哪些 OAuth scope;Busabase 对通用 scope 会授予 `mcp`。

接入能力对比

和目录里其他已收录 agent 的接入能力放在一起对比。

能力nanobotClaude CodeCursor
形态Agent 平台终端 AgentAI 编辑器
推荐路径Agent SkillAgent SkillAgent Skill
接入方式MCP + OAuth · MCP + API Key · 插件 / Skill · busabase-cli · REST APIMCP + OAuth · 插件 / SkillMCP + OAuth · 插件 / Skill
传输方式Streamable HTTPStreamable HTTPStreamable HTTP
认证方式OAuth(动态注册)OAuth(动态注册)OAuth(动态注册)
这份说明来自官方文档最后核对于 2026年10月21日

依据该 Agent 自己的官方文档整理,我们尚未在真机上逐步复跑。若命令有变动,请以下方链接的官方文档为准。

让你的 agent 自己完成接入

一句话、一次授权,此后它做的每一个改动都带说明和差异,随时可查、可回滚。

浏览全部 Agent

粘贴到 nanobot 里

请阅读 https://busabase.com/SETUP_SKILL.md,帮我完成 Busabase 的接入。请按文档一路做到底,完成后确认连接是否正常。