`openclaw models`

模型探索、掃描與設定（預設模型、備援模型、驗證設定檔）。

相關資源：

提供者與模型：Models
提供者驗證設定：Getting started

常用指令

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

openclaw models status 會顯示已解析的預設/備援模型以及驗證概覽。當有提供者使用量快照時，OAuth/token 狀態區段會包含提供者使用量標頭。加上 --probe 可對每個已設定的提供者設定檔進行即時驗證探測。探測是真實的請求（可能消耗 token 並觸發速率限制）。使用 --agent <id> 可檢視已設定代理的模型/驗證狀態。未指定時，指令會使用 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR（若有設定），否則使用預設代理。

注意事項：

models set <model-or-alias> 接受 provider/model 或別名。
模型參照以第一個 / 為分隔符進行解析。若模型 ID 包含 /（OpenRouter 格式），需加上提供者前綴（例如：openrouter/moonshotai/kimi-k2）。
省略提供者時，OpenClaw 會將輸入視為別名或預設提供者的模型（僅在模型 ID 不含 / 時有效）。
models status 可能會在驗證輸出中顯示 marker(<value>)，用於非機密的佔位值（例如 OPENAI_API_KEY、secretref-managed、minimax-oauth、qwen-oauth、ollama-local），而非將其遮蔽為機密。

`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 政策說明：setup-token 支援屬於技術相容性。Anthropic 過去曾限制部分訂閱在 Claude Code 以外的使用，因此在廣泛使用前請確認目前的條款。