跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.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" } } },
}

​
Thinking 預設值（Claude 4.6）

當未設定明確的 Thinking 層級時，Claude 4.6 模型在 OpenClaw 中預設為 adaptive thinking。 可使用 /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 覆寫特定 agent：
{
  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，依鍵覆寫）
這可讓同一個模型上的某個 agent 保持長期快取，同時讓另一個 agent 對突發性/低重用流量停用快取。
  • Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在設定後會接受 cacheRetention 透傳。
  • 非 Anthropic 的 Bedrock 模型會在執行階段被強制設為 cacheRetention: "none"。
  • 當未設定明確值時，API 金鑰智慧預設值也會為 Claude-on-Bedrock 參照植入 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-6
支援的輸入圖片、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 也會套用至 Claude CLI 後端 （claude-cli/*）中符合資格的 Opus 與 Sonnet 模型，將這些 CLI 工作階段的執行階段 上下文視窗擴展為與直接 API 行為一致。
需要你的 Anthropic 憑證具備長上下文存取權。舊版權杖驗證（sk-ant-oat-*）會被 1M 上下文請求拒絕，OpenClaw 會記錄警告並退回標準上下文視窗。
anthropic/claude-opus-4.7 及其 claude-cli 變體預設具備 1M 上下文 視窗，不需要 params.context1m: true。

​
疑難排解

Anthropic 權杖驗證會過期，也可能被撤銷。對於新的設定，請改用 Anthropic API 金鑰。
Anthropic 驗證是依 agent 而定，新的 agent 不會繼承主要 agent 的金鑰。請為該 agent 重新執行初始設定（或在 gateway 主機上設定 API 金鑰），然後使用 openclaw models status 驗證。
執行 openclaw models status 查看目前啟用的驗證 profile。請重新執行初始設定，或為該 profile 路徑設定 API 金鑰。
檢查 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 速率限制冷卻可能以模型為範圍，因此同層級的 Anthropic 模型可能仍可使用。新增另一個 Anthropic profile，或等待冷卻結束。
更多協助：疑難排解 和 常見問題。

​
相關

模型選擇

選擇供應商、模型參照與容錯移轉行為。

CLI 後端

Claude CLI 後端設定與執行階段細節。

提示快取

提示快取在各供應商之間如何運作。

OAuth 與驗證

驗證細節與憑證重用規則。