nanobot 接入 Models Hub:编辑 config.json

nanobot(项目地址 HKUDS/nanobot)是一个轻量级开源个人 AI 智能体框架,支持 Web UI、Telegram、Discord、Slack 等多种渠道,以及工具调用、长期记忆等能力。它通过单个 config.json 文件配置模型供应商,把供应商指向 Models Hub 后,nanobot 的对话与自动化都会用 Models Hub 的额度。本文只讲接入,其它功能见项目文档。

准备

• 已安装 uv。
• 一个 Models Hub API Key。在控制台的 令牌页 创建,令牌所在分组要能访问你打算用的模型。

推荐模型

模型名以 模型定价页 为准。

配置步骤

1. 安装 nanobot:

   uv tool install nanobot-ai

   Windows 用户需把 .local/bin 加入环境变量才能直接调用 nanobot:

   $env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"

   运行 nanobot --version 确认安装成功。

2. 初始化配置:

   nanobot onboard

   会在用户目录下创建配置文件:Windows 为 %USERPROFILE%\.nanobot\config.json,Linux/macOS 为 ~/.nanobot/config.json。

3. 编辑 config.json,把 providers 和 agents.defaults 指向 Models Hub:

   {
     "agents": {
       "defaults": {
         "model": "claude-sonnet-4-6",
         "provider": "modelsok"
       }
     },
     "providers": {
       "modelsok": {
         "apiKey": "your-modelsok-api-key",
         "apiBase": "https://modelsok.com/v1"
       }
     }
   }

   apiBase 必须以 /v1 结尾;model 必须是 Models Hub 控制台中实际暴露的模型 ID。多个 provider 可并列配置,agents.defaults.provider 指定默认使用哪个。⚠️ 较新版本支持用 modelPresets 定义多套模型再按 modelPreset 名称引用,这里给出的是向下兼容的直接写法,以当前版本为准。

验证

启动交互式对话:

nanobot

输入任意问题,例如「你好,告诉我今天是星期几」,模型正常响应即配置成功。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。

常见报错

更多排查见 故障排查。

常见问题

计费方式? 按每次请求实际消耗的输入与输出 token 计费,价格看各模型定价页。

和直接用官方 API 有什么区别? 请求格式一致,只是把 apiBase 换成了 Models Hub 的地址。

怎么切换模型? 直接修改 config.json 中的 agents.defaults.model,保存后重启 nanobot 即可。

相关

• CLI 一键配置
• 模型定价 与 模型状态页
• Hermes Agent 接入、Memoh 接入