プロバイダーカタログ
ZeroClawに付属するすべてのモデルプロバイダーファミリー。各項目について、設定の形式、認証とエンドポイントの動作に関する注意事項、[providers.models.<type>.<alias>]配下で使用するスロットキーを記載します。
ユニバーサルフィールド(api_key、uri、model、…)と解決順序については Configuration を参照してください。
以下の例では、エイリアスの片方が運用者の選択によるものであることを強調するために、エイリアスとして
homeを使用しています。work、personal、cn、prodなど、適切な名前を自由に選んでください。エージェントからはmodel_provider = "<type>.<alias>"で参照します。
ネイティブ
Anthropic / Claude: スロット anthropic
Claude Max 向けに、Console API キーと claude setup-token で生成されたトークンをサポートします。両方の認証情報形式は、正規の anthropic スロットの api_key フィールドに保存されます。Quickstart ではこれらを api_key と setup_token の選択肢として提示します。ストリーミング、ツール呼び出し、ビジョン、推論のすべてがサポートされています。カスタムエンドポイント(Anthropic 互換プロキシ、例えば Z.AI の Anthropic API)もこのスロットに設定します。uri を設定してオーバーライドしてください。
OpenAI: スロット openai
GPT-4o、GPT-5、oシリーズの推論モデル。推論をストリーミングする場合、推論は TextDelta でラップされた StreamChunk のオプションの reasoning フィールドに含まれます。Streaming を参照してください。
OpenAI Codex: requires_openai_auth = true を指定した openai スロット
OpenAI Codex のサブスクリプション認証は openai スロットに置かれます。POST /v1/responses 経由でルーティングするには wire_api = "responses" を設定し、エントリ上の api_key フィールドの代わりに Codex サブスクリプションログイン(Codex CLI 独自の ~/.codex/auth.json から取得)を使用するには requires_openai_auth = true を設定します。サブスクリプションパスは OPENAI_API_KEY を読み取りません。この変数は従量課金の openai API キーモードにのみ適用されます。認証情報モデルについては プロバイダー設定 → OAuth およびサブスクリプション認証 を参照してください。
Ollama: スロット ollama
Ollama のネイティブな /api/chat によるローカル推論。format によるスキーマベースの構造化出力。API キー不要。
Bedrock: スロット bedrock
Gemini: スロット gemini
GoogleのGemini API。ビジョンと事前実行されたグラウンド検索をサポートしています(PreExecutedToolCall イベントについてはストリーミングを参照してください)。
Gemini CLI: スロット gemini_cli
gemini CLI へシェルアウトします。CLI の既存の認証を使用します。
Grok Build CLI: スロット grok_cli
ドキュメントに記載された grok agent stdio ACP サーフェスを通じて Grok Build CLI をシェルから呼び出し、デフォルトでは CLI のログインキャッシュを使用します。grok login を実行するか、以下に示す明示的な API キーブリッジを使用してください。型付きエイリアス api_key は使用されず、エイリアスが明示的にオプトインしない限り、環境にある XAI_API_KEY も継承されないため、Grok CLI が認証の主体であり続けます。これは唯一のトランスポートであり、改行区切りの JSON-RPC で initialize → authenticate → session/new → session/prompt の順に実行します。小さいプロンプトも大きいプロンプトも stdin 経由で送信され、argv やプロンプトファイルに現れることはありません。
文書化された ACP 統合とデフォルト引数プロファイルは、以前のベースライン 0.2.111 とともに、Grok Build CLI 0.2.118(ACP advertise/live プローブ)に対して検証されています。外部 CLI のアップグレードは互換性の変更として扱い、デプロイする前に grok agent stdio を再検証してください。
ACP のビジョン / 画像入力(現在の Grok Build の動作)
Grok Build CLI(0.2.118で確認済み)は、ACP の initialize で引き続き promptCapabilities.image = false を通知します。これはどちらの側でも環境変数による上書きではありません。ZeroClaw が Grok の通知を書き換えることは決してありません。ZeroClaw で制御できる唯一のものは、エイリアス単位で共有される設定フィールド vision です。
| レイヤー | 0.2.118 での動作 |
|---|---|
| ACP のアドバタイズ | promptCapabilities.image = false |
デフォルトの grok_cli | vision が未設定の場合 → ZeroClaw はエイリアスを非ビジョンとして扱い、画像マーカーはテキストのままになります |
vision = true | ZeroClaw はエイリアス上でビジョン対応を報告し、ACP {type: image, data, mimeType} ブロックを送信する(Grok の advertise は変更しない) |
| モデル認識 | ライブプローブ: session/prompt は画像ブロックを受け付ける(プロトコルエラーなし)が、エージェントは画像を受信していないかのように応答した |
[providers.models.grok_cli.default]
model = "grok-4.5"
working_directory = "/srv/zeroclaw/grok-workspace"
# オプションの実験のみ: image=false を告知している場合でも ACP 画像ブロックを送信します。
# Grok Build 0.2.118 が画像を確実に認識または説明できるようになるわけではありません。
# vision = true
本番の grok_cli エイリアスでは vision を未設定のままにしてください。実際の画像理解を必要とするチャネル添付ファイルは、デプロイ済みの CLI が image = true を宣言し、かつライブスモークテストでモデルが画像コンテンツを使用することが確認されるまで、grok_cli にルーティングしないでください。その条件が満たされたら、一時的な vision = true オプトインを削除し、ZeroClaw がローカルオーバーライド(GrokCliModelProvider::acp_prompt_content)ではなく宣言ビットに従うべきかを再検討してください。
Ubuntu 24.04: bwrap がユーザー名前空間を必要とする場合も Grok サンドボックスを維持する
Grok Build 0.2.112 以降をデプロイする場合は、対象ホストで ACP の初期化を確認してください。kernel.apparmor_restrict_unprivileged_userns=1 が設定された Ubuntu 24.04 ホストでは、Grok は ACP の初期化前に bwrap: setting up uid map: Permission denied で終了することがあります。これはホストのサンドボックス設定の失敗であり、ACP、stdout、または認証の失敗ではありません。
ZeroClaw のデフォルトの --sandbox strict(または明示的な workspace プロファイル)を維持し、実際の Grok 実行ファイルにのみユーザー名前空間を作成する権限を付与します。これはホスト管理者による変更であり、グローバルなユーザー名前空間の制限を維持し、Grok のサンドボックスを無効にするものではありません。
readlink -f "$(command -v grok)"
プレースホルダーをその絶対パスに置き換えて、/etc/apparmor.d/grok-build-userns を作成します:
abi <abi/4.0>,
include <tunables/global>
profile grok-build-userns /absolute/path/to/grok flags=(unconfined) {
userns,
}
次にそれを読み込み、プロファイルがアクティブであることを確認します:
sudo apparmor_parser -r /etc/apparmor.d/grok-build-userns
sudo aa-status | grep grok-build-userns
flags=(unconfined) は Ubuntu の実行ファイル単位の AppArmor 例外メカニズムです。指定した Grok バイナリには userns を許可しますが、AppArmor のファイルルールは追加しません。Grok 自身が要求するサンドボックスは有効なままで、ホスト全体のユーザー名前空間制限も有効なままです。Grok に AppArmor のファイル制限も必要な場合は、完全に制限された組織固有のプロファイルを使用してください。自己更新によってダウンロードされた実行ファイルのパスが変わる可能性があるため、Grok を更新するたびにパスを解決し、このプロファイルを再読み込みしてください。
このエラーを回避するだけの目的で --sandbox off を使用しないでください。これにより Grok のサンドボックスが無効になります。システム全体で kernel.apparmor_restrict_unprivileged_userns を無効にしないでください。xAI は通常の Linux サンドボックスに Landlock を使用することを説明しており、bubblewrap はカスタムの読み取り拒否プロファイルにのみ使用することを説明しています。カスタムの空でない deny リストを使用していない状態でこの問題が発生した場合は、バージョン、正確なエラー、サンドボックスプロファイル、および秘密情報を含まないホスト/AppArmor の診断情報を xAI に報告してください。
max_acp_stdout_bytes は、1 回のリクエスト中に Grok ACP 子プロセスから読み取る stdout 全体(プロトコルフレームおよびネイティブツールの更新を含む)に上限を設定します。デフォルトは 4 MiB です。レビュー済みのツール対応ワークロードで、より大きな上限値が必要な場合は、エイリアスごとに設定してください。
[providers.models.grok_cli.default]
model = "grok-4.5"
working_directory = "/srv/zeroclaw/grok-workspace"
env_passthrough = ["XAI_API_KEY"]
# オプション: デフォルトは 4 MiB、許容範囲は 1-64 MiB。
max_acp_stdout_bytes = 8388608
ZeroClaw を起動する前に、XAI_API_KEY をデーモンの環境にエクスポートします。ACP クライアントは、その名前が env_passthrough に列挙され、かつ 子プロセスの起動時 にプロセス環境に空でない値が存在する場合にのみ xai.api_key を選択します(長期間存続するプロバイダーハンドルにスナップショットとして取り込まれるわけではありません)。それ以外の場合は CLI のログインキャッシュにフォールバックします。型付きエイリアス api_key は引き続き拒否されます。これは、2 つ目の Config シークレットフィールドではなく、意図的なプロセス環境ブリッジです。値はプロバイダー TOML に書き込まれません。将来、型付きの Config ブリッジによって、運用者向けインターフェースを変更せずに設定時に同じ名前を読み込める可能性があります。
既存の絶対パスである working_directory が必要です。これは正規化され、子プロセスの cwd と ACP セッション境界の両方に使用されるため、プロバイダーがデーモンの cwd にフォールバックすることはありません。オプションの binary_path で PATH にないバイナリを選択できます。エイリアスの timeout_secs により、プロトコルの読み取りと書き込みに上限を設定します(デフォルトは 600 秒)。
子プロセス環境は spawn 前にクリアされます。組み込みの許可リストにあるプロセスランタイム、ロケール、プロキシ、CA の変数は引き続き利用できますが、その他の名前は、そのプロバイダーエイリアスが env_passthrough に一覧表示していない限りブロックされます。このフィールドは、明示的な XAI_API_KEY 認証ブリッジと、明示的に有効化された Grok ツール(クラウド CLI の認証情報など)が必要とする環境変数のためのものです。値は spawn 時に ZeroClaw プロセス環境から読み取られ、プロバイダー設定には保存されません。デフォルトのリストは空です。記載する内容は必要最小限にしてください。記載されたすべてのシークレットは、Grok およびそのエイリアスで有効化されたすべてのツールに公開されるためです。その他のプロバイダー所有の XAI_* 名と、すべての GROK_* 名は拒否されます。Grok が検出したユーザー設定およびプロジェクト設定と、エイリアスの extra_args が、Grok ツールポリシーを決定します。
デフォルトの argv には --no-auto-update、--no-plan、--sandbox strict、--permission-mode dontAsk、--tools "" が追加されます。デフォルトでは、ACP クライアントは権限リクエストを拒否して終了します。リクエストに reject_once オプションが指定されている場合、クライアントはエージェントのターン全体をキャンセルする代わりに、それを選択します。それ以外の場合は、リクエストをキャンセルします。要求されたツールは引き続き拒否されますが、Grok はその拒否を処理して最終回答を生成するか、ポリシーで許可されている操作で再試行できます。
--always-approve、--dangerously-skip-permissions、--yolo、または --permission-mode=bypassPermissions を明示的に設定したエイリアスは、ヘッドレス ACP の応答ポリシーを変更します。クライアントはリクエストの allow_once オプションを選択します。allow_always に置き換えることは決してなく、要求された allow_once オプションが存在しない場合はキャンセルします。この承認は現在の権限リクエストにのみ適用されます。Grok の権限ルールと有効な OS サンドボックスによって、操作が拒否または制限される場合があります。
[providers.models.grok_cli.ops]
working_directory = "/path/to/agents/ops/workspace"
extra_args = [
"--tools=run_terminal_cmd",
"--permission-mode=bypassPermissions",
]
これらのバイパスフラグは、Grok がそのエイリアスでリクエストから利用可能なすべてのツールを、人間による承認の往復なしに実行するための認可として扱ってください。その他の権限モード(acceptEdits を含む)では、ACP の自動承認は有効になりません。Grok は ACP クライアントに問い合わせる前に、CLI の --allow / --deny ルールと、検出されたユーザー/プロジェクトの権限設定を評価します。これらの設定元は信頼されたオペレーターのポリシーです。一致する allow ルールによってツールを事前承認できるため、ACP クライアントに権限要求が届かない場合があり、プロジェクトの MCP サーバー、プラグイン、フックによって機能が追加される場合もあります。チャネルエージェントには、専用のレビュー済み working_directory を使用してください。
許可ルールがツールを事前承認しない場合でも、Grok は session/request_permission を引き続き送信し、ZeroClaw のデフォルトの一度拒否ポリシーによってツール呼び出しはフェイルクローズします。実際には、これはデフォルトの --sandbox strict 下でのシェル/execute ツールに影響します。現在の Grok Build では、CLI の --allow=Bash(...) ルールでも ACP ホストへのエスカレーションが発生する可能性があるため、ツールを有効にしたシェルエイリアスでは、明示的なバイパスフラグ(--always-approve / --permission-mode=bypassPermissions)を設定するか、ホストの承認なしで Grok が事前承認できるサンドボックスプロファイル(たとえば --sandbox=workspace)と許可ルールを組み合わせる必要があります。対応する --allow を付けた --tools=Read,Grep のような読み取り専用ツールの許可は、より限定的なオプトインとして残ります。
オペレーターは、エイリアス extra_args を使用してツールを付与したり、サンドボックス/権限ポリシーを緩和したりすることもできます。どちらのインターフェースも、サブプロセスの境界を広げるための明示的なオプトインです。Transport、prompt、model、session、cwd、update のフラグは引き続きプロバイダーが管理し、extra_args では拒否されます。位置引数と短い引数も拒否されます。既知の値を取るオプションは ["--flag", "value"] または --flag=value のいずれかを受け付けます。未知のオプション形式ではインライン形式が必要です。これにより、末尾の ACP コマンドを消費できないようにします。
Grok は、プラン、ツール呼び出し、または権限リクエストの前に agent_message_chunk として進行状況を出力することがあります。プロバイダーは、それらの ACP 境界で直前のメッセージセグメントを破棄し、最新の回答セグメントのみを返すため、プランニングやツール収集に関するナレーションはチャネルの返信として配信されません。明示的な --no-plan により、デフォルトのワンショットチャネルエイリアスが Grok のプランモードに入ることも防がれます。ツール/MCP 構成は引き続きオペレーターが制御する機能です。
ACP の stdout フレーム、stdout の集約、アシスタントテキスト、および stderr の処理には、子プロセスの実行中に上限が設けられています。stderr は読み出されますが、その内容が保存、ログに記録、または返却されることはありません。公開されるプロバイダーエラーは一定であり、子プロセスが制御するプロトコルの自由形式テキストをそのまま返しません。ワンショットリクエストのたびに(成功、タイムアウト、キャンセル、またはプロトコルエラーのいずれの場合も)、ZeroClaw は Unix では子プロセスの process group を、Windows では Job Object を終了させ、直接の子プロセスを回収します。これにより通常の子孫プロセスは対象になりますが、新しいセッションまたはプロセスグループを作成するプロセスは、Unix でのグループ強制終了を免れる可能性があります。Windows Job Object の対応は CI でコンパイル時にカバーされており、すべての Linux 開発ホストで完全に実行されるわけではありません。
推奨パターン: デフォルトチャネルのチャットボット
メッセージングエージェントには専用のプロバイダーエイリアス(たとえば agents.default)を使用してください。デフォルトエイリアスでは Grok 組み込みツールへのアクセス権は付与されません。Grok は通常のユーザー設定とプロジェクト設定を引き続き読み込むため、権限ルール、MCP サーバー、プラグイン、フックがチャネルの信頼境界に照らしてレビュー済みの専用ワークスペースを使用してください。オペレーターが承認したコーディング/運用エージェントには、別のエイリアスとワークスペースを使用してください。
返信意図の事前チェック(分類器): ZeroClaw は、完全なエージェントループの前に短い REPLY / NO_REPLY[*] 分類を実行します。この事前チェックには、安定したチャット補完 APIを優先してください(たとえば HTTP/OAuth の xai スロットや、その他の CLI 以外のモデルエイリアス)。また、完全な回答用の model_provider にのみ grok_cli を使用してください。CLI エージェントのバックエンドは、単一のセンチネルトークンではなく計画の文章を出力することが多く、その文章がチャンネルメッセージ(“沈黙を保つ” / “Slack 返信なし”)として配信される可能性があります。空の classifier_provider は model_provider を再利用します。API モデルでは問題ありませんが、CLI チャンネルボットでは適していません。ACP チャンネルでは分類器を完全にスキップします。
# 完全な回答: ACP、厳格なサンドボックス、組み込みツールなし、レビュー済みの Grok 設定
[providers.models.grok_cli.default]
model = "grok-4.5"
binary_path = "/home/you/.grok/bin/grok"
working_directory = "/path/to/agents/default/workspace"
# REPLY / NO_REPLY の事前チェック - API(形式安定)。既存の xAI
# HTTP エイリアスがある場合はそれを再利用してください。これを grok_cli に向けないでください。
[providers.models.xai.default]
model = "grok-4.5"
# 通常の xAI プロバイダーと同じ uri / auth(OAuth セッションまたは api_key)
# Ops / コーディングエージェント: 明示的なポリシーとツールのオプトイン
[providers.models.grok_cli.ops]
model = "grok-4.5"
binary_path = "/home/you/.grok/bin/grok"
working_directory = "/path/to/agents/ops/workspace"
env_passthrough = ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"]
# 読み取り専用ツール: 対応する --allow により、ACP の承認なしで事前承認できます。
extra_args = ["--tools=Read,Grep", "--allow=Read", "--allow=Grep"]
# シェル対応の ops エイリアス: ACP の承認をバイパスするか、allow と
# Grok が事前承認するサンドボックスプロファイルを組み合わせます(workspace が一般的な選択です)。
[providers.models.grok_cli.ops_shell]
model = "grok-4.5"
binary_path = "/home/you/.grok/bin/grok"
working_directory = "/path/to/agents/ops/workspace"
extra_args = [
"--tools=run_terminal_cmd",
"--allow=Bash(printf *)",
"--sandbox=workspace",
]
[agents.default]
model_provider = "grok_cli.default"
classifier_provider = "xai.default"
channels = ["slack.default"] # 例
[agents.dependabot]
model_provider = "grok_cli.ops"
| レイヤー | どこ | 目的 |
|---|---|---|
| 返信の事前チェック | classifier_provider → API エイリアス(例: xai.default) | REPLY / NO_REPLY[*] のみ。CLI が思考テキストをメッセージ本文として扱うのを防ぎます |
| 完全な回答 | model_provider → grok_cli.default | Grok Build ACP; プロンプトは stdin からのみ |
| OS サンドボックス | デフォルトの --sandbox strict(または extra_args による上書き) | CWD + システムパスを読み取り、CWD + ~/.grok + tmp に書き込みます。Linux では子プロセスのネットワークがブロックされます。組み込み機能は恒久的な認証情報境界ではありません。シークレットにはカスタム deny を使用してください |
| アプリの権限 | 空の組み込みツールセット + フェイルクローズドな ACP のデフォルト | 明示的なバイパスフラグは allow_once を選択します。検出された Grok ルールによって、設定済みツールが事前承認されることもあります |
| チャネル配信 | ZeroClaw thread_replies / チャネル設定 | スレッド内の単一返信パス |
| オプションのゲート | Slack mention_only + strict_mention_in_thread | エージェントに到達する前に、言及されていないグループ/スレッドのトラフィックを破棄する(Slackを参照);分類器とは独立して |
チャネル向けエイリアスはデフォルトのままにし、専用のレビュー済みワークスペースを割り当てます。Grok によって検出された権限ルール、MCP サーバー、プラグイン、フック、および extra_args 内の権限/サンドボックス/ツールフラグは、信頼されたオペレーターのポリシーであり、サブプロセスの境界を拡大する可能性があります。
Grok CLI OS サンドボックス(ZeroClaw からの使用方法)
これは Grok Build のプロセスサンドボックス(grok サブプロセスに対する Landlock / Seatbelt / seccomp)です。これは [risk_profiles.*.sandbox_*] における ZeroClaw のツールサンドボックスではありません。これはネイティブツール呼び出し後に ZeroClaw ツールをラップします。オペレーターがプロバイダーエイリアスを Grok ツールで使用するよう設定した場合、その処理で有効な隔離を提供するのは Grok の --sandbox です。ZeroClaw のリスクプロファイルサンドボックスについては、Sandboxing も参照してください。
ZeroClaw は常に明示的なサンドボックスフラグを指定します。デフォルトは strict です。別のプロファイルを選択するには、そのプロバイダーエイリアスの extra_args に --sandbox=<profile> を設定します。周囲の Grok 設定や GROK_SANDBOX によって、プロバイダーが管理するデフォルトが暗黙的に緩和されることはありません。
プロジェクトの .grok/config.toml には、MCP / プラグイン / [permission] を記述できます。Grok はこのファイルを信頼されたオペレーターポリシーとして読み込みます。一致する allow ルールによって、ACP の権限要求なしでツールを許可できる場合があります。このファイルだけでは、アクティブなサンドボックスプロファイルは選択されません。プロファイルの 名前 とカスタムプロファイルの 内容 は、プロジェクトの <workspace>/.grok/sandbox.toml に記述できます。そのプロファイルを有効にするには、--sandbox=<name> を extra_args 経由で渡します。
組み込みプロファイル(Grok のサンドボックスドキュメントより):
| プロファイル | FS 読み取り | FS 書き込み | 子プロセスネットワーク(Linux) | 一般的な用途 |
|---|---|---|---|---|
off(デフォルト) | 無制限 | 無制限 | 無制限 | フルアクセス |
workspace | どこでも | CWD + ~/.grok + tmp | 許可されています | 日常のコーディング |
読み取り専用 | どこでも | ~/.grok + tmp のみ | ブロック済み | 広範な読み取りが許可されるケースを確認する |
strict | CWD + システムパス | CWD + ~/.grok + tmp | ブロック済み | デフォルトチャネルのチャットボット(推奨) |
devbox | どこでも | ツリーの大部分 | 許可されています | 使い捨て VM |
子プロセスのネットワーク遮断は Linux 上の シェルの子プロセス にのみ適用されます。プロセス内の Grok ツール(LLM、組み込み Web 検索)には引き続きネットワークが必要です。メッセージングボットでは strict を優先し、デフォルトのファイルシステムへの書き込み可能範囲をエージェントのワークスペースと Grok ランタイムパスに絞ってください。組み込みプロファイルは恒久的な認証情報の境界ではありません。xAI のサンドボックスドキュメントでは、~/.ssh のようなパスが組み込みプロファイルによって保護される保証はないと警告しており、シークレット用にカーネルによって強制される deny リストを備えたカスタムプロファイルを推奨しています。エージェントがプロジェクトファイルを書き込まずにワークスペース外を読み取る必要がある場合にのみ、read-only を使用してください。
カスタムプロファイルの例(ワークスペースで定義し、ZeroClaw から選択):
# <agent-workspace>/.grok/sandbox.toml
[profiles.channel-bot]
extends = "strict"
# オプションのカーネル拒否パス(空でない場合、Linux では bubblewrap が必要):
# deny = ["**/.env", "**/*.pem"]
# ZeroClaw config.toml
[providers.models.grok_cli.default]
working_directory = "/path/to/agents/default/workspace"
extra_args = ["--sandbox=channel-bot"]
エージェントごとのサンドボックス: 異なる明示的な extra_args と専用の作業ディレクトリを持つ 個別のプロバイダーエイリアスを使用してください。チャンネルエイリアスは厳格な組み込みツールなしのデフォルト設定を維持し、各ワークスペースで検出された Grok 構成を確認して、各エージェントを対応する model_provider エイリアスに割り当ててください。
Azure OpenAI: スロット azure
resource、deployment、api_version はこの型付き設定に格納され、環境変数からは読み込まれません。
Copilot: スロット copilot
GitHub Copilot サブスクリプションをエージェント推論に使用します。認証には GitHub から取得した Copilot OAuth トークンを使用します。
Telnyx: スロット telnyx
音声指向のAIエンドポイント。リアルタイムのSIP通話には clawdtalk チャンネルと組み合わせて使用します。
KiloCLI: スロット kilocli
KiloCLI によるローカル推論。
Kilo AI Gateway: スロット kilo
[providers.models.kilo.home]
model = "anthropic/claude-sonnet-4-6"
api_key = "..."
# endpoint = "gateway" # デフォルト → https://api.kilo.ai/api/gateway
Kilo AI Gateway 経由の Cloud API。複数のモデルティア(free、balanced、pro)に対応した Bearer トークン認証を使用します。/models エンドポイントは公開されており(PUBLIC_MODEL_LISTING)、認証情報なしでモデル一覧を取得できます。ライブでクエリされるため、これがコストレートエディターに料金情報を提供するソースとなります。共有の models.dev カタログ(kilo キー)は、ライブエンドポイントに接続できない場合のフォールバックにすぎず、料金情報は含まれていません。
命名の移行:
kiloは現在、このゲートウェイプロバイダーを指します。KiloCLI サブプロセスプロバイダーはkilocliスロット(同義語kilo-cli)を保持します。以前kiloという短縮名で CLI プロバイダーを構成していた場合は、kilocliに切り替えてください。
ZeroRouter: スロット zerorouter
[providers.models.zerorouter.gateway]
model = "anthropic/claude-sonnet-5"
api_key = "..." # ZeroRouter のキー(プレフィックスは `zcr_`);または環境変数から注入
# uri = "http://localhost:8080/v1" # セルフホストまたはローカルのルーター。ホスト型のデフォルトを使用する場合は省略
OpenAI互換のLLMゲートウェイ。Bearerトークン認証。ZeroRouterは現在ベータ版です。スロットはデフォルトで公開ホスト型デプロイメント https://zerorouter.ai/v1 を使用するため、設定なしでモデルの検出が機能します。ZeroRouterはセルフホストも可能(AGPL)です。ローカルの http://localhost:8080/v1 またはその他の場所にある独自のルーターに接続するには、uri を明示的に設定します。あるルーターで発行されたキーは別のルーターでは認証されないため、api_key は uri が指すデプロイメントから取得する必要があります。
このスロットが対応する chat-completions ワイヤーに加えて、ZeroRouter は OpenAI Responses API のインバウンド(POST /v1/responses)も提供するため、wire_api = "responses" を設定した Codex CLI の model_provider など、Responses ワイヤー対応のクライアントは、同じデプロイメントとキーを直接指定できます。
/v1/models エンドポイントは公開されています(PUBLIC_MODEL_LISTING)。そのため、モデル一覧とプロンプト/補完の料金は、認証情報なしでルーター自体からリアルタイムに取得されます。ライブで照会されるため、料金をコストレートエディターに反映するソースはこれになります(このファミリーには models.dev や OpenRouter へのフォールバックはありません)。推論にはキーが必要です。api_key を直接設定するか、他のプロバイダーキーと同様に環境変数から注入してください(api_key の解決順序については 設定 を参照してください)。
組み込みログインなし。 このプリセットは、標準の型付き
api_keyパス経由でのみプロバイダーを設定します。デバイスフローによるログイン、OAuth、またはプロバイダー固有の認証情報ストレージは追加しません。推論を実行するには、api_key(またはその環境変数による注入)を設定してください。
すべてのスロット
プロバイダーレジストリと設定スキーマから生成された、すべての正規スロット、それぞれのデフォルトエンドポイント、ローカルで実行されるかどうか、および設定フィールドの完全なセットです。スロットをクリックするとフィールドが展開され、フィールドをクリックすると設定方法を確認できます。固定エントリには正規のデフォルトが表示されます。operator required は、エイリアスに Azure リソースとデプロイ、または custom の uri などのエンドポイント入力が必要であることを意味します。dynamic / resolved at runtime のエンドポイントは、認証情報、リージョン、検出、または実行時の状態に依存する場合があり、必ずしも uri を必要としません。CLI 対応プロバイダーはローカルコマンドを使用します。
共有フィールド
すべてのプロバイダースロットはこれらのフィールドを受け付けます。スロット固有の追加項目については、以下の各プロバイダーごとに記載しています。
api_key 🔑
この model_provider のシークレット API トークン。model_provider のダッシュボード(OpenAI platform、Anthropic console、OpenRouter keys ページなど)から取得します。可能な場合は OS キーリング経由で保存され、config.toml に直接コミットしないでください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開いて providers.models.openrouter.<alias>.api_key フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.api_key フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.api_key # マスクされた入力、暗号化して保存
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__api_key=
chat_template_kwargs
OpenAI互換プロバイダーのリクエスト本文で、トップレベルの chat_template_kwargs オブジェクトとして任意のキーと値のペアをそのまま転送します。vLLM、SGLang、llama.cpp などのチャットテンプレート対応バックエンドがこれを使用し、他のフィールドでは公開されていない動作を制御するモデルファミリー固有のテンプレート変数を渡します。JSON オブジェクト(TOML インラインテーブル)である必要があり、オブジェクト以外の値は警告とともに無視されます。例(Qwen3 の思考抑制):chat_template_kwargs = { enable_thinking = false }
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.chat_template_kwargs フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.chat_template_kwargs フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.chat_template_kwargs <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__chat_template_kwargs=
context_window
このモデルのコンテキストウィンドウサイズ(最大入力トークン数)。利用可能な場合、セットアップ時にプロバイダーの /models エンドポイントから自動入力されます。カスタムエンドポイントの場合や自動検出が失敗した場合は手動で上書きします。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.context_window フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.context_window フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.context_window <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__context_window=
extra_headers 🔑
すべてのリクエストに付与される追加のHTTPヘッダー。ニッチな用途: 認証ブリッジ、企業プロキシ、またはトレーシングヘッダーを要求するカスタムゲートウェイで使用されます。ほとんどのユーザーが触れることはありません。必要な場合はconfig.tomlを直接編集してください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.extra_headers フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.extra_headers フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.extra_headers # マスクされた入力、暗号化して保存
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__extra_headers=
fallback
このエイリアスのすべてのモデルが失敗したときに試行する、他のプロバイダーエイリアスの順序付きリストです。各エントリは providers.models 内のドット区切りの <type>.<alias> 参照であり、独自の認証情報、エンドポイント、モデルで解決されます。フォールバックがこのエイリアスのキーを継承することはありません。走査は深さ優先で行われます。まずこのエイリアスのモデルが使い尽くされ、次に各フォールバックエイリアスが順番に降下されます(それぞれ独自の fallback_models と fallback を適用します)。空の場合、プロバイダーレベルのフォールバックはありません。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開いて、providers.models.openrouter.<alias>.fallback フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.fallback フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.fallback <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__fallback=
fallback_models
fallback エイリアスにフォールバックする前に、このプロバイダーで試行する代替モデルの順序付きリスト。プライマリの model と同じエンドポイント、キー、ヘッダーを使用します。変更されるのはモデル識別子のみです。プロバイダーが(例えばより小さい、または古いバリアントの)バックアップモデルを提供しており、プロバイダーを完全に離れる前に試行すべき場合に使用します。空の場合は model のみが試行されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.fallback_models フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.fallback_models フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.fallback_models <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__fallback_models=
kind
このプロファイルでインスタンス化するプロバイダー実装です。正規の型付きスロットを互換性のある実装で実行する場合に使用します。例: [providers.models.openai.proxy] kind = "openai-compatible"。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.kind フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.kind フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.kind <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__kind=
live_pricing
このプロバイダーのモデルのライブトークン価格を、プロバイダー自身のOpenAI互換の /models リストから取得し(ゲートウェイがその価格の信頼できる情報源です)、オペレーターが [cost.rates] / pricing で価格を設定していないモデルのコスト追跡レートを補完します。ゲートウェイが価格を設定していないモデル(または kilocli のようなサブプロセスゲートウェイなど、HTTP /models リスト自体が存在しないプロバイダー)は、公開されている models.dev カタログにフォールバックします。設定されたレートが常に優先され、ライブ価格は不足分を補完するだけです。バックグラウンドタスクが価格スナップショットを1時間ごとに更新します。コスト記録パスはキャッシュされたスナップショットを読み取り、ネットワークでブロックすることはありません。デフォルトは false:オフの場合、取得は行われず、この機能なしでビルドした場合と同一の動作になります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.live_pricing フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.live_pricing フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.live_pricing <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__live_pricing=
max_tokens
応答の長さの上限をトークン数で指定するハードキャップです。ほとんどのモデルにはすでに適切な組み込みの上限が設定されているため、コストやレイテンシの理由で長い出力を切り詰める必要が特にない限り、未設定のままにしてください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.max_tokens フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.max_tokens フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.max_tokens <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__max_tokens=
merge_system_into_user
ModelProvider 固有の癖: システムプロンプトを別の system ロールとして送信せず、最初のユーザーメッセージに統合します。単独の system ロールを拒否する(または正しく処理できない)モデル、例えば一部の古い Mistral バリアントでのみ必要です。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.merge_system_into_user フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.merge_system_into_user フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.merge_system_into_user <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__merge_system_into_user=
model
各リクエストで送信するモデル識別子: model_provider のカタログにある ID 文字列(例: gpt-4o、claude-sonnet-4-5、llama-3.3-70b)。このアカウントで model_provider が実際に提供しているモデルと一致する必要があります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開いて providers.models.openrouter.<alias>.model フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.model フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.model <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__model=
native_tools
ネイティブツール呼び出しに関するプロバイダーのデフォルト設定をオーバーライドします。None(デフォルト)はプロバイダーの組み込み設定を尊重します。Some(true) はネイティブツール呼び出しを強制的に有効化し、Some(false) はテキストフォールバックを強制します。現在はGroqファクトリーのみが参照しており、llamaファミリーのGroqモデルがネイティブツール呼び出しをHTTP 400で拒否するため、デフォルトでテキストフォールバックになっています。native_tools = true を設定すると、対応するGroqモデルでネイティブツール呼び出しが再度有効になります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.native_tools フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.native_tools フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.native_tools <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__native_tools=
pricing
コスト追跡用のモデルごとの料金設定。100万トークンあたりのUSD。自由形式のキー/値マップ。キーはユーザー定義のモデル識別子で、オプションの .input / .output サフィックスは、オペレーターがレートを分割したい場合に料金の次元を示します。サフィックスのない単純なキーは、いずれの次元も指定されていない場合にトークンごとの一律レートとして使用されます。デフォルトは空です。この場合、コスト追跡は「不明」レートにフォールバックし、トークン使用量のみが記録されます。例: pricing = { opus = 15.0, sonnet = 3.0 } または分割する場合: pricing = { "opus.input" = 15.0, "opus.output" = 75.0 }
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開いて、providers.models.openrouter.<alias>.pricing フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.pricing フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.pricing <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__pricing=
provider_extra
API リクエストに含める追加の JSON パラメーター。リクエストボディのトップレベルでマージされ、コードを変更することなくプロバイダー固有の機能(ルーティング、変換など)を利用できます。例: provider_extra = { model_provider = { only = ["Anthropic"] } }
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.provider_extra フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.provider_extra フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.provider_extra <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__provider_extra=
replay_assistant_reasoning
保存されたアシスタントの推論を、送信するアシスタント履歴メッセージで再生するかどうか。Some(false) は送信前に reasoning_content と reasoning を除去します。None(デフォルト)はプロバイダーの組み込みデフォルト(ほとんどの互換プロバイダーでは true、Groq では false)に従います。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.replay_assistant_reasoning フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.replay_assistant_reasoning フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.replay_assistant_reasoning <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__replay_assistant_reasoning=
requires_openai_auth
true の場合、クライアントは上記の api_key フィールドではなく、ZeroClaw に保存された openai-codex 認証プロファイルから認証情報を取得します。既存の Codex CLI ログインをインポートするには zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json を実行するか、zeroclaw auth login --model-provider openai-codex を実行してください。OpenAI Codex の model_provider の場合にのみ有効にし、標準の API キーによる model_provider では無効のままにしてください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.requires_openai_auth フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.requires_openai_auth フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.requires_openai_auth <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__requires_openai_auth=
temperature
モデルに渡されるサンプリング温度です。低い値(0.0〜0.3)は決定論的でほぼ忠実な出力となり、コード、ルーティング、要約に適しています。高い値(0.7〜1.2)はより多様な出力となり、自由形式のチャットに適しています。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.temperature フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.temperature フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.temperature <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__temperature=
think
これをサポートするモデル(例:Qwen3、GLM-4)で連鎖的思考(chain-of-thought)を有効または無効にします。true で思考をオンにし、false でオフにします。None(デフォルト)の場合はモデルが判断します。リクエストボディ内で enable_thinking として転送され、Ollama プロバイダーの think フィールドに対応します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.think フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.think フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.think <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__think=
timeout_secs
HTTPリクエストのタイムアウト(秒単位)。低速なローカルmodel_providers(CPU上のOllama、大規模なローカルモデル)や高レイテンシのネットワークの場合はこの値を引き上げてください。それ以外の場合は未設定のままにしてください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.timeout_secs フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.timeout_secs フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.timeout_secs <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__timeout_secs=
tls_ca_cert_path
このプロバイダーへのTLS接続に使用するPEMエンコードされたCA証明書へのパス。絶対パスである必要があります。シェル展開(例: ~)は実行されません。システムのデフォルトのトラストストアを使用する場合は未設定のままにしてください。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.tls_ca_cert_path フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.tls_ca_cert_path フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.tls_ca_cert_path <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__tls_ca_cert_path=
tool_result_image_policy
ネイティブのツール結果コンテンツに埋め込まれた画像マーカーに関するポリシー。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.tool_result_image_policy フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.tool_result_image_policy フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.tool_result_image_policy <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__tool_result_image_policy=
uri
クライアントが接続するエンドポイント URI。セルフホスト型のゲートウェイ(LiteLLM、vLLM、Ollama)、カスタムプロキシ、または非標準の URL を指定する場合に、ファミリーのデフォルトエンドポイントを上書きします。未設定のままにすると、ファミリーの ModelEndpoint 実装によるデフォルト URI が使用されます。これにはエンドポイントの完全な URL を設定してください。パスサフィックス用の個別フィールドはありません。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開き、providers.models.openrouter.<alias>.uri フィールドを設定します。
zerocode
Config ペインで、providers.models.openrouter.<alias>.uri フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.uri <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__uri=
vision
プロバイダーの vision(画像入力)機能を上書きします。None(デフォルト)はプロバイダーファミリーの組み込みデフォルトを使用します。いくつかのファミリー(llama.cpp、汎用の OpenAI 互換エンドポイントなど)は、マルチモーダルモデルを提供できるため vision 対応と見なされます。そのようなファミリーで提供されるテキスト専用モデル(例: llama.cpp の背後にあるテキスト LLM)の場合は vision = false を設定してください。これにより、画像メッセージは、それらを拒否するモデルに送信される代わりに、設定された [multimodal] vision_model_provider にルーティングされます。Some(true) は vision を強制的に有効にします。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開いて providers.models.openrouter.<alias>.vision フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.vision フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.vision <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__vision=
wire_api
model_provider クライアントのワイヤープロトコル形式。responses は OpenAI の Responses API(POST /v1/responses)経由でルーティングし、chat_completions はレガシーの /v1/chat/completions(またはそのファミリーの chat-completions 互換エンドポイント)経由でルーティングします。新しい OpenAI プロバイダースロットのデフォルトは responses です。他のファミリーは未設定の場合、chat-completions をデフォルトとする(またはこのフィールドを無視する)動作になります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/openrouter を開いて、providers.models.openrouter.<alias>.wire_api フィールドを設定してください。
zerocode
Config ペインで、providers.models.openrouter.<alias>.wire_api フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.openrouter.<alias>.wire_api <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__openrouter__<alias>__wire_api=
プライマリ
openrouter https://openrouter.ai/api/v1anthropic https://api.anthropic.comopenai dynamic / resolved at runtimetelnyx https://api.telnyx.com/v2/aiazure operator required
Slot-specific fields (in addition to the shared fields above):
api_version
Azure APIバージョン文字列(例:2024-10-21)。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/azure を開き、providers.models.azure.<alias>.api_version フィールドを設定してください。
zerocode
Config ペインで、providers.models.azure.<alias>.api_version フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.azure.<alias>.api_version <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__azure__<alias>__api_version=
deployment
Azure デプロイ名: Azure AI Studio で作成されたデプロイ。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/azure を開いて providers.models.azure.<alias>.deployment フィールドを設定してください。
zerocode
Config ペインで、providers.models.azure.<alias>.deployment フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.azure.<alias>.deployment <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__azure__<alias>__deployment=
resource
Azure リソース名(<resource>.openai.azure.com の <resource> の部分)。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/azure を開いて、providers.models.azure.<alias>.resource フィールドを設定してください。
zerocode
Config ペインで、providers.models.azure.<alias>.resource フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.azure.<alias>.resource <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__azure__<alias>__resource=
ollama http://localhost:11434/v1 · local
Slot-specific fields (in addition to the shared fields above):
num_ctx
すべての /api/chat リクエストで送信される Ollama の num_ctx(コンテキストウィンドウ、トークン単位)を上書きします。未設定の場合は、フレームワーク定数(OLLAMA_DEFAULT_NUM_CTX)がデフォルトになります。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/ollama を開き、providers.models.ollama.<alias>.num_ctx フィールドを設定します。
zerocode
Config ペインで、providers.models.ollama.<alias>.num_ctx フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.ollama.<alias>.num_ctx <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__ollama__<alias>__num_ctx=
num_predict
すべての /api/chat リクエストで送信される Ollama の num_predict(最大出力トークン数)を上書きします。設定されていない場合は、フレームワークの定数(OLLAMA_DEFAULT_NUM_PREDICT)がデフォルトとして使用されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/ollama を開いて、providers.models.ollama.<alias>.num_predict フィールドを設定してください。
zerocode
Config ペインで、providers.models.ollama.<alias>.num_predict フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.ollama.<alias>.num_predict <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__ollama__<alias>__num_predict=
temperature_override
すべての Ollama /api/chat リクエストでこの temperature を強制的に使用し、ModelProvider::chat_with_system(.., temperature) を通じて渡される呼び出しごとの値を上書きします。未設定(None、デフォルト)の場合は、呼び出しごとの temperature が優先されます。完全な後方互換性を備えています。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/ollama を開いて、providers.models.ollama.<alias>.temperature_override フィールドを設定してください。
zerocode
Config ペインで、providers.models.ollama.<alias>.temperature_override フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.ollama.<alias>.temperature_override <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__ollama__<alias>__temperature_override=
gemini dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
auth_mode
複数の認証方式をサポートする model_provider ファミリー(例:Qwen、Minimax は API キーまたは OAuth を使用可能)の認証モード。単一の認証フローのみをサポートするファミリーは、設定構造体からこのフィールドを単に省略します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/gemini を開き、providers.models.gemini.<alias>.auth_mode フィールドを設定します。
zerocode
Config ペインで、providers.models.gemini.<alias>.auth_mode フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.gemini.<alias>.auth_mode <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__gemini__<alias>__auth_mode=
oauth_client_id
Google OAuth アプリの client_id。このエイリアスが ZeroClaw 独自のブラウザ/デバイスコードによるログインフロー(zeroclaw auth login --model-provider gemini --profile <alias>)を駆動する際に使用されます。上流の gemini login ツールを利用するオペレーターには不要です。そのツールは独自の client_id / client_secret を ~/.gemini/oauth_creds.json に書き込みます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/gemini を開き、providers.models.gemini.<alias>.oauth_client_id フィールドを設定してください。
zerocode
Config ペインで、providers.models.gemini.<alias>.oauth_client_id フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.gemini.<alias>.oauth_client_id <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__gemini__<alias>__oauth_client_id=
oauth_client_secret
Google OAuth アプリの client_secret。oauth_client_id と併せて設定します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/gemini を開き、providers.models.gemini.<alias>.oauth_client_secret フィールドを設定してください。
zerocode
Config ペインで、providers.models.gemini.<alias>.oauth_client_secret フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.gemini.<alias>.oauth_client_secret <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__gemini__<alias>__oauth_client_secret=
oauth_project
OAuth の loadCodeAssist 検出呼び出しで使用する特定の GCP プロジェクト ID を固定します。未設定の場合、検出処理は認証情報のアカウントですでにオンボーディング済みのプロジェクトを探索します。GOOGLE_CLOUD_PROJECT / GOOGLE_CLOUD_PROJECT_ID 環境変数を置き換えます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/gemini を開いて、providers.models.gemini.<alias>.oauth_project フィールドを設定してください。
zerocode
Config ペインで、providers.models.gemini.<alias>.oauth_project フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.gemini.<alias>.oauth_project <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__gemini__<alias>__oauth_project=
OpenAI互換
venice https://api.venice.ainearai https://cloud-api.near.ai/v1vercel https://ai-gateway.vercel.sh/v1cloudflare https://gateway.ai.cloudflare.com/v1atlascloud https://api.atlascloud.ai/v1moonshot dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
endpoint
Moonshot エンドポイントのバリエーション。オペレーターはアカウントに合ったリージョンを選択します。ランタイムは、base.uri で上書きされない限り、選択したバリエーションから URI を解決します。Code バリエーションは intl 専用です。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/moonshot を開いて providers.models.moonshot.<alias>.endpoint フィールドを設定します。
zerocode
Config ペインで、providers.models.moonshot.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.moonshot.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__moonshot__<alias>__endpoint=
synthetic https://api.synthetic.new/openai/v1opencode https://opencode.ai/zen/v1zai dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
endpoint
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/zai を開き、providers.models.zai.<alias>.endpoint フィールドを設定してください。
zerocode
Config ペインで、providers.models.zai.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.zai.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__zai__<alias>__endpoint=
glm dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
endpoint
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/glm を開き、providers.models.glm.<alias>.endpoint フィールドを設定してください。
zerocode
Config ペインで、providers.models.glm.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.glm.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__glm__<alias>__endpoint=
minimax dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
auth_mode
複数の認証方式をサポートする model_provider ファミリー(例:Qwen、Minimax は API キーまたは OAuth を使用可能)の認証モード。単一の認証フローのみをサポートするファミリーは、設定構造体からこのフィールドを単に省略します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/minimax を開いて、providers.models.minimax.<alias>.auth_mode フィールドを設定してください。
zerocode
Config ペインで、providers.models.minimax.<alias>.auth_mode フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.minimax.<alias>.auth_mode <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__minimax__<alias>__auth_mode=
endpoint
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/minimax を開いて、providers.models.minimax.<alias>.endpoint フィールドを設定してください。
zerocode
Config ペインで providers.models.minimax.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.minimax.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__minimax__<alias>__endpoint=
oauth_client_id
MiniMaxが公開しているOAuthのclient_idを上書きします。ほとんどの運用者はこれを未設定のままにすべきです。ランタイムはベンダーが公開しているclient_id(MiniMax自身のポータルが使用するものと同じ)をデフォルトで使用します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/minimax を開いて providers.models.minimax.<alias>.oauth_client_id フィールドを設定してください。
zerocode
Config ペインで、providers.models.minimax.<alias>.oauth_client_id フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.minimax.<alias>.oauth_client_id <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__minimax__<alias>__oauth_client_id=
oauth_refresh_token
MiniMax が発行する長期有効な OAuth リフレッシュトークン。設定されている場合、ランタイムはプロバイダー構築時にこれを短命のアクセストークンと交換し、それを API 認証情報として使用します。ダッシュボードで生成された長期有効な API キーを使用したいオペレーターは、これを未設定のままにして api_key を直接設定できます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/minimax を開き、providers.models.minimax.<alias>.oauth_refresh_token フィールドを設定してください。
zerocode
Config ペインで、providers.models.minimax.<alias>.oauth_refresh_token フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.minimax.<alias>.oauth_refresh_token <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__minimax__<alias>__oauth_refresh_token=
bedrock dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
region
Bedrock エンドポイントの AWS リージョン(例: us-east-1、eu-west-1)。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/bedrock を開き、providers.models.bedrock.<alias>.region フィールドを設定します。
zerocode
Config ペインで、providers.models.bedrock.<alias>.region フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.bedrock.<alias>.region <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__bedrock__<alias>__region=
qianfan https://qianfan.baidubce.com/v2doubao https://ark.cn-beijing.volces.com/api/v3qwen dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
auth_mode
複数の認証方式をサポートする model_provider ファミリー(例:Qwen、Minimax は API キーまたは OAuth を使用可能)の認証モード。単一の認証フローのみをサポートするファミリーは、設定構造体からこのフィールドを単に省略します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/qwen を開き、providers.models.qwen.<alias>.auth_mode フィールドを設定します。
zerocode
Config ペインで、providers.models.qwen.<alias>.auth_mode フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.qwen.<alias>.auth_mode <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__qwen__<alias>__auth_mode=
endpoint
Qwen エンドポイントのバリエーション。オペレーターはアカウントに一致するリージョンを選択します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/qwen を開いて、providers.models.qwen.<alias>.endpoint フィールドを設定してください。
zerocode
Config ペインで、providers.models.qwen.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.qwen.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__qwen__<alias>__endpoint=
oauth_client_id
Qwen の公開された OAuth client_id を上書きします。ほとんどのオペレーターはこれを未設定のままにしておくべきです。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/qwen を開き、providers.models.qwen.<alias>.oauth_client_id フィールドを設定します。
zerocode
Config ペインで、providers.models.qwen.<alias>.oauth_client_id フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.qwen.<alias>.oauth_client_id <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__qwen__<alias>__oauth_client_id=
oauth_refresh_token
長期間有効な Qwen OAuth リフレッシュトークン。設定されている場合、ランタイムはプロバイダー構築時にこれを短命なアクセストークンと交換します。アップストリームの qwen login ツール(~/.qwen/oauth_creds.json に書き込みます)に依存しているオペレーターは、これを未設定のままにしてください。その場合、ファイルキャッシュ統合が処理を引き継ぎます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/qwen を開き、providers.models.qwen.<alias>.oauth_refresh_token フィールドを設定します。
zerocode
Config ペインで、providers.models.qwen.<alias>.oauth_refresh_token フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.qwen.<alias>.oauth_refresh_token <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__qwen__<alias>__oauth_refresh_token=
oauth_resource_url
更新後のアクセストークンと紐付けられるリソースURLをオペレーターが上書きします。未設定の場合、ランタイムは endpoint から導出されたURL(または ~/.qwen/oauth_creds.json から読み込む場合はキャッシュされた resource_url)にフォールバックします。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/qwen を開き、providers.models.qwen.<alias>.oauth_resource_url フィールドを設定してください。
zerocode
Config ペインで、providers.models.qwen.<alias>.oauth_resource_url フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.qwen.<alias>.oauth_resource_url <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__qwen__<alias>__oauth_resource_url=
groq https://api.groq.com/openai/v1mistral https://api.mistral.ai/v1xai https://api.x.ai/v1deepseek https://api.deepseek.comtogether https://api.together.xyzfireworks https://api.fireworks.ai/inference/v1novita https://api.novita.ai/openaiperplexity https://api.perplexity.aicohere https://api.cohere.com/compatibilitycopilot dynamic / resolved at runtimegemini_cli CLI-backed · local
Slot-specific fields (in addition to the shared fields above):
binary_path
gemini CLI バイナリへのパス。指定がない場合は gemini(PATH から検索)が使用されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/gemini_cli を開き、providers.models.gemini_cli.<alias>.binary_path フィールドを設定してください。
zerocode
Config ペインで、providers.models.gemini_cli.<alias>.binary_path フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.gemini_cli.<alias>.binary_path <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__gemini_cli__<alias>__binary_path=
grok_cli CLI-backed · local
Slot-specific fields (in addition to the shared fields above):
binary_path
grok CLIバイナリへのパス。指定しない場合はgrok(PATH検索)にフォールバックします。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/grok_cli を開き、providers.models.grok_cli.<alias>.binary_path フィールドを設定します。
zerocode
Config ペインで、providers.models.grok_cli.<alias>.binary_path フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.grok_cli.<alias>.binary_path <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__grok_cli__<alias>__binary_path=
env_passthrough
grok サブプロセスが継承する追加の環境変数名。値は起動時に ZeroClaw プロセスの環境から解決されます。無関係なデーモンのシークレットが引き続きブロックされるよう、デフォルトは空です。XAI_API_KEY はサポートされている唯一のプロバイダー所有名で、明示的に一覧に記載され、かつ空でない場合に API キー認証を有効にします。それ以外の XAI_* とすべての GROK_* 名は拒否されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/grok_cli を開き、providers.models.grok_cli.<alias>.env_passthrough フィールドを設定します。
zerocode
Config ペインで、providers.models.grok_cli.<alias>.env_passthrough フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.grok_cli.<alias>.env_passthrough <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__grok_cli__<alias>__env_passthrough=
extra_args
agent stdio の前に挿入される追加のグローバル Grok ロングフラグ。既知のオプションでは値を次のトークンに指定できます。それ以外の値を取るオプションでは --flag=value を使用します。位置引数と短形式引数は拒否されます。ZeroClaw のデフォルトは --sandbox strict、--permission-mode dontAsk、および空の組み込みツールセットです。ここで対応するフラグを指定することは、これらのデフォルトを緩和するためのエイリアスごとの明示的なオプトインです。ACP トランスポート、prompt/model/session、cwd、debug-file、および update-policy のフラグは予約されています。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/grok_cli を開き、providers.models.grok_cli.<alias>.extra_args フィールドを設定します。
zerocode
Config ペインで、providers.models.grok_cli.<alias>.extra_args フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.grok_cli.<alias>.extra_args <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__grok_cli__<alias>__extra_args=
max_acp_stdout_bytes
1 回の ACP リクエストで grok agent stdio から受け入れる stdout の累積バイト数の最大値。未設定の場合、ZeroClaw は 4 MiB を使用します。値は 1 MiB 以上 64 MiB 以下である必要があります。プロバイダーは構築時に無効な値を拒否します。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/grok_cli を開き、providers.models.grok_cli.<alias>.max_acp_stdout_bytes フィールドを設定します。
zerocode
Config ペインで、providers.models.grok_cli.<alias>.max_acp_stdout_bytes フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.grok_cli.<alias>.max_acp_stdout_bytes <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__grok_cli__<alias>__max_acp_stdout_bytes=
working_directory*
grok サブプロセスおよび ACP セッション境界に必要な絶対作業ディレクトリ。プロバイダーの構築時にディレクトリが存在している必要があります。プロジェクトスコープの Grok 設定は、このパスを基準に解決されます。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/grok_cli を開き、providers.models.grok_cli.<alias>.working_directory フィールドを設定します。
zerocode
Config ペインで、providers.models.grok_cli.<alias>.working_directory フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.grok_cli.<alias>.working_directory <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__grok_cli__<alias>__working_directory=
kilocli CLI-backed · local
Slot-specific fields (in addition to the shared fields above):
binary_path
kilo CLIバイナリへのパス。指定がない場合はkilo(PATH検索)にフォールバックします。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/kilocli を開き、providers.models.kilocli.<alias>.binary_path フィールドを設定します。
zerocode
Config ペインで、providers.models.kilocli.<alias>.binary_path フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.kilocli.<alias>.binary_path <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__kilocli__<alias>__binary_path=
kilo https://api.kilo.ai/api/gateway
Slot-specific fields (in addition to the shared fields above):
endpoint
Kilo AI Gateway エンドポイント。kilo.ai の単一の正規エンドポイント。
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/kilo を開き、providers.models.kilo.<alias>.endpoint フィールドを設定してください。
zerocode
Config ペインで、providers.models.kilo.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.kilo.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__kilo__<alias>__endpoint=
zerorouter https://zerorouter.ai/v1lmstudio http://localhost:1234/v1 · localllamacpp http://localhost:8080/v1 · localsglang http://localhost:30000/v1 · localvllm http://localhost:8000/v1 · localosaurus http://localhost:1337/v1 · localnvidia https://integrate.api.nvidia.com/v1siliconflow https://api.siliconflow.com/v1aihubmix https://aihubmix.com/v1litellm http://localhost:4000/v1atomic_chat http://127.0.0.1:1337/v1 · localastrai https://as-trai.com/v1deepmyst https://api.deepmyst.com/v1manifest https://app.manifest.build/v1morph https://api.morphllm.com/v1github_models https://models.github.ai/inferenceupstage https://api.upstage.ai/v1featherless https://api.featherless.ai/v1arcee https://api.arcee.ai/api/v1lambda_ai https://api.lambda.ai/v1inception https://api.inceptionlabs.ai/v1custom operator required高速推論
cerebras https://api.cerebras.ai/v1sambanova https://api.sambanova.ai/v1hyperbolic https://api.hyperbolic.xyz/v1モデルホスティングプラットフォーム
deepinfra https://api.deepinfra.com/v1/openaihuggingface https://router.huggingface.co/v1ai21 https://api.ai21.com/studio/v1reka https://api.reka.ai/v1baseten https://inference.baseten.co/v1nscale https://inference.api.nscale.com/v1anyscale https://api.endpoints.anyscale.com/v1nebius https://api.tokenfactory.nebius.com/v1friendli https://api.friendli.ai/serverless/v1lepton https://llama3-1-405b.lepton.run/api/v1中国語AI
stepfun dynamic / resolved at runtime
Slot-specific fields (in addition to the shared fields above):
endpoint
任意のサーフェスに設定する場合:
ゲートウェイダッシュボード
/config/providers.models/stepfun を開き、providers.models.stepfun.<alias>.endpoint フィールドを設定してください。
zerocode
Config ペインで、providers.models.stepfun.<alias>.endpoint フィールドを設定します。
zeroclaw config
zeroclaw config set providers.models.stepfun.<alias>.endpoint <value>
環境変数
オーバーライドをエクスポートします(POSIXシェル用。~/.bashrc、~/.zshrc、.env、またはDockerfileに記述します)。<alias>を実際のエイリアスに置き換えてください。
export ZEROCLAW_providers__models__stepfun__<alias>__endpoint=
baichuan https://api.baichuan-ai.com/v1yi https://api.lingyiwanwu.com/v1hunyuan https://api.hunyuan.cloud.tencent.com/v1クラウドAIエンドポイント
ovh https://oai.endpoints.kepler.ai.cloud.ovh.net/v1avian https://api.avian.io/v1ファミリーごとの実例については、設定を参照してください。ご利用のベンダーが一覧にない場合は、customスロットを使用してください(カスタムプロバイダー)。
実例: Morph、GitHub Models、Upstage、Featherless、Arcee、Lambda AI、Inception
これらはそれぞれ標準的な OpenAI 互換スロットです。model と api_key を設定し、uri は省略します(型付きエンドポイントが提供します)。いずれも公開モデルインデックスを提供していないため、認証情報を貼り付けるまでモデルピッカーは空のままです。キーを設定すると、ZeroClaw はプロバイダーのライブ /models エンドポイントからモデルを一覧表示します。以下のモデル ID は例示用です。最新のカタログはベンダーのダッシュボードで確認してください。
Morph: スロット morph。高速な編集適用モデル(morph-v3-large、morph-v3-fast、または auto)。キーは Morph ダッシュボード から取得します。
GitHub Models: スロット github_models(エイリアス github-models)。単一の GitHub Personal Access Token で OpenAI / Meta / Microsoft のモデルを利用できます。models 権限を持つ PAT(fine-grained)を作成してください。Copilot トークンは同じ認証情報では_ありません_。モデル ID はパブリッシャー名がプレフィックスとして付きます(例: openai/gpt-4o)。
Upstage: スロット upstage。Solar Pro / Solar Mini(例: solar-pro2)。キーは Upstage console から取得します。
Featherless: スロット featherless。サーバーレスのオープンウェイトモデルで、Hugging Face のリポジトリ ID で指定します(例: meta-llama/Meta-Llama-3.1-8B-Instruct)。キーは featherless.ai から取得します。
Arcee: スロット arcee。ネイティブモデルには conductor、maestro、virtuoso-large、coder-large、blitz が含まれます。キーは Arcee platform から取得します。Arcee の Platform API は非標準の /api/v1 ベースパスを使用しますが、型付きエンドポイントが既にこれを考慮しているため、引き続き uri は省略してください。
Lambda AI: スロット lambda_ai(エイリアス lambda-ai)。Lambda のホスト型推論(例: hermes3-405b)。キーは Lambda Cloud の API キーページから取得します。
Inception: スロット inception。Mercury 拡散 LLM ファミリー(mercury-coder および新しい mercury-2)。キーは Inception プラットフォームから取得します。
Atlas Cloud: スロット atlascloud。ベアラートークン認証を使用する OpenAI 互換エンドポイント https://api.atlascloud.ai/v1。正規の atlascloud スロットのみを使用してください。atlas、atlas-cloud、atlas_cloud は実行時のエイリアスではありません。
[providers.models.atlascloud.home]
model = "..."
api_key = "..."
資格情報は設定(
api_key)または実行時の--credentialオーバーライドからのみ取得され、これらのスロットはプロバイダーごとの*_API_KEY環境変数を読み取りません。
NEAR AI Cloud の例:
[providers.models.nearai.tee]
model = "..." # https://cloud-api.near.ai/v1/model/list からmodelIdを選択
api_key = "..."
nearai スロットはデフォルトで https://cloud-api.near.ai/v1 を使用し、Authorization: Bearer <api_key> を送信します。既存の NEARAI_API_KEY シェル変数を ZeroClaw のスキーマミラー環境サーフェスにブリッジするには、ZEROCLAW_providers__models__nearai__tee__api_key="$NEARAI_API_KEY" を設定してください。
マルチリージョンファミリー
複数の中国系ベンダーは、デフォルトモデルが異なる地域ごとのエンドポイントを公開しています。1つの正規スロットを使用し、エイリアスエントリの型付きendpointフィールドでリージョンを選択してください。
Moonshot: スロット moonshot
バリアント: cn、intl、code。
Qwen / DashScope: スロット qwen
OAuth 対応の Qwen アカウントは、同じスロットで auth_mode = "o_auth" を使用します。
GLM: スロット glm
MiniMax: スロット minimax
[providers.models.minimax.intl]
model = "MiniMax-M3" # または MiniMax-M2.7、MiniMax-M2.7-highspeed
api_key = "..."
endpoint = "intl" # バリアント: cn、intl
MiniMax の Anthropic 互換 API では、代わりに [providers.models.anthropic.minimax] を uri = "https://api.minimax.io/anthropic"(グローバル)または uri = "https://api.minimaxi.com/anthropic"(中国)とともに使用してください。
Z.AI: スロット zai
Z.AIのAnthropic互換APIを使用する場合は、代わりに[providers.models.anthropic.zai]とuri = "https://api.z.ai/api/anthropic"を使用してください。
Doubao / Volcengine: スロット doubao
残りの中国地域スロット(yi、hunyuan、qianfan、baichuan)は上記の全スロット表に表示されます。エイリアスエントリの型付き endpoint フィールドで地域を選択してください。
ルーティングレイヤー
OpenRouterは、メタルーターではなく、単一のファーストクラスプロバイダーとして扱われます。ランタイムからは1つのエンドポイントとして認識され、そのエンドポイントの背後でOpenRouterがベンダーへのファンアウトを処理します。
タスクごとのルーティングを行うには、複数のエージェントを実行し、チャネルにどのエージェントがどのトラフィックを処理するかを選ばせます。Routingを参照してください。設定ファイル内でより限定的なヒント機構を使用する場合は、[[model_routes]]を使用します。
何か不足していますか?
- エンドポイントが OpenAI 互換の場合は、
uriを設定したcustomスロットを使用します。 - 独自の正規スロットが上記にある場合は、いずれか1つのリージョンしか表示されていなくても、それを使用してください。スロットの
endpoint列挙型が残りをカバーします。 - OpenAI 以外のワイヤーフォーマットを使用し、独自の実装が必要な場合は、カスタムプロバイダーを参照してください。