跳轉到主要內容
一個輕量級 AI 代理 CLI。官方倉庫： https://github.com/HKUDS/nanobot
協定：OpenAI 相容
  • Base URL： https://api.orcarouter.ai/v1（必須包含 /v1）

​
安裝

需先安裝 uv，然後安裝 nanobot 指令： 
uv tool install nanobot-ai

​
設定

編輯 ~/.nanobot/config.json： 
{
  "agents": {
    "defaults": {
      "model": "orcarouter/auto",
      "provider": "custom",
      "maxTokens": 4096,
      "temperature": 0.1
    }
  },
  "providers": {
    "custom": {
      "apiKey": "sk-orca-...",
      "apiBase": "https://api.orcarouter.ai/v1"
    }
  }
}

​
執行

nanobot agent -m "Reply with exactly: OK" --no-logs --no-markdown
預期回覆 OK。

​
注意事項

  • 使用預先定義的 custom provider——不要自創 provider 名稱。自訂名稱會被忽略，並會得到 provider 'None' 錯誤。
  • 不要為 custom provider 加上 apiType 欄位。只有內建的 openai provider 支援 apiType；將它加到 custom 會驗證失敗。
  • base URL 保留尾部的 /v1，且 agents.defaults.provider 必須設為 custom。
  • 模型名稱使用 vendor/model 格式。可將 orcarouter/auto 換成特定模型，例如 anthropic/claude-opus-4.8 或 google/gemini-2.5-flash。

​
啟用思考／推理

在 agents.defaults 下（或 modelPresets 條目中）設定 reasoningEffort。有效值：none ／ low ／ medium ／ high ／ max。省略它（或設為 null）則遵循模型的預設。 
{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4.6",
      "provider": "custom",
      "maxTokens": 16000,
      "reasoningEffort": "high"
    }
  },
  "providers": { "custom": { "apiKey": "sk-orca-...", "apiBase": "https://api.orcarouter.ai/v1" } }
}
maxTokens 必須大於思考預算。 nanobot 會將 reasoningEffort: high 轉換為 Anthropic 的 thinking.budget_tokens；若 maxTokens（例如預設的 4096）較小，上游會回傳 400 max_tokens must be greater than thinking.budget_tokens。將 maxTokens 提高到約 16000 即可修正。（已驗證：回傳 ✻ 391。）