openclaw models

モデルの検出、スキャン、設定（デフォルトモデル、フォールバック、認証プロファイル）を管理します。

関連ドキュメント:

主要コマンド

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

openclaw models status は解決済みのデフォルト/フォールバック設定と認証の概要を表示します。 プロバイダの使用状況スナップショットが利用可能な場合、OAuth/トークンステータスセクションに プロバイダ使用状況ヘッダーが含まれます。 --probe を付けると、設定済みの各プロバイダプロファイルに対してライブ認証プローブを実行します。 プローブは実際のリクエストを行うため、トークンを消費しレート制限に影響する可能性があります。 --agent <id> で設定済みエージェントのモデル/認証状態を確認できます。省略した場合は OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR（設定されている場合）、またはデフォルトエージェントが使用されます。

補足:

  • models set <model-or-alias> は provider/model またはエイリアスを受け付けます。
  • モデル参照は最初の / で分割して解析されます。モデルIDに / が含まれる場合（OpenRouterスタイル）は、プロバイダプレフィックスを含めてください（例: openrouter/moonshotai/kimi-k2）。
  • プロバイダを省略すると、入力はエイリアスまたはデフォルトプロバイダのモデルとして扱われます（モデルIDに / が含まれない場合のみ有効）。
  • models status の認証出力では、シークレットでないプレースホルダー（例: OPENAI_API_KEY、secretref-managed、minimax-oauth、qwen-oauth、ollama-local）に対して marker(<value>) がマスク処理の代わりに表示されることがあります。

models status

オプション:

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

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

openclaw models aliases list
openclaw models fallbacks list

認証プロファイル

openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token

models auth login はプロバイダプラグインの認証フロー（OAuth/APIキー）を実行します。 インストール済みのプロバイダを確認するには openclaw plugins list を使用してください。

補足:

  • setup-token はセットアップトークンの値を入力するプロンプトを表示します（任意のマシンで claude setup-token を実行して生成できます）。
  • paste-token は他の場所や自動化ツールで生成されたトークン文字列を受け付けます。
  • Anthropicポリシーに関する注意: セットアップトークンのサポートは技術的互換性のためのものです。Anthropicは過去にClaude Code以外でのサブスクリプション利用をブロックしたことがあるため、広範に使用する前に現行の利用規約を確認してください。
arrow_back
前へ
Message
次へ
Node
arrow_forward