設定 — ツールとカスタムプロバイダー

プロバイダーエントリ（type: "provider" または省略）：

• provider：API プロバイダー ID（openai、anthropic、google/gemini、groq など）
• model：モデル ID の上書き
• profile / preferredProfile：auth-profiles.json のプロファイル選択

CLI エントリ（type: "cli"）：

• command：実行する実行可能ファイル
• args：テンプレート化された引数（{{MediaPath}}、{{Prompt}}、{{MaxChars}} などをサポート。openclaw doctor --fix は非推奨の {input} プレースホルダーを {{MediaPath}} に移行します）

共通フィールド：

• capabilities：任意のリスト（image、audio、video）。各プロバイダー Plugin は独自のデフォルト機能セットを宣言します。たとえば、バンドルされている openai プロバイダーのデフォルトは画像と音声、anthropic/minimax は画像、google は画像、音声、動画、groq は音声です。
• prompt、maxChars、maxBytes、timeoutSeconds、language：エントリごとの上書き。
• tools.media.image.timeoutSeconds と対応する画像モデルの timeoutSeconds エントリは、エージェントが明示的な image ツールを呼び出す場合にも適用されます。画像理解では、このタイムアウトはリクエスト自体に適用され、それ以前の準備処理によって短縮されません。
• 失敗した場合は次のエントリにフォールバックします。

プロバイダー認証は標準の順序に従います：auth-profiles.json → 環境変数 → models.providers.*.apiKey。

非同期完了フィールド：

• asyncCompletion.directSend：非推奨の互換性フラグ。完了した非同期メディアタスクは、引き続きリクエスト元セッションを介して処理されます。これにより、エージェントが結果を受け取り、ユーザーへの伝え方を決定し、送信元への配信で必要な場合にメッセージツールを使用できます。

• self：現在のセッションキーのみ。
• tree：現在のセッションと、現在のセッションから生成されたセッション（サブエージェント）。
• agent：現在のエージェント ID に属する任意のセッション（同じエージェント ID で送信者ごとのセッションを実行している場合、他のユーザーを含む可能性があります）。
• all：任意のセッション。エージェントをまたぐ対象指定には、引き続き tools.agentToAgent が必要です。
• サンドボックスによる制限：現在のセッションがサンドボックス化され、agents.defaults.sandbox.sessionToolsVisibility="spawned"（デフォルト）の場合、tools.sessions.visibility="all" であっても可視性は強制的に tree になります。
• all 以外の場合、sessions_list には有効なモードを示す簡潔な visibility フィールドと、現在のスコープ外にある一部のセッションが省略される可能性があるという警告が含まれます。

• 添付ファイルには enabled: true が必要です。
• サブエージェントの添付ファイルは、子ワークスペース内の .openclaw/attachments/<uuid>/ に .manifest.json とともに実体化されます。
• ACP の添付ファイルは画像のみに対応し、同じファイル数、ファイルごとのバイト数、合計バイト数の制限を満たした後、ACP ランタイムにインラインで転送されます。
• 添付ファイルの内容は、トランスクリプトの永続化時に自動的に秘匿化されます。
• Base64 入力は、厳格な文字種とパディングのチェック、およびデコード前のサイズ制限によって検証されます。
• サブエージェントの添付ファイル権限は、ディレクトリが 0700、ファイルが 0600 です。
• サブエージェントのクリーンアップは cleanup ポリシーに従います。delete は常に添付ファイルを削除し、keep は retainOnSessionKeep: true の場合にのみ保持します。

• カスタム認証が必要な場合は、authHeader: true + headers を使用します。
• OPENCLAW_AGENT_DIR でエージェント設定のルートを上書きします。
• 一致するプロバイダー ID のマージ優先順位:
  • エージェントの models.json にある空でない baseUrl 値が優先されます。
  • エージェントの空でない apiKey 値は、現在の設定および認証プロファイルのコンテキストで、そのプロバイダーが SecretRef 管理ではない場合にのみ優先されます。
  • SecretRef 管理のプロバイダーの apiKey 値は、解決済みシークレットを永続化する代わりに、ソースマーカー（環境変数参照では ENV_VAR_NAME、ファイル/exec 参照では secretref-managed）から更新されます。
  • SecretRef 管理のプロバイダーのヘッダー値は、ソースマーカー（環境変数参照では secretref-env:ENV_VAR_NAME、ファイル/exec 参照では secretref-managed）から更新されます。
  • エージェントの apiKey/baseUrl が空または欠落している場合は、設定内の models.providers にフォールバックします。
  • 一致するモデルの contextWindow/maxTokens: 明示的な設定値が存在し、有効（正の有限数）である場合は、その値が優先されます。それ以外の場合は、暗黙的または生成されたカタログ値が使用されます。
  • 一致するモデルの contextTokens も、同じく「明示値があれば優先し、それ以外は暗黙値」という規則に従います。ネイティブモデルのメタデータを変更せずに、実効コンテキストを制限するために使用します。
  • プロバイダー Plugin のカタログは、エージェントの Plugin 状態内に、生成された Plugin 所有のカタログシャードとして保存されます。
  • 設定で models.json を完全に書き換え、Plugin 所有のカタログシャードをマージしない場合は、models.mode: "replace" を使用します。
  • マーカーの永続化ではソースが正となります。マーカーは、解決済みのランタイムシークレット値ではなく、アクティブなソース設定のスナップショット（解決前）から書き込まれます。

