NanobotのAPIコストと設定：プロバイダー、モデル、上限

HKUDSのnanobotは$0です。MITライセンスのソフトウェアを自分でインストールして実行するもので、GitHubリポジトリにもnanobot.wikiにも、プラン、ティア、シート、ホステッドサービスは掲載されていません。予算として見積もるのは、nanobot gatewayを稼働させ続けるマシンの費用、モデルのトークン料金、接続する有料チャネルやツールアカウントです。トークン料金を決めるのは次の2点です。config.jsonに記述するプロバイダーキー。キーだけで通信プロトコルが決まります。そして、nanobotが指示なしに有効化するバックグラウンドジョブです。

GitHubおよびPyPI APIに基づき、2026年9月21日に確認しました。リリースはv0.3.5で、2026年9月15日に公開。パッケージはnanobot-ai 0.3.5、MIT、Python 3.11以降対応で、同日にアップロードされています。リポジトリはMITライセンスで、アーカイブされておらず、確認日に最後のプッシュが行われていました。このページ全体に関わる注記として、以下で引用するドキュメントはmainブランチから読み取ったもので、v0.3.5タグより5日先行しています。そのため、ドキュメントの記述と同梱ソースのデフォルト値は別々に示し、決して混同していません。

まず、料金を確認するnanobotがどれかを確認する

nanobot.aiはnanobotの料金ページではありません。2026年9月21日、obot.aiにリダイレクトされ、タイトルは「Obot | Enterprise AI Control Plane & MCP Gateway」でした。これは別会社のエンタープライズ製品であり、その製品自体も料金を公開していません。同日の/pricing URLは404を返しました。さらに2つの混同があります。明確にnanobotと名付けられたPyPIパッケージは0.4.1で、ロボットナビゲーションフレームワークです。そのためpip install nanobotでは間違ったソフトウェアがインストールされます。また、obot-platform/nanobotはApache-2.0のGoプロジェクトで、READMEの冒頭でメンテナンスモードであると宣言しています。そのため、その設定キーはここには適用されません。

nanobotの料金を項目ごとに確認する

この点には、正直に2つの不足があります。nanobotのCLIリファレンスは、別の「Desktop」ランタイムとの共存について説明していますが、公開ダウンロードページ、リポジトリ、料金は見つかりませんでした。したがって、裏付け可能な主張は、2つの公式ページには有料ティアが公開されていないという限定的なものです。どこにも有料コンポーネントが存在しないという意味ではありません。また、音声の項目は料金の問題ではなく、利用を止める制約です。制約は「カスタムエンドポイントがない」より狭いものです。v0.3.5の文字起こしアダプターはそれぞれapiBaseを受け付けるため、OpenAI形式の文字起こしエンドポイントに置き換えられます。ただし、transcription.provider自体には、そのレジストリにある名前を指定する必要があります。チャットの場合のように、そこへプロバイダーキーを新たに作ることはできません。いずれにせよ、Kunavoは音声テキスト変換モデルを提供していないため、ここでは問題になりません。

nanobotのカスタムプロバイダー：2つの経路と、名前を付けられるのは一方だけ

これは、一般的な「ベースURLを設定する」例が誤る点です。nanobotでは、プロトコルは設定するフィールドではなく、どのプロバイダーキーを記述するかによって選択されます。2つの経路は互換性がありません。

パスA — OpenAI互換。providersの下にキーを作成するか、組み込みのcustomキーを使用し、それをプリセットから参照します。プロバイダーリファレンスによると、カスタムキーは直接のOpenAI互換プロバイダーとして扱われます。nanobotはエンドポイントURLを把握できないためapiBaseは必須で、ローカルサーバーやプライベートプロキシではapiKeyは任意です。apiBaseにはバージョンパスを含めてください。

{
  "providers": {
    "kunavo": {
      "apiKey": "${KUNAVO_API_KEY}",
      "apiBase": "https://api.kunavo.com/v1"
    }
  },
  "modelPresets": {
    "primary": {
      "provider": "kunavo",
      "model": "claude-sonnet-5",
      "maxTokens": 8192,
      "contextWindowTokens": 200000
    },
    "cheap": {
      "provider": "kunavo",
      "model": "claude-haiku-4-5",
      "maxTokens": 8192,
      "contextWindowTokens": 200000
    }
  },
  "agents": {
    "defaults": {
      "modelPreset": "primary",
      "dream": {
        "modelOverride": "cheap"
      }
    }
  }
}

