メインコンテンツへスキップ

openclaw models

モデルの検出、スキャン、設定(既定モデル、フォールバック、認証プロファイル)。 関連:

共通コマンド

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan
openclaw models status は解決されたデフォルト/フォールバックと認証概要を表示します。 プロバイダの使用状況スナップショットが利用可能な場合、OAuth/tokenステータスセクションには プロバイダの使用状況ヘッダーが含まれます。 設定された各プロバイダプロファイルに対してライブ認証プローブを実行するには、 --probe を追加します。 プローブは実際の要求です(トークンとトリガレート制限を消費する可能性があります)。 設定されたエージェントのモデル/認証状態を検査するには、 --agent <id> を使用します。 省略されたとき、 コマンドはOPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIRを使用します。それ以外の場合は、 デフォルトエージェントを設定します。 注記:
  • models set <model-or-alias>provider/model またはエイリアスを受け付けます。
  • モデル参照はfirst /で分割することによって解析されます。 モデル参照はfirst /で分割することによって解析されます。 モデル参照は 最初の / で分割して解析されます。モデル ID に /(OpenRouter 形式)が含まれる場合は、プロバイダープレフィックスを含めてください(例: openrouter/moonshotai/kimi-k2)。
  • プロバイダーを省略した場合、OpenClaw は入力をエイリアス、または 既定プロバイダー のモデルとして扱います(モデル ID に / が含まれない場合のみ機能します)。

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 を使用して、インストールされているプロバイダーを確認してください。 どのプロバイダがインストールされているかを確認するには、 openclawプラグインリスト を使用してください。 どのプロバイダがインストールされているかを確認するには、 openclawプラグインリスト を使用してください。 注記:
  • setup-token は、セットアップトークンの値を入力するように求めます(任意のマシンで claude setup-token を使用して生成してください)。
  • paste-token は、別の場所で生成された、または自動化から渡されたトークン文字列を受け付けます。