Anthropic（Claude）¶

Anthropic 建構 Claude 模型家族，並透過 API 提供存取。 在 OpenClaw 中，你可以使用 API 金鑰或 setup-token 進行身分驗證。 In OpenClaw you can authenticate with an API key or a setup-token.

選項 A：Anthropic API 金鑰¶

Best for: standard API access and usage-based billing. 最適合： 標準 API 存取與依用量計費。 請在 Anthropic Console 建立你的 API 金鑰。

CLI 設定¶

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

設定片段¶

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

提示詞快取（Anthropic API）¶

OpenClaw 支援 Anthropic 的提示快取功能。此功能僅限 API 使用；訂閱驗證不會套用快取設定。

設定¶

在你的模型設定中使用 cacheRetention 參數：

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

預設值¶

使用 Anthropic API 金鑰驗證時，OpenClaw 會自動為所有 Anthropic 模型套用 cacheRetention: "short"（5 分鐘快取）。你可以在設定中明確設定 cacheRetention 以覆寫此行為。 You can override this by explicitly setting cacheRetention in your config.

舊版參數¶

較舊的 cacheControlTtl 參數仍支援以維持向後相容性：

• "5m" 對應至 short
• "1h" 對應至 long

我們建議遷移至新的 cacheRetention 參數。

OpenClaw 在 Anthropic API 請求中包含 extended-cache-ttl-2025-04-11 beta 旗標；若你覆寫提供者標頭，請保留它（參見 /gateway/configuration）。

選項 B：Claude setup-token¶

最適合： 使用你的 Claude 訂閱。

取得 setup-token 的位置¶

Setup-token 由 Claude Code CLI 建立，而非 Anthropic Console。你可以在 任何機器 上執行： You can run this on any machine:

claude setup-token

將權杖貼到 OpenClaw（精靈：Anthropic token（貼上 setup-token）），或在閘道器主機上執行：

openclaw models auth setup-token --provider anthropic

如果你在不同的機器上產生了權杖，請貼上它：

openclaw models auth paste-token --provider anthropic

CLI 設定（setup-token）¶

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

設定片段（setup-token）¶

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

注意事項¶

• 使用 claude setup-token 產生 setup-token 並貼上，或在閘道器主機上執行 openclaw models auth setup-token。
• If you see “OAuth token refresh failed …” on a Claude subscription, re-auth with a setup-token. 若在 Claude 訂閱中看到「OAuth token refresh failed …」，請使用 setup-token 重新驗證。請參閱 /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription。
• 驗證細節與重用規則請見 /concepts/oauth。

疑難排解¶

401 錯誤／權杖突然失效

• Claude 訂閱驗證可能會過期或被撤銷。請重新執行 claude setup-token and paste it into the gateway host.
• 若 Claude CLI 登入存在於不同的機器上，請在閘道器主機上使用 openclaw models auth paste-token --provider anthropic。

找不到提供者「anthropic」的 API 金鑰

• Auth is per agent. New agents don’t inherit the main agent’s keys.
• 重新為該代理程式執行入門引導，或在閘道器主機上貼上 setup-token／API 金鑰，然後使用 openclaw models status 驗證。

找不到設定檔 anthropic:default 的認證

• 執行 openclaw models status 以查看目前啟用的驗證設定檔。
• Re-run onboarding, or paste a setup-token / API key for that profile.

No available auth profile (all in cooldown/unavailable)

• 檢查 openclaw models status --json 是否為 auth.unusableProfiles。
• 新增另一個 Anthropic 設定檔，或等待冷卻結束。

更多內容：/gateway/troubleshooting 與 /help/faq。