驗證

OpenClaw 支援模型供應商的 OAuth 和 API 金鑰。對於永久運作的閘道主機，API 金鑰通常是最可預期的選項。當訂閱/OAuth 流程符合您的供應商帳戶模型時，也一併支援。

完整的 OAuth 流程與儲存佈局，請參閱 /concepts/oauth。關於基於 SecretRef 的驗證（env/file/exec 提供者），請參閱 Secrets Management。關於 models status --probe 所使用的憑證資格/原因代碼規則，請參閱 Auth Credential Semantics。

Anthropic：Claude CLI 和權杖相容性

Anthropic 設定權杖驗證在 OpenClaw 中作為支援的權杖路徑仍然可用。Anthropic 人員隨後告訴我們，OpenClaw 風格的 Claude CLI 使用再次被允許，因此除非 Anthropic 發布新政策，否則 OpenClaw 將 Claude CLI 重複使用和 claude -p 使用視為此整合的授權行為。當主機上提供 Claude CLI 重複使用時，這現在是首選路徑。

對於長期運行的閘道主機，Anthropic API 金鑰仍然是最可預測的設定。如果您想在同一台主機上重複使用現有的 Claude 登入，請在 onboarding/configure 中使用 Anthropic Claude CLI 路徑。

針對 Claude CLI 重複使用的建議主機設定：

# Run on the gateway host
claude auth login
claude auth status --text
openclaw models auth login --provider anthropic --method cli --set-default

這是一個兩步驟的設定：

在閘道主機上將 Claude Code 本身登入 Anthropic。
告訴 OpenClaw 將 Anthropic 模型選擇切換到本地 claude-cli 後端，並儲存對應的 OpenClaw 認證設定檔。

如果 claude 不在 PATH 上，請先安裝 Claude Code 或將 agents.defaults.cliBackends.claude-cli.command 設定為實際的二元檔路徑。

手動輸入權杖（任何提供者；寫入 auth-profiles.json 並更新設定）：

openclaw models auth paste-token --provider openrouter

auth-profiles.json 僅儲存認證資訊。標準格式如下：

{
  "version": 1,
  "profiles": {
    "openrouter:default": {
      "type": "api_key",
      "provider": "openrouter",
      "key": "OPENROUTER_API_KEY"
    }
  }
}

OpenClaw 在執行時期期望標準的 version + profiles 格式。如果較舊的安裝版本仍有諸如 { "openrouter": { "apiKey": "..." } } 的扁平檔案，請執行 openclaw doctor --fix 將其重寫為 openrouter:default API 金鑰設定檔；doctor 會在原始檔案旁保留一份 .legacy-flat.*.bak 副本。端點詳細資訊（如 baseUrl、api、模型 ID、標頭和逾時設定）應屬於 openclaw.json 或 models.json 中的 models.providers.<id> 之下，而不是在 auth-profiles.json 中。

外部認證路由（例如 Bedrock auth: "aws-sdk"）也不是認證資訊。如果您想要一個命名的 Bedrock 路由，請將 auth.profiles.<id>.mode: "aws-sdk" 放在 openclaw.json 中；不要將 type: "aws-sdk" 寫入 auth-profiles.json。openclaw doctor --fix 會將舊版 AWS SDK 標記從認證儲存區移至設定元資料中。

靜態認證也支援認證設定檔參照：

api_key 認證可以使用 keyRef: { source, provider, id }
token 認證可以使用 tokenRef: { source, provider, id }
OAuth 模式設定檔不支援 SecretRef 認證；如果 auth.profiles.<id>.mode 設定為 "oauth"，該設定檔的 SecretRef 支援 keyRef/tokenRef 輸入將會被拒絕。

自動化友善檢查（當過期/遺失時退出碼為 1，即將過期時為 2）：

openclaw models status --check

即時認證探測：

openclaw models status --probe

注意：