このブロックには、同じリファレンスに基づく3つのルールがあります。openai、openai-codex、github-copilot、lm-studioなどの組み込み名やエイリアスと衝突させないでください。カスタムキーにapiTypeを設定しないでください。これはproviders.openai専用であり、v0.3.5のスキーマでも強制されています。エンドポイントのドキュメントに標準外の思考切り替えが記載されている場合に限り、thinkingStyleを設定してください。受け付けられる値はthinking_type、enable_thinking、reasoning_splitです。モデルIDについては、ドキュメントの一文だけでは不十分で、正確に説明する必要があります。ドキュメントでは、明示的に名前を付けたカスタムプロバイダーの下でモデルが記述どおり送信されるとされています。一方、同梱の0.3.5レジストリでは、動的仕様のstrip_model_prefixesをプロバイダーキー自体の名前と、そのsnake_case形式に設定しています。プロバイダーキーと同じプレフィックスは削除され、それ以外はそのまま処理されるという、ドキュメントの記述が外部プレフィックスについて述べている場合には、両方が成り立ちます。プレフィックスによるプロバイダー推論は、プロバイダー"auto"の下でのみ実行されます。

パスB — Anthropic Messages。このプロトコルにはカスタム名を使用する経路は一切ありません。リファレンスには、任意のカスタムプロバイダー名はOpenAI互換専用であり、Anthropic Messagesのリクエスト形式は使用しないこと、また名前付きカスタム経路はAnthropic互換エンドポイント向けではないことが記載されています。代わりに、組み込みブロックを上書きします。

{
  "providers": {
    "anthropic": {
      "apiKey": "${KUNAVO_API_KEY}",
      "apiBase": "https://api.kunavo.com"
    }
  },
  "modelPresets": {
    "primary": {
      "provider": "anthropic",
      "model": "claude-sonnet-5",
      "maxTokens": 8192,
      "contextWindowTokens": 200000
    }
  },
  "agents": {
    "defaults": {
      "modelPreset": "primary"
    }
  }
}

これはproviders.anthropic自体を編集するため、そのプロバイダーを参照するすべてのプリセットでは、ゲートウェイが直接のAnthropicと並存するのではなく、それを置き換えます。また、ネイティブバックエンドが拒否するため、ここではproxyは利用できません。Kunavoの2つのベースURL規則は、2つの経路に正確に対応します。ベースURLリファレンスにはMessages経路のオリジンと、OpenAI互換経路の/v1形式が示されています。nanobotはこの点で非常に寛容です。同梱の0.3.5 anthropicプロバイダーは、SDKにURLを渡す前に末尾の/v1を削除します。そのコード内のコメントによると、Anthropic SDKがリクエストパスに内部で/v1を追加するためです。したがって、nanobotでは両方の表記が機能します。ベースURLを変更せずにAnthropic SDKへ渡すクライアントでは、この慣例を使わないでください。その場合、追加される/v1が重複します。上記のブロックについて最後に2点あります。contextWindowTokensはv0.3.5におけるnanobot独自のプリセットデフォルトであり、どのモデルにも固有のプロパティではありません。実際の値はモデルページで確認してください。また、fallbackModelsの項目は生のIDではなくプリセット名であり、コンテキストはチェーン内で最小のウィンドウに合わせて設定されます。

nanobotのプロンプトキャッシュは、選択したプロトコルに従う

これはパスAとパスBのコスト上の違いであり、同梱ソースで確認できます。v0.3.5では、プロバイダー仕様にsupports_prompt_cachingがあり、デフォルトはfalseです。これをtrueに設定している仕様はanthropicとopenrouterのちょうど2つです。OpenAI互換クライアントは、そのフラグが設定され、かつモデルIDがanthropic/またはclaudeで始まる場合にのみ、cache-controlマーカーを挿入します。組み込みのcustom仕様と動的に作成されるすべてのカスタムプロバイダーではフラグがfalseのままです。そのため、OpenAI互換のカスタム経路ではキャッシュマーカーは一切送信されませんが、ネイティブのanthropicバックエンドではデフォルトで適用されます。

