如何搞定 OpenClaw 的身份驗證：API Key 與 Token 設定指南

每次換新工具最煩的就是處理 API Key 和身份驗證。有時候要把 Key 貼進環境變數，有時候又要處理會過期的 Token，如果還要同時切換公司和私人帳號，那真的是一場災難。

我們都希望這些設定能一次搞定，然後就再也不用去理它，把時間花在真正的開發工作上。OpenClaw 提供了幾種方式來處理這些瑣事，這篇會幫你快速理清最推薦的設定路徑。

需要準備的東西

Claude Max 或 Pro 訂閱（如果你打算使用 claude setup-token）
已安裝 Claude Code CLI（確保 claude 指令可以執行）

快速開始

OpenClaw 支援 OAuth 和 API Key。針對 Anthropic 帳號，我強烈建議直接使用 API Key，這是最穩定的做法。

1. 使用 API Key（推薦方案）

在 Anthropic Console 建立一組 API Key。
在執行 openclaw gateway 的那台機器（Gateway host）上設定環境變數：

export ANTHROPIC_API_KEY="..."
openclaw models status

如果你的 Gateway 是透過 systemd 或 launchd 跑的背景服務，建議把 Key 寫入 ~/.openclaw/.env，這樣服務才讀得到：

cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

設定完後重啟 Gateway 進程，並執行 openclaw doctor 確認狀態。如果你不想手動改檔案，也可以用 openclaw onboard 互動式引導來儲存 Key。

2. 使用 Claude 訂閱 Token

如果你是用 Claude Pro 訂閱而非 API 帳號，請在 Gateway 主機 執行：

claude setup-token

接著把產生的 Token 貼進 OpenClaw：

openclaw models auth setup-token --provider anthropic

如果你在執行時看到「This credential is only authorized for use with Claude Code」這類錯誤，代表該憑證被限制了，這時候請換回 API Key 方案。

管理多組憑證

當你有多個帳號（例如公司和私人）時，你可以靈活控制要用哪一組。

在對話中切換

在 Chat 介面使用 /model <alias-or-id>@<profileId> 來固定目前 session 的憑證。例如：

/model claude-3-5-sonnet@anthropic:default
/model claude-3-5-sonnet@anthropic:work

你可以輸入 /model 或 /model list 開啟簡易挑選器，或是用 /model status 查看詳細的端點資訊。

設定 Agent 優先順序

你可以針對特定的 Agent 設定憑證使用順序：

# 查看目前的順序
openclaw models auth order get --provider anthropic

# 設定優先使用 default 設定檔
openclaw models auth order set --provider anthropic anthropic:default

# 清除設定
openclaw models auth order clear --provider anthropic

疑難排解

出現「No credentials found」

如果找不到 Anthropic 的設定檔，請在 Gateway 主機 重新執行 claude setup-token，然後用 openclaw models status 檢查。

Token 即將過期或已過期

執行 openclaw models status 確認是哪一個 profile 出問題。如果是 Token 過期，請重新執行 claude setup-token 並再次貼上新 Token。

如果你需要自動化監控，可以執行 openclaw models status --check，當 Token 過期時它會回傳 exit code 1。

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

下一步

OpenClaw Expert

還是卡住了？

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