Anthropic

Anthropic 建構了 Claude 模型系列。OpenClaw 支援兩種驗證方式：

API 金鑰 — 直接存取 Anthropic API 並依使用量計費 (anthropic/* 模型)
Claude CLI — 重複使用同一台主機上既有的 Claude CLI 登入

開始使用

最適合用於： 標準 API 存取和依使用量計費。

取得您的 API 金鑰
在 Anthropic Console 中建立 API 金鑰。

執行入門引導

openclaw onboard
# choose: Anthropic API key

或直接傳入金鑰：

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

驗證模型可用性

openclaw models list --provider anthropic

設定範例

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

最適合： 重用現有的 Claude CLI 登入，而無需額外的 API 金鑰。

確保已安裝並登入 Claude CLI
使用以下指令驗證：
Terminal window
```
claude --version
```
執行 onboarding
Terminal window
```
openclaw onboard
# choose: Claude CLI
```
OpenClaw 會偵測並重用現有的 Claude CLI 憑證。

驗證模型是否可用

openclaw models list --provider anthropic

設定範例

建議使用標準的 Anthropic 模型參照加上 CLI 執行時期覆寫：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

舊版 claude-cli/claude-opus-4-7 模型參照為了相容性仍然可以使用，但新設定應將供應商/模型選擇維持為 anthropic/*，並將執行後端放在供應商/模型執行時期原則中。

思考預設值 (Claude 4.6)

當未設定明確的思考層級時，Claude 4.6 模型在 OpenClaw 中預設為 adaptive 思考。

使用 /think:<level> 或在模型參數中針對每則訊息進行覆寫：

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

提示快取

OpenClaw 支援針對 API 金鑰驗證的 Anthropic 提示快取功能。

值	快取持續時間	說明
`"short"` (預設)	5 分鐘	針對 API 金鑰驗證自動套用
`"long"`	1 小時	延伸快取
`"none"`	不快取	停用提示快取

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

各代理快取覆寫

使用模型層級參數作為基準，然後透過 agents.list[].params 覆寫特定代理：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } },
    ],
  },
}

配置合併順序：

agents.defaults.models["provider/model"].params
agents.list[].params（比對 id，按鍵覆寫）

這讓一個代理可以維持長效快取，而使用相同模型的另一個代理則可針對突發性/低重用流量停用快取。

Bedrock Claude 備註

Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在配置時接受 cacheRetention 傳遞。
非 Anthropic 的 Bedrock 模型在執行時會被強制設為 cacheRetention: "none"。
當未設定明確值時，API 金鑰智慧預設值也會為 Bedrock 上的 Claude 參照植入 cacheRetention: "short"。

進階設定

快速模式

OpenClaw 的共用 /fast 切換開關支援直接 Anthropic 流量（API 金鑰與 OAuth 至 api.anthropic.com）。

指令	對應至
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

媒體理解 (圖片和 PDF)

內建的 Anthropic 外掛註冊了圖片和 PDF 理解功能。OpenClaw 會從設定的 Anthropic 驗證自動解析媒體功能 — 不需要額外的設定。

屬性	值
預設模型	`claude-opus-4-7`
支援的輸入	圖片、PDF 文件

當圖片或 PDF 附加到對話時，OpenClaw 會自動將其路由透過 Anthropic 媒體理解提供者。

1M 上下文視窗 (beta)

Anthropic 的 1M 上下文視窗處於 beta 階段。請針對每個模型啟用它：

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

OpenClaw 會在請求時將其對應到 anthropic-beta: context-1m-2025-08-07。

params.context1m: true 也適用於 Claude CLI 後端 (claude-cli/*)，針對符合資格的 Opus 和 Sonnet 模型，擴展這些 CLI 會話的執行時上下文視窗以符合直接 API 的行為。

Claude Opus 4.7 1M 上下文

anthropic/claude-opus-4.7 及其 claude-cli 變體預設具有 1M 上下文視窗 — 不需要 params.context1m: true。

疑難排解

401 錯誤 / token 突然失效

Anthropic token 驗證會過期且可能被撤銷。對於新設定，請改用 Anthropic API 金鑰。

未找到提供者 "anthropic" 的 API 金鑰

Anthropic 驗證是 針對每個代理程式 的 — 新的代理程式不會繼承主要代理程式的金鑰。請為該代理程式重新執行入門設定 (或在閘道主機上設定 API 金鑰)，然後使用 openclaw models status 進行驗證。

未找到設定檔 "anthropic:default" 的憑證

執行 openclaw models status 以查看目前啟用的驗證設定檔。請重新執行入門設定，或為該設定檔路徑設定 API 金鑰。

沒有可用的驗證設定檔（全部皆在冷卻中）

檢查 openclaw models status --json 以取得 auth.unusableProfiles。Anthropic 的速率限制冷卻時間可能以模型為範圍，因此同層級的 Anthropic 模型可能仍可使用。新增另一個 Anthropic 設定檔或等待冷卻。