ドキュメント · ガイド

nanobot を任意のモデルで

nanobot（HKUDS/nanobot、pip install nanobot-ai）はチャットアプリ、CLI、WebUI で答える個人向け AI アシスタントです。モデルは ~/.nanobot/config.json から来て、providers の下にある組み込みでないキーはすべて OpenAI 互換のエンドポイントです。magpie はそこに magpie プロバイダーを加え、既定モデルを magpie のモデルにします。そのため nanobot で magpie のすべてのモデル（DeepSeek、GLM、Kimi、Qwen、OpenAI や Anthropic のキー、ChatGPT や Copilot のサブスクリプション）が使えます。

nanobot の設定

  1. nanobot を一度実行するnanobot onboard か最初の実行で ~/.nanobot が作られます。
  2. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  3. nanobot の行でモデルを選ぶエージェント ページで nanobot に magpie のモデルを選びます。WSL の nanobot もそこで設定されます。
ターミナル
pip install nanobot-ai && nanobot onboard   # nanobot makes ~/.nanobot
magpie nanobot deepseek/deepseek-v4-pro

config.json に書かれるもの

magpie はゲートウェイの /v1 を指す providers.magpie を、ゲートウェイのキーと User-Agent nanobot（ないと OpenAI SDK のものになり、誰からか分かりません）付きで加え、agents.defaults を provider magpie、model magpie/<モデル id>、magpie が知るそのモデルのコンテキストウィンドウにします。nanobot は magpie/ の接頭辞を外してモデルを送ります。

ターミナル
// ~/.nanobot/config.json
{
  "providers": {
    …,
    "magpie": {"apiBase": "http://127.0.0.1:3425/v1", "apiKey": "…",
               "extraHeaders": {"User-Agent": "nanobot"}}
  },
  "agents": {"defaults": {
    "provider": "magpie",
    "model": "magpie/deepseek/deepseek-v4-pro",
    "contextWindowTokens": …
  }}
}

nanobot の pydantic モデルは camelCase と snake_case のキーをどちらも読みます。magpie は nanobot 自身が書く camelCase で書き、同じキーの snake_case 表記は外すので、食い違う設定は残りません。

modelPreset

agents.defaults.modelPreset が modelPresets の一つを指すと、provider と model の両方より優先されます。そのため magpie は使用中それを記録して外し、外すときに戻します。modelPresets 自体はそのままです。

反映されるタイミング

nanobot の gateway（nanobot gateway、WebUI が使うもの）はファイルを監視し、次の返答で変更を使います。nanobot agent は起動時に一度だけ読むので、開いている nanobot agent のチャットは開き直してください。nanobot の起動中は magpie もそう知らせます。

自分の設定

agents.defaults にあった provider、model、コンテキストウィンドウ、modelPreset は記録され、magpie を外すと戻ります。ほかのプロバイダー、プリセット、キーはそのままです。magpie が作った config.json は、中身が何も残らなければ消えます。nanobot で magpie プロバイダーを消すと、magpie のチェックがもう magpie を通らないと知らせます。

元に戻す

magpie で行を既定に戻すと、providers.magpie を外し、agents.defaults を戻します。自分のモデルを選ぶと、戻したうえでそれを model にします。

ターミナル
magpie nanobot default

よくある質問

nanobot で DeepSeek、GLM、Kimi、Qwen は使えますか？

使えます。magpie が ~/.nanobot/config.json に OpenAI 互換の magpie プロバイダーを加え、既定モデルを magpie で選んだモデルにします。

nanobot が前のモデルのままです。

gateway と WebUI は次の返答で反映します。nanobot agent は起動時に一度だけ読むので、チャットを開き直してください。

modelPreset は消えますか？

いいえ。magpie は agents.defaults.modelPreset を記録して外し（magpie のモデルより優先されるため）、外すときに戻します。modelPresets はそのままです。

WSL の nanobot でも使えますか？

使えます。magpie は WSL ディストリビューションの nanobot も設定します。

同じモデルを他のエージェントでも：OpenClaw を任意のモデルで、Hermes Agent を任意のモデルで、OpenChamber を任意のモデルで、AstrBot を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。