Anthropic

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

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

Warning

OpenClaw 的 Claude CLI 後端會以非互動式列印模式執行已安裝的 Claude Code CLI。Anthropic 目前的 Claude Code 文件將 claude -p 描述為 Agent SDK/程式化用途。自 2026 年 6 月 15 日起，Anthropic 表示訂閱方案的 claude -p 使用量將不再從一般 Claude 方案額度中扣除；而是先從每月的 Agent SDK 點數扣除，當這些點數用盡後，再以標準 API 費率從使用量點數扣除。

互動式 Claude Code 仍然會從已登入的 Claude 方案額度中扣除。API 金鑰驗證則維持直接按用量計費的 API 帳單。對於長期運作的閘道主機、共用自動化以及可預測的生產環境支出，請使用 Anthropic API 金鑰。

Anthropic 目前的公開文件：

開始使用

最適用於： 標準 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: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

最適用於： 重複使用現有的 Claude CLI 登入，而不需要額外的 API 金鑰。

確保 Claude CLI 已安裝並登入
使用以下指令驗證：
Terminal window
```
claude --version
```
執行入門設定
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-8" },
      models: {
        "anthropic/claude-opus-4-8": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

舊版的 claude-cli/claude-opus-4-7 模型參照仍可運作以維持相容性，但新設定應將供應商/模型選項維持為 anthropic/*，並將執行後端置於供應商/模型執行時策略中。

計費與 `claude -p`

OpenClaw 使用 Claude Code 的非互動式 claude -p 路徑來執行 Claude CLI。 Anthropic 目前將該路徑視為 Agent SDK/程式化用途：

直到 2026 年 6 月 15 日，訂閱方案處理方式遵循 Anthropic 針對已登入帳戶的現行 Claude Code 規則。
從 2026 年 6 月 15 日開始，訂閱方案的 claude -p 使用量會優先從使用者的每月 Agent SDK 點數扣除，若啟用使用量點數，接著再從標準 API 費率的使用量點數扣除。
Console/API 金鑰登入使用隨付隨用的 API 計費，且不會收到訂閱 Agent SDK 點數。

Anthropic 可在無需 OpenClaw 發布版的情況下變更 Claude Code 的計費與速率限制行為。當計費可預測性很重要時，請查閱 claude auth status、/status 以及 Anthropic 的連結文件。

思維預設值 (Claude 4.8 和 4.6)

Claude Opus 4.8 在 OpenClaw 中預設會關閉思維功能。當您使用 /think high|xhigh|max 明確啟用適應性思維時，OpenClaw 會發送 Anthropic Opus 4.8 的 effort 值；Claude 4.6 模型預設為 adaptive。

透過 /think:<level> 或在模型參數中逐則訊息覆蓋：

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

提示快取

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 金鑰智慧預設值也會在未設定明確值時，為 Claude-on-Bedrock 參照填入 cacheRetention: "short"。

進階設定

Fast mode

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 },
        },
      },
    },
  },
}

Media understanding (image and PDF)

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

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

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

1M context window

Anthropic 的 1M context window 可在支援 GA 的 Claude 4.x 模型上使用，例如 Opus 4.8、Opus 4.7、Opus 4.6 和 Sonnet 4.6。OpenClaw 會自動將這些模型的 context window 大小設為 1M：

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

較舊的設定可以保留 params.context1m: true，但 OpenClaw 不再發送已停用的 context-1m-2025-08-07 beta 標頭。含有該值的舊 anthropicBeta 設定項目在請求標頭解析時會被忽略，且不支援的舊版 Claude 模型會維持其標準 context window。

params.context1m: true 也適用於 Claude CLI 後端 (claude-cli/*)，針對符合資格的支援 GA 的 Opus 和 Sonnet 模型，為這些 CLI 會話保留執行時期的 context window，以符合直接 API 的行為。

Claude Opus 4.8 1M context

anthropic/claude-opus-4-8 及其 claude-cli 變體預設擁有 1M context window — 不需要 params.context1m: true。

疑難排解

401 錯誤 / token 突然失效

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

No API key found for provider "anthropic"

Anthropic 驗證是每個 Agent — 新的 Agent 不會繼承主要 Agent 的金鑰。請為該 Agent 重新執行入門設定（或在 gateway 主機上設定 API 金鑰），然後使用 openclaw models status 進行驗證。

No credentials found for profile "anthropic:default"

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

無可用的設定檔（全部冷卻中）

檢查 openclaw models status --json 的 auth.unusableProfiles。Anthropic 的速率限制冷卻可能僅限於特定模型，因此同系列的其他 Anthropic 模型可能仍可使用。請新增另一個 Anthropic 設定檔或等待冷卻結束。

Anthropic

開始使用

設定範例

設定範例

計費與 claude -p

思維預設值 (Claude 4.8 和 4.6)

提示快取

進階設定

疑難排解

相關

計費與 `claude -p`