• models.mode: プロバイダーカタログの動作（merge または replace）。
• models.providers: プロバイダー ID をキーとするカスタムプロバイダーマップ。
  • 安全な編集: 追加更新には openclaw config set models.providers.<id> '<json>' --strict-json --merge または openclaw config set models.providers.<id>.models '<json-array>' --strict-json --merge を使用します。--replace を渡さない限り、config set は破壊的な置換を拒否します。

• models.providers.*.api: リクエストアダプター（openai-completions、openai-responses、openai-chatgpt-responses、anthropic-messages、google-generative-ai、google-vertex、github-copilot、bedrock-converse-stream、ollama、azure-openai-responses）。MLX、vLLM、SGLang、および大半の OpenAI 互換ローカルサーバーなど、セルフホスト型の /v1/chat/completions バックエンドには openai-completions を使用します。baseUrl があり api がないカスタムプロバイダーでは、デフォルトで openai-completions が使用されます。バックエンドが /v1/responses をサポートする場合にのみ openai-responses を設定します。
• models.providers.*.apiKey: プロバイダーの認証情報（SecretRef または環境変数による置換を推奨）。
• models.providers.*.auth: 認証方式（api-key、token、oauth、aws-sdk）。
• models.providers.*.contextWindow: モデルエントリで contextWindow が設定されていない場合に、このプロバイダー配下のモデルへ適用されるデフォルトのネイティブコンテキストウィンドウ。
• models.providers.*.contextTokens: モデルエントリで contextTokens が設定されていない場合に、このプロバイダー配下のモデルへ適用されるデフォルトの実効ランタイムコンテキスト上限。
• models.providers.*.maxTokens: モデルエントリで maxTokens が設定されていない場合に、このプロバイダー配下のモデルへ適用されるデフォルトの出力トークン上限。
• models.providers.*.timeoutSeconds: 接続、ヘッダー、本文、およびリクエスト全体の中断処理を含む、プロバイダーごとのモデル HTTP リクエストの任意のタイムアウト（秒単位）。
• models.providers.*.injectNumCtxForOpenAICompat: Ollama + openai-completions の場合に、リクエストへ options.num_ctx を注入します（デフォルト: true）。
• models.providers.*.authHeader: 必要な場合に、認証情報を Authorization ヘッダーで強制的に送信します。
• models.providers.*.baseUrl: 上流 API のベース URL。
• models.providers.*.headers: プロキシまたはテナントルーティング用の追加静的ヘッダー。

models.providers.*.request: モデルプロバイダーへの HTTP リクエストの送信設定を上書きします。

• request.headers: 追加ヘッダー（プロバイダーのデフォルトとマージされます）。値には SecretRef を使用できます。
• request.auth: 認証方式の上書き。モード: "provider-default"（プロバイダー組み込みの認証を使用）、"authorization-bearer"（token と併用）、"header"（headerName、value、任意の prefix と併用）。
• request.proxy: HTTP プロキシの上書き。モード: "env-proxy"（HTTP_PROXY/HTTPS_PROXY 環境変数を使用）、"explicit-proxy"（url と併用）。どちらのモードでも、任意の tls サブオブジェクトを使用できます。
• request.tls: 直接接続の TLS 設定を上書きします。フィールド: ca、cert、key、passphrase（すべて SecretRef を使用可能）、serverName、insecureSkipVerify。
• request.allowPrivateNetwork: true の場合、プロバイダー HTTP フェッチガードを通じて、プライベート、CGNAT、または同様の範囲に対するモデルプロバイダー HTTP リクエストを許可します。カスタムまたはローカルプロバイダーのベース URL では、設定された正確なオリジンがすでに信頼されます。ただし、メタデータまたはリンクローカルのオリジンは、明示的にオプトインしない限り引き続きブロックされます。正確なオリジンを信頼しないようにするには、これを false に設定します。WebSocket はヘッダー/TLS に同じ request を使用しますが、このフェッチ SSRF ゲートは使用しません。デフォルトは false です。