これはクライアントが送信する内容についての説明であり、エンドポイント側が独自に行う処理についてではありません。エンドポイントは別途サーバー側でキャッシュする場合があります。nanobotには確認手段があり、一方の経路ではprompt_tokens_details.cached_tokensを正規化し、もう一方ではcache_creation_input_tokensとcache_read_input_tokensを読み取ります。Kunavoがこれらのフィールドをnanobotに返すかどうかはここではテストしていないため、定期ジョブをキャッシュ済みとして予算化する前に、実際の呼び出しを1回行って返された使用量を確認してください。プロンプトキャッシュとキャッシュのドキュメントに、動作するキャッシュの状態を示しています。

nanobotに最適なモデル：ベンダーはランキングを公開していない

正直な答えは、nanobot自身が示しているものです。プロバイダーリファレンスによると、ドキュメントに具体的なプロバイダー名を記載しているのはJSONをコピー可能にするためであり、nanobotがプロバイダーをランキングしているためではありません。引用できるベンダーベンチマークはありません。提供されているのはデフォルトです。v0.3.5のエージェントデフォルトでは、anthropic/claude-opus-4-5をプロバイダーauto、最大トークン数8192、コンテキスト200,000トークンという前提で指定しています。このIDはKunavoのカタログにはないため、ここを対象とするプリセットではカタログに実際に掲載されているIDを指定する必要があります。また、IDは変わるため、このページを含むどのページからでもなく、カタログから現在のIDを確認してください。

料金は最新のKunavoカタログ価格です。ジョブ列は、誰かが測定した品質ランキングではなく、nanobotの構造から導いています。 設定ではなく能力に基づくファミリー比較については、Opus対Sonnet対Haikuを参照してください。

計算例：入力したターンと、nanobotが自動的に実行する頻度

これらは実測したタスクコストではなく、請求額の上限でもない、例示的なトークン数に基づく算出です。1つのアシスタントが、30日間、1日20回の入力ターンを処理し、1ターンあたりキャッシュされていない入力トークン10,000個、出力トークン600個と仮定します。1か月あたりの入力トークンは6.0M、出力トークンは0.36Mです。

情報源で確認できるのはスケジュールであり、トークンサイズや実際に課金される実行回数ではありません。nanobotの設定リファレンスでは、ゲートウェイのハートビートがデフォルトで有効になっており、intervalSは1800です。また、v0.3.5のDream設定もデフォルトで有効になっており、intervalHは2です。これにより、30日間ではハートビートティックが1,440回、Dreamティックが360回になります。ティックはモデル呼び出しではありません。同梱のv0.3.5ゲートウェイでは、ハートビートジョブがHEARTBEAT.mdを読み取り、ファイルが存在しないか、## Active Tasks見出しの下に何もない場合はモデルリクエストを行う前に戻ります。Dreamジョブは「nothing to process」とログに記録し、カーソル以降に新しい履歴が蓄積されていない場合は戻ります。したがって、アイドル状態のインストールではどちらのジョブにも費用はかかりません。1,800はスケジュールが許容する上限であり、必ず到達する下限ではありません。nanobotはどちらのジョブについても実行ごとのトークン数を公開していません。そのため、上記3つのサイズは自分で測定した値に置き換えるプレースホルダーであり、これらの実行における出力トークンは除外しています。ここに別のエージェントのハートビート数値を持ち込まないでください。それらは別のプログラムに属します。

2つの調整方法は対称ではありません。Dreamでは、より安価なプリセットを指定するmodelOverrideを受け付けます（プリセット名のみ。生のIDは拒否されます）。これは上記のPath Aブロックにある1行の変更です。ハートビートには文書化されたモデル上書き機能がなく、オプションはenabled、intervalS、keepRecentMessagesです。そのため、実行頻度を下げるか無効化します。また、システム管理のcronジョブであるため、cronツールでは削除できません。設定で無効化してゲートウェイを再起動してください。実行対象のタスクがある場合、ハートビートの評価は、設定リファレンスでモデルストリームを開くと記載されている内部ジョブの1つです。したがってコストはHEARTBEAT.mdに何を入れるかに左右され、空のファイルでは低コストになります。Kunavoのnanobot対OpenClawページには、Dreamがデフォルトでcronスケジュールで実行されるとあります。この点を補足すると、その記述はメモリリファレンスと一致していますが、v0.3.5ではより正確に、2時間ごとの間隔スケジュールで実行され、cronはレガシーの上書き設定となっています。