探測列可以來自認證設定檔、環境憑證，或 models.json。
如果明確的 auth.order.<provider> 省略了已儲存的設定檔，探測會針對該設定檔回報 excluded_by_auth_order，而不是嘗試使用它。
如果認證存在，但 OpenClaw 無法解析該提供者的可探測模型候選，探測會回報 status: no_model。
速率限制冷卻時間可以範圍限定於模型。針對某個模型正在冷卻的設定檔，對於同一提供者上的兄弟模型仍然可用。

此處記錄了選用的維運腳本（systemd/Termux）： Auth monitoring scripts

Anthropic 說明

再次支援 Anthropic claude-cli 後端。

Anthropic 人員告訴我們，此 OpenClaw 整合路徑再次被允許。
因此，除非 Anthropic 發布新政策，否則 OpenClaw 將 Claude CLI 重用和 claude -p 使用視為對 Anthropic 支援的運行是經認可的。
對於長期運行的閘道主機和明確的伺服器端計費控制，Anthropic API 金鑰仍然是最可預測的選擇。

檢查模型認證狀態

openclaw models status
openclaw doctor

API 金鑰輪替行為 (閘道)

當 API 呼叫遇到提供者速率限制時，部分提供者支援使用替代金鑰重試請求。

優先順序：
- OPENCLAW_LIVE_<PROVIDER>_KEY (單次覆寫)
- <PROVIDER>_API_KEYS
- <PROVIDER>_API_KEY
- <PROVIDER>_API_KEY_*
Google 提供者還包括 GOOGLE_API_KEY 作為額外的後備。
相同的金鑰清單在使用前會進行去重。
OpenClaw 僅針對速率限制錯誤 (例如 429、rate_limit、quota、resource exhausted、Too many concurrent requests, ThrottlingException, concurrency limit reached，或 workers_ai ... quota limit exceeded) 才會使用下一個金鑰重試。
非速率限制錯誤不會使用替代金鑰重試。
如果所有金鑰都失敗，將傳回最後一次嘗試的最終錯誤。

在閘道執行時移除提供者驗證

當透過 Gateway 控制平面移除提供者驗證時，OpenClaw 會刪除該提供者已儲存的驗證設定檔，並中止作用中的聊天或代理執行（若其選取的模型提供者符合被移除的提供者）。被中止的執行會發出一般的聊天取消與生命週期事件，並附帶 stopReason: "auth-revoked"，因此連線的用戶端可以顯示該執行是因為憑證被移除而停止。

移除已儲存的驗證並不會在提供者端撤銷金鑰。當您需要在提供者端使其失效時，請在提供者儀表板中輪替或撤銷金鑰。

控制使用哪個憑證

每次工作階段（聊天指令）

使用 /model <alias-or-id>@<profileId> 釘選特定的提供者憑證給目前的工作階段（範例設定檔 ID：anthropic:default、anthropic:work）。

使用 /model（或 /model list）以取得精簡選擇器；使用 /model status 以取得完整檢視（候選者 + 下個驗證設定檔，並在設定時包含提供者端點詳細資訊）。

每個代理（CLI 覆寫）

為代理設定明確的認證設定檔順序覆寫（儲存在該代理的 auth-state.json 中）：

openclaw models auth order get --provider anthropic
openclaw models auth order set --provider anthropic anthropic:default
openclaw models auth order clear --provider anthropic

使用 --agent <id> 指定特定的代理；省略它則使用設定的預設代理。當您調試順序問題時，openclaw models status --probe 會將省略的儲存設定檔顯示為 excluded_by_auth_order，而不是靜默地跳過它們。當您調試冷卻問題時，請記住速率限制冷卻可能綁定到一個模型 ID，而不是整個供應商設定檔。

故障排除

”找不到憑證”

如果缺少 Anthropic 設定檔，請在 gateway 主機 上設定 Anthropic API 金鑰或設定 Anthropic setup-token 路徑，然後重新檢查：

openclaw models status

Token 即將過期/已過期

執行 openclaw models status 以確認哪個設定檔即將過期。如果 Anthropic token 設定檔遺失或已過期，請透過 setup-token 重新整理該設定或遷移至 Anthropic API 金鑰。

驗證

推薦設定（API 金鑰，任何供應商）