Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw models

• プロバイダー + モデル: モデル
• モデル選択の概念 + /models スラッシュコマンド: モデルの概念
• プロバイダー認証の設定: はじめに

​

よく使うコマンド

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

• models set <model-or-alias> は provider/model またはエイリアスを受け付けます。
• models list は読み取り専用です。config、認証プロファイル、既存のカタログ 状態、プロバイダー所有のカタログ行を読み取りますが、models.json は書き換えません。
• Auth 列はプロバイダーレベルで読み取り専用です。ローカルの 認証プロファイルメタデータ、env マーカー、設定済みプロバイダーキー、ローカルプロバイダー マーカー、AWS Bedrock env/profile マーカー、Plugin の合成認証メタデータから計算されます。 プロバイダーランタイムをロードしたり、keychain シークレットを読み取ったり、プロバイダー API を呼び出したり、モデルごとの正確な実行準備状況を証明したりするものではありません。
• models list --all --provider <id> は、そのプロバイダーでまだ認証していない場合でも、 Plugin マニフェストまたはバンドルされたプロバイダーカタログメタデータから、プロバイダー所有の静的カタログ 行を含めることがあります。これらの行は、一致する認証が設定されるまで引き続き 使用不可として表示されます。
• models list は、プロバイダーカタログ 検出が遅い間もコントロールプレーンの応答性を保ちます。デフォルトビューと設定済みビューは、短い待機後に設定済みまたは 合成モデル行へフォールバックし、検出は バックグラウンドで完了させます。正確な完全検出済みカタログが必要で、 プロバイダー検出を待つ意思がある場合は --all を使用してください。
• 広範な models list --all は、プロバイダーランタイムの補足フックをロードせずに、 マニフェストカタログ行をレジストリ行の上にマージします。プロバイダーでフィルタリングされたマニフェスト 高速パスは、static とマークされたプロバイダーのみを使用します。refreshable とマークされたプロバイダーは レジストリ/キャッシュベースのままで、マニフェスト行を補足として追加します。一方、 runtime とマークされたプロバイダーはレジストリ/ランタイム検出のままです。
• models list は、ネイティブモデルメタデータとランタイム上限を区別したままにします。テーブル 出力では、有効なランタイム上限がネイティブのコンテキストウィンドウと異なる場合、Ctx は contextTokens/contextWindow を表示します。JSON 行には、プロバイダーがその上限を公開している場合に contextTokens が含まれます。
• models list --provider <id> は、moonshot や openai-codex などのプロバイダー ID でフィルタリングします。Moonshot AI のような、対話型プロバイダー ピッカーの表示ラベルは受け付けません。
• モデル参照は、最初の / で分割して解析されます。モデル ID に / が含まれる場合（OpenRouter 形式）、プロバイダープレフィックスを含めてください（例: openrouter/moonshotai/kimi-k2）。
• プロバイダーを省略した場合、OpenClaw は入力をまずエイリアスとして解決し、次に その正確なモデル ID に対する一意の設定済みプロバイダー一致として解決し、その後でのみ 非推奨警告付きで設定済みデフォルトプロバイダーへフォールバックします。 そのプロバイダーが設定済みデフォルトモデルを公開しなくなっている場合、OpenClaw は 古い削除済みプロバイダーのデフォルトを表示する代わりに、最初の設定済みプロバイダー/モデルへフォールバックします。
• models status は、非シークレットのプレースホルダー（例: OPENAI_API_KEY、secretref-managed、minimax-oauth、oauth:chutes、ollama-local）について、シークレットとしてマスクする代わりに、認証出力で marker(<value>) を表示することがあります。

​

モデルスキャン

• --no-probe（メタデータのみ。config/シークレットの検索なし）
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms>（カタログリクエストおよびプローブごとのタイムアウト）
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

モデルステータス

• --json
• --plain
• --check（終了コード 1=期限切れ/欠落、2=期限間近）
• --probe（設定済み認証プロファイルのライブプローブ）
• --probe-provider <name>（1 つのプロバイダーをプローブ）
• --probe-profile <id>（繰り返し指定またはカンマ区切りのプロファイル ID）
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id>（設定済みエージェント ID。OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR を上書き）

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

• excluded_by_auth_order: 保存済みプロファイルは存在しますが、明示的な auth.order.<provider> に含まれていないため、プローブは試行する代わりに 除外を報告します。
• missing_credential、invalid_expires、expired、unresolved_ref: プロファイルは存在しますが、対象外または解決不能です。
• no_model: プロバイダー認証は存在しますが、OpenClaw はそのプロバイダー用の プローブ可能なモデル候補を解決できませんでした。

​

エイリアス + フォールバック

openclaw models aliases list
openclaw models fallbacks list

​

認証プロファイル

openclaw models auth add
openclaw models auth list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token

openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth list --provider openai

• setup-token と paste-token は、トークン認証メソッドを公開するプロバイダー向けの 汎用トークンコマンドとして残ります。
• setup-token には対話型 TTY が必要で、プロバイダーのトークン認証 メソッド（公開している場合は、そのプロバイダーの setup-token メソッドがデフォルト）を実行します。
• paste-token は、別の場所または自動化から生成されたトークン文字列を受け付けます。
• paste-token には --provider が必須で、トークン値の入力を促し、 --profile-id を渡さない限り、デフォルトのプロファイル ID <provider>:manual に書き込みます。
• paste-token --expires-in <duration> は、365d や 12h などの 相対期間から絶対的なトークン有効期限を保存します。
• Anthropic の注記: Anthropic スタッフは、OpenClaw 形式の Claude CLI 使用が再び許可されたと私たちに伝えたため、Anthropic が新しいポリシーを公開しない限り、OpenClaw はこの統合における Claude CLI 再利用と claude -p の使用を認可済みとして扱います。
• Anthropic の setup-token / paste-token は、サポートされる OpenClaw トークン経路として引き続き利用できますが、OpenClaw は現在、利用可能な場合は Claude CLI 再利用と claude -p を優先します。

​

関連

• CLI リファレンス
• モデル選択
• モデルフェイルオーバー