• models.providers.*.models: 明示的なプロバイダーモデルカタログのエントリ。
• models.providers.*.models.*.input: モデルの入力モダリティ。テキスト専用モデルには ["text"]、ネイティブの画像/ビジョンモデルには ["text", "image"] を使用します。選択されたモデルが画像対応としてマークされている場合にのみ、画像の添付ファイルがエージェントのターンへ注入されます。
• models.providers.*.models.*.contextWindow: ネイティブモデルのコンテキストウィンドウのメタデータ。このモデルについて、プロバイダーレベルの contextWindow を上書きします。
• models.providers.*.models.*.contextTokens: 任意のランタイムコンテキスト上限。プロバイダーレベルの contextTokens を上書きします。モデルのネイティブな contextWindow よりも小さい実効コンテキスト予算を使用する場合に設定します。値が異なる場合、openclaw models list には両方の値が表示されます。
• models.providers.*.models.*.compat.supportsDeveloperRole: 任意の互換性ヒント。空でない非ネイティブの baseUrl（ホストが api.openai.com ではない）を使用する api: "openai-completions" の場合、OpenClaw はランタイムでこれを強制的に false にします。baseUrl が空または省略されている場合は、OpenAI のデフォルト動作が維持されます。
• models.providers.*.models.*.compat.requiresStringContent: 文字列のみを受け付ける OpenAI 互換チャットエンドポイント向けの任意の互換性ヒント。true の場合、OpenClaw は純粋なテキストで構成された messages[].content 配列を、リクエスト送信前にプレーン文字列へ平坦化します。
• models.providers.*.models.*.compat.strictMessageKeys: 厳格な OpenAI 互換チャットエンドポイント向けの任意の互換性ヒント。true の場合、OpenClaw はリクエスト送信前に、送信する Chat Completions のメッセージオブジェクトを role と content のみに絞り込みます。
• models.providers.*.models.*.compat.thinkingFormat: 任意の思考ペイロードのヒント。Together 形式の reasoning.enabled には "together"、最上位の enable_thinking には "qwen"、vLLM など、リクエストレベルのチャットテンプレート引数をサポートする Qwen 系 OpenAI 互換サーバーの chat_template_kwargs.enable_thinking には "qwen-chat-template" を使用します。設定された vLLM Qwen モデルでは、これらの形式に対して二者択一の /think 選択肢（off、on）が公開されます。
• models.providers.*.models.*.compat.requiresReasoningContentOnAssistantMessages: 過去のアシスタントメッセージを再生する際に reasoning_content を保持する必要がある、DeepSeek 形式の Chat Completions バックエンド向けの任意の互換性ヒント。true の場合、OpenClaw は送信するアシスタントメッセージでそのフィールドを保持します。推論情報が削除された後のリクエストを拒否する、カスタムの DeepSeek 互換プロキシを接続する場合に使用します。デフォルトは false です。

• plugins.entries.amazon-bedrock.config.discovery: Bedrock 自動検出設定のルート。
• plugins.entries.amazon-bedrock.config.discovery.enabled: 暗黙的な検出のオン/オフを切り替えます。
• plugins.entries.amazon-bedrock.config.discovery.region: 検出に使用する AWS リージョン。
• plugins.entries.amazon-bedrock.config.discovery.providerFilter: 対象を限定した検出に使用する任意のプロバイダー ID フィルター。
• plugins.entries.amazon-bedrock.config.discovery.refreshInterval: 検出を更新するポーリング間隔。
• plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow: 検出されたモデルに使用するフォールバックのコンテキストウィンドウ。
• plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens: 検出されたモデルに使用するフォールバックの最大出力トークン数。

公式の外部 cerebras プロバイダー Plugin では、openclaw onboard --auth-choice cerebras-api-key を使用してこれを設定できます。明示的なプロバイダー設定は、デフォルトを上書きする場合にのみ使用します。

{  env: { CEREBRAS_API_KEY: "sk-..." },  agents: {    defaults: {      model: {        primary: "cerebras/zai-glm-4.7",        fallbacks: ["cerebras/gpt-oss-120b"],      },      models: {        "cerebras/zai-glm-4.7": { alias: "GLM 4.7 (Cerebras)" },        "cerebras/gpt-oss-120b": { alias: "GPT OSS 120B (Cerebras)" },      },    },  },  models: {    mode: "merge",    providers: {      cerebras: {        baseUrl: "https://api.cerebras.ai/v1",        apiKey: "${CEREBRAS_API_KEY}",        api: "openai-completions",        models: [          { id: "zai-glm-4.7", name: "GLM 4.7 (Cerebras)" },          { id: "gpt-oss-120b", name: "GPT OSS 120B (Cerebras)" },        ],      },    },  },}

