驗證¶
OpenClaw 支援模型提供者的 OAuth 與 API 金鑰。對於 Anthropic
帳戶，我們建議使用 API 金鑰。若要存取 Claude 訂閱，
請使用由 claude setup-token 建立的長效權杖。 For Anthropic
accounts, we recommend using an API key. For Claude subscription access,
use the long‑lived token created by claude setup-token.
完整的 OAuth 流程與儲存配置，請參閱 /concepts/oauth。
建議的 Anthropic 設定（API 金鑰）¶
若您直接使用 Anthropic，請使用 API 金鑰。
- 在 Anthropic Console 建立一個 API 金鑰。
- 將它放在 Gateway 閘道器主機（執行
openclaw gateway的機器）上。
export ANTHROPIC_API_KEY="..."
openclaw models status
- 若 Gateway 在 systemd／launchd 下執行，建議將金鑰放在
~/.openclaw/.env，以便常駐程式可讀取：
cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF
接著重新啟動常駐程式（或重新啟動您的 Gateway 程序）並再次檢查：
openclaw models status
openclaw doctor
如果您不想自行管理環境變數，入門精靈可以儲存
API keys for daemon use: openclaw onboard.
關於環境變數繼承（env.shellEnv、~/.openclaw/.env、systemd／launchd）的詳細資訊，請參閱 Help。
Anthropic：setup-token（訂閱身分驗證）¶
對於 Anthropic，建議使用 API key。如果您正在使用 Claude subscription, the setup-token flow is also supported. Run it on the gateway host:
claude setup-token
接著將其貼到 OpenClaw：
openclaw models auth setup-token --provider anthropic
若權杖是在另一台機器上建立，請手動貼上：
openclaw models auth paste-token --provider anthropic
若您看到如下的 Anthropic 錯誤：
This credential is only authorized for use with Claude Code and cannot be used for other API requests.
……請改用 Anthropic API 金鑰。
手動輸入權杖（任何提供者；寫入 auth-profiles.json 並更新設定）：
openclaw models auth paste-token --provider anthropic
openclaw models auth paste-token --provider openrouter
自動化友善的檢查（到期／缺失時以 1 結束，將到期時以 2 結束）：
openclaw models status --check
選用的營運腳本（systemd／Termux）文件在此： /automation/auth-monitoring
claude setup-token需要互動式 TTY。
檢查模型身分驗證狀態¶
openclaw models status
openclaw doctor
控制使用哪一個憑證¶
依工作階段（聊天指令）¶
使用 /model <alias-or-id>@<profileId> 為目前工作階段固定特定提供者的憑證（範例設定檔 ID：anthropic:default、anthropic:work）。
使用 /model（或 /model list）取得精簡選擇器；使用 /model status 取得完整檢視（候選項目 + 下一個身分驗證設定檔，並在已設定時顯示提供者端點細節）。
依代理程式（CLI 覆寫）¶
為代理程式設定明確的身分驗證設定檔排序覆寫（儲存在該代理程式的 auth-profiles.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> 指定特定代理程式；省略則使用已設定的預設代理程式。
疑難排解¶
「找不到任何憑證」¶
若缺少 Anthropic 權杖設定檔，請在
Gateway 閘道器主機 上執行 claude setup-token，然後再次檢查：
openclaw models status
權杖即將過期／已過期¶
執行 openclaw models status 以確認哪個設定檔即將過期。如果該設定檔
is missing, rerun claude setup-token and paste the token again.
需求¶
- Claude Max 或 Pro 訂閱（用於
claude setup-token） - 已安裝 Claude Code CLI（可使用
claude指令）