Kunavoのカタログ金額は上限ではなく請求下限です。上流サービスが料金を報告すると、請求額はカタログコストと、上流コストに適用されるマークアップを掛けた金額のうち大きい方になります。キャッシュ料金、ツール、ホスティングはこれらの例の対象外です。最低チャージ額はプリペイドクレジットの$10です。これは資金調達の最低額であり、タスク料金やサブスクリプションではありません。請求の詳細と、測定方法についてはコスト最適化を参照してください。

ループの上限を設定してから、1回実行して検証する

nanobotの3つのターン単位の上限のうち2つは、設定リファレンスにまったく記載されていません。提供されたv0.3.5のソースを読むと、エージェントのデフォルト値はmax_tool_iterationsが200、max_tool_result_charsが16,000です。文書化されたリファレンスに記載されているのは、デフォルト4のmaxConcurrentSubagentsだけで、mainにあります。200回の反復上限は、コストのかかる暴走ターンの形態なので、継承するのではなく意図的に設定してください。

次に、文書化された順序で検証します。nanobot statusは意図的にモデルリクエストを送らないため、費用をかけずに設定を確認できます。CLIリファレンスでは、その後にnanobot agent -m "Hello!"を実行するよう案内されています。その症状表は、カスタムエンドポイントで発生する4つの失敗を対応付けています。401は、キーがない、期限切れ、空白が付いている、または誤って保存されていることを示します。model not foundは、そのプロバイダーに存在しないIDです。connection refusedは、ローカルのプロバイダーサーバーが起動していないか、apiBaseが誤ったポートを指していることを示します。provider not foundは、アクティブなプリセット内のプロバイダー名のスペルミスです。

次に、トークンではなく金額と照合します。v0.3.5では、nanobotは各プロバイダー呼び出しをsourceとともに記録し、user、api、cron、dream、systemのいずれかで検証します。これはバックグラウンド支出と入力による支出を分ける分類です。ただし、そのモジュールのどこにもコストフィールドはありません。WebUIのグラフは、報告されている場合はキャッシュヒット率とともに、ラウンドごとの入力トークンを表示し、これらの数値は請求明細ではないと明記しています。2026年9月21日に確認したCLIリファレンスにも、集計支出コマンドはありませんでした（これはその文書にないというだけで、存在しないことの証明ではありません）。料金はプロバイダーの台帳で確認してください。

どの経路が勝ち、いくらかかるか

適用範囲について2つの注意点があります。画像生成ではcustomをプロバイダー値として受け付け、デフォルトでは無効になっています。ただし、Kunavoの画像エンドポイントがnanobotの送信するリクエスト形式に一致するかはここでは未検証です。未検証であり、利用可能な機能として扱うものではありません。また、発生しない費用が1つあります。nanobotの永続メモリはベクトルインデックスではなくワークスペース内のプレーンファイルです。Kunavoは埋め込みモデルを提供していないため、この仕組みは好都合です。

Kunavoはnanobot統合ページを公開しておらず、nanobotを自社エンドポイントに対してランタイムテストもしていません。上記の各ブロックはすべて、nanobot独自のドキュメントと提供済みv0.3.5ソースから読み取ったものなので、互換性の結果ではなく、試行用の設定リファレンスとして扱ってください。動作する経路を確保し、上限を設けたタスクを1つ実行してから、アカウントに記録された内容を確認してください。クイックスタートとベースURLリファレンスでは、両方のエンドポイント形式を説明しています。キーへの資金追加前には、Kunavoアカウントの作成が必要です。まだプログラムを選んでいますか？nanobot vs OpenClawではランタイムを比較し、エージェントAPIディレクトリではワイヤープロトコルとBYOKの境界別にクライアントを整理しています。

よくある質問

2026年9月21日に確認したソース：HKUDS/nanobotおよびnanobot-aiのGitHub APIとPyPI API、mainブランチにあるnanobotのプロバイダー、設定、メモリ、CLIのドキュメント、そして数値デフォルト値の確認に使用したPyPIからダウンロードした提供済みv0.3.5ソース。ドキュメントの記述とソースのデフォルト値には5日間の差があり、本文全体で別々に表示しています。Kunavoはnanobotをランタイムテストしていません。トークン料金はライブカタログの値であり、すべてのドル金額は記載した前提に基づく例示的な計算です。