nanobot

nanobot 是轻量级终端 Agent。它通过 JSON 配置 Provider 和模型预设，可直接使用 ModelGo 的 OpenAI 兼容 API。

接入前准备

• 已安装 Python 3.11+。
• 已在 ModelGo 控制台创建 API Key。
• 已在模型广场确认逻辑模型名。

1. 安装 nanobot

python -m pip install nanobot-ai
nanobot onboard --wizard

配置文件默认位于 ~/.nanobot/config.json。

2. 配置 ModelGo Provider

编辑 ~/.nanobot/config.json，合并以下字段：

{
  "providers": {
    "modelgo": {
      "apiKey": "${MODELGO_API_KEY}",
      "apiBase": "https://api.modelgo.com/v1"
    }
  },
  "modelPresets": {
    "ModelGo": {
      "provider": "modelgo",
      "model": "你的模型名",
      "maxTokens": 4096,
      "contextWindowTokens": 65536,
      "temperature": 0.1
    }
  },
  "agents": { "defaults": { "modelPreset": "ModelGo" } }
}

export MODELGO_API_KEY="sk-你的token"

nanobot 对 OpenAI 兼容自定义端点无需额外填写 apiType；apiBase 使用带 /v1 的根地址。

3. 验证连接

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"
nanobot agent -m "请用一句话介绍当前项目"

常见问题

nanobot 找不到模型

确认 modelPresets.ModelGo.provider 与 providers.modelgo 的 ID 一致，并检查 JSON 格式。

401 或请求地址错误

确认 API Key 环境变量已导出，apiBase 为 https://api.modelgo.com/v1，不要追加 /chat/completions。

相关文档

• 首次调用：创建 API Key、查询模型并验证 ModelGo 接口。
• nanobot OpenAI 兼容 Provider 指南：查看完整 JSON 配置说明。
• 认证鉴权：了解 API Key 的安全使用方式。