跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Anthropic 建構 Claude 模型系列。OpenClaw 支援兩種驗證路徑：
  • API 金鑰 — 直接存取 Anthropic API，並依用量計費（anthropic/* 模型）
  • Claude CLI — 在同一台主機上重用既有的 Claude CLI 登入
Anthropic 工作人員告訴我們，OpenClaw 風格的 Claude CLI 使用方式已再次被允許，因此 OpenClaw 會將 Claude CLI 重用和 claude -p 使用方式視為已獲准，除非 Anthropic 發布新政策。對於長期運作的 Gateway 主機，Anthropic API 金鑰仍然是最清楚且 最可預測的正式環境路徑。Anthropic 目前的公開文件：

​
開始使用

**最適合：**標準 API 存取與依用量計費。
1

取得你的 API 金鑰

在 Anthropic Console 建立 API 金鑰。
2

執行初始設定

openclaw onboard
# choose: Anthropic API key
或直接傳入金鑰：
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

確認模型可用

openclaw models list --provider anthropic

​
設定範例

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

​
思考預設值（Claude 4.6）

在 OpenClaw 中，Claude 4.6 模型在未設定明確思考層級時，預設使用 adaptive 思考。 使用 /think:<level> 逐訊息覆寫，或在模型參數中設定： 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
相關 Anthropic 文件：

​
提示快取

OpenClaw 支援 Anthropic 的提示快取功能，用於 API 金鑰驗證。
值快取期間說明
"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" } },
    ],
  },
}
設定合併順序：
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params（符合的 id，依鍵覆寫）
這讓一個代理程式可保留長效快取，同時另一個使用相同模型的代理程式可針對突發/低重用流量停用快取。
  • Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在設定後接受 cacheRetention 直通。
  • 非 Anthropic 的 Bedrock 模型會在執行階段被強制設為 cacheRetention: "none"。
  • API 金鑰智慧預設值也會在未設定明確值時，為 Claude-on-Bedrock refs 預植 cacheRetention: "short"。

​
進階設定

OpenClaw 的共用 /fast 切換支援直接 Anthropic 流量（API 金鑰和 OAuth 至 api.anthropic.com）。
指令對應至
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • 只會注入到直接 api.anthropic.com 請求。Proxy 路徑會讓 service_tier 保持不變。
  • 明確的 serviceTier 或 service_tier 參數會在兩者皆設定時覆寫 /fast。
  • 對於沒有 Priority Tier 容量的帳戶，service_tier: "auto" 可能會解析為 standard。
隨附的 Anthropic plugin 會註冊圖片和 PDF 理解。OpenClaw 會從已設定的 Anthropic 驗證自動解析媒體能力，不需要 額外設定。
屬性值
預設模型claude-opus-4-7
支援的輸入圖片、PDF 文件
當圖片或 PDF 附加到對話時，OpenClaw 會自動 透過 Anthropic 媒體理解提供者進行路由。
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 也會套用至符合資格的 Opus 和 Sonnet 模型的 Claude CLI 後端 （claude-cli/*），將這些 CLI 工作階段的執行階段 上下文視窗擴展為與直接 API 行為相同。
需要你的 Anthropic 憑證具備長上下文存取權。舊版權杖驗證（sk-ant-oat-*）會被 1M 上下文請求拒絕，OpenClaw 會記錄警告並退回標準上下文視窗。
anthropic/claude-opus-4.7 及其 claude-cli 變體預設具備 1M 上下文 視窗，不需要 params.context1m: true。

​
疑難排解

Anthropic 權杖驗證會過期且可能被撤銷。對於新的設定，請改用 Anthropic API 金鑰。
Anthropic 驗證是每個代理程式各自設定，新的代理程式不會繼承主要代理程式的金鑰。請為該代理程式重新執行初始設定（或在 Gateway 主機上設定 API 金鑰），然後使用 openclaw models status 驗證。
執行 openclaw models status 查看目前作用中的驗證設定檔。重新執行初始設定，或為該設定檔路徑設定 API 金鑰。
檢查 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 速率限制冷卻可能以模型為範圍，因此同屬 Anthropic 的另一個模型可能仍可使用。新增另一個 Anthropic 設定檔或等待冷卻。
更多協助：疑難排解 和 FAQ。

​
相關

模型選擇

選擇提供者、模型 refs 和容錯移轉行為。

CLI 後端

Claude CLI 後端設定與執行階段詳細資訊。

提示快取

提示快取如何跨提供者運作。

OAuth 和驗證

驗證詳細資訊與憑證重用規則。