Cerebras には cerebras/zai-glm-4.7、Z.AI への直接接続には zai/glm-4.7 を使用します。

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },      models: { "kimi/kimi-for-coding": { alias: "Kimi Code" } },    },  },}

Anthropic 互換の組み込みプロバイダーです。ショートカット: openclaw onboard --auth-choice kimi-code-api-key。

ローカルモデルを参照してください。要約：高性能なハードウェア上で、LM Studio Responses API を介して大規模なローカルモデルを実行します。フォールバック用にホスト型モデルも統合した状態を維持してください。

{  agents: {    defaults: {      model: { primary: "minimax/MiniMax-M3" },      models: {        "minimax/MiniMax-M3": { alias: "Minimax" },      },    },  },  models: {    mode: "merge",    providers: {      minimax: {        baseUrl: "https://api.minimax.io/anthropic",        apiKey: "${MINIMAX_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "MiniMax-M3",            name: "MiniMax M3",            reasoning: true,            input: ["text", "image"],            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },            contextWindow: 1000000,            maxTokens: 131072,          },        ],      },    },  },}

MINIMAX_API_KEYを設定します。ショートカット：openclaw onboard --auth-choice minimax-global-apiまたはopenclaw onboard --auth-choice minimax-cn-api。モデルカタログのデフォルトは M3 で、M2.7 の各バリアントも含まれます。Anthropic 互換のストリーミング経路では、thinkingを明示的に設定しない限り、OpenClaw はデフォルトで MiniMax M2.x の思考機能を無効にします。MiniMax-M3（および M3.x）は、デフォルトでプロバイダーの省略時／適応型思考経路を使用します。/fast onまたはparams.fastMode: trueを指定すると、MiniMax-M2.7がMiniMax-M2.7-highspeedに書き換えられます。

{  env: { MOONSHOT_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "moonshot/kimi-k2.6" },      models: { "moonshot/kimi-k2.6": { alias: "Kimi K2.6" } },    },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [          {            id: "kimi-k2.6",            name: "Kimi K2.6",            reasoning: false,            input: ["text", "image"],            cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },            contextWindow: 262144,            maxTokens: 262144,          },        ],      },    },  },}

中国向けエンドポイントには、baseUrl: "https://api.moonshot.cn/v1"またはopenclaw onboard --auth-choice moonshot-api-key-cnを使用します。

Moonshot のネイティブエンドポイントは、共有のopenai-completionsトランスポート上でストリーミング使用量との互換性を通知します。OpenClaw は組み込みプロバイダー ID だけでなく、エンドポイントの機能に基づいてこれを有効化します。

{  agents: {    defaults: {      model: { primary: "opencode/claude-opus-4-6" },      models: { "opencode/claude-opus-4-6": { alias: "Opus" } },    },  },}

OPENCODE_API_KEY（またはOPENCODE_ZEN_API_KEY）を設定します。Zen カタログにはopencode/...参照を、Go カタログにはopencode-go/...参照を使用します。ショートカット：openclaw onboard --auth-choice opencode-zenまたはopenclaw onboard --auth-choice opencode-go。

{  env: { SYNTHETIC_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" },      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "MiniMax M2.5" } },    },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "hf:MiniMaxAI/MiniMax-M2.5",            name: "MiniMax M2.5",            reasoning: true,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 192000,            maxTokens: 65536,          },        ],      },    },  },}

ベース URL では/v1を省略してください（Anthropic クライアントが追加します）。ショートカット：openclaw onboard --auth-choice synthetic-api-key。

{  agents: {    defaults: {      model: { primary: "zai/glm-4.7" },      models: { "zai/glm-4.7": {} },    },  },}

ZAI_API_KEYを設定します。モデル参照には正規のzai/*プロバイダー ID を使用します。ショートカット：openclaw onboard --auth-choice zai-api-key。

• 汎用エンドポイント：https://api.z.ai/api/paas/v4
• コーディング用エンドポイント：https://api.z.ai/api/coding/paas/v4
• デフォルトのzai-api-key認証選択では、キーを検査し、そのキーが属するエンドポイントを自動検出します（検出結果が確定できない場合は入力を求め、デフォルトでグローバルを選択します）。明示的に選択するための中国向けおよび Coding-Plan 専用の認証選択も利用できます。
• 汎用エンドポイントを使用する場合は、ベース URL を上書きしたカスタムプロバイダーを定義します。