管理 OpenClaw 模型與認證設定

你有沒有遇過這種情況？剛拿到一個新的開發工具，光是設定不同供應商的 API key 就搞得頭大，更別提要頻繁切換模型或是確認目前的認證到底有沒有過期。手動修改設定檔既麻煩又容易出錯，你其實需要一個更直覺的方式來控管這些 AI 資源。

需要準備的東西

已安裝的 Provider plugins (可透過 openclaw plugins list 確認)
供應商提供的 API key 或 OAuth 帳號
已配置的 Agent 目錄 (預設或透過 OPENCLAW_AGENT_DIR / PI_CODING_AGENT_DIR 環境變數指定)

快速開始

要管理你的模型與認證，最快的方法是直接使用 openclaw models 相關指令。這幾個動作能幫你完成 90% 的日常設定：

# 查看目前的模型狀態與認證概況
openclaw models status

# 列出所有可用的模型
openclaw models list

# 設定預設模型 (支援 provider/model 格式或別名)
openclaw models set <model-or-alias>

# 掃描並自動發現可用的新模型
openclaw models scan

如果你想確認目前的認證是否真的有效，可以加上 --probe 參數進行實測：

# 對所有已設定的供應商進行即時認證測試
openclaw models status --probe

小提示：

當你設定模型時，如果模型 ID 本身包含 / (例如 OpenRouter 的模型)，請務必加上 provider 前綴，像是 openrouter/moonshotai/kimi-k2。
如果省略 provider，OpenClaw 會將其視為別名或預設供應商的模型。

認證設定

除了手動編輯，你也可以透過 CLI 互動式完成認證：

# 執行供應商的認證流程 (OAuth 或 API key)
openclaw models auth login --provider <id>

# 貼上從其他地方產生的 setup-token
openclaw models auth paste-token

疑難排解

認證失敗或過期

如果你懷疑 token 出問題，可以使用 --check 旗標。當回傳值為 1 時表示認證已過期或缺失，2 則表示即將過期：

openclaw models status --check

探測 (Probe) 逾時或限制

執行 --probe 時會發送真實的 API 請求，這可能會消耗你的 token 並觸發 rate limits。如果遇到逾時，可以調整參數：

openclaw models status --probe --probe-timeout 5000 --probe-concurrency 2

Anthropic 政策限制

雖然 OpenClaw 在技術上支援 Anthropic 的 setup-token，但請留意 Anthropic 過去曾阻擋過 Claude Code 以外的訂閱用途。在廣泛使用前，建議先確認目前的服務條款。

如果你在設定過程中遇到任何問題，可以詢問 AI Setup Assistant 獲取即時幫助。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。