跳轉到主要內容

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

​
思考預設值（Claude 4.6）

當未設定明確的思考層級時，Claude 4.6 模型在 OpenClaw 中預設使用 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 金鑰智慧預設值也會為 Bedrock 上的 Claude 參照填入 cacheRetention: "short"。

​
進階設定

OpenClaw 的共用 /fast 切換支援直接 Anthropic 流量（API 金鑰與連到 api.anthropic.com 的 OAuth）。
指令對應至
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • 只會注入到直接 api.anthropic.com 請求。代理路由會讓 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 也會套用到 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 驗證是每個代理各自設定，新的代理不會繼承主要代理的金鑰。請為該代理重新執行導覽設定（或在 Gateway 主機上設定 API 金鑰），然後使用 openclaw models status 確認。
執行 openclaw models status 以查看目前使用中的驗證設定檔。重新執行導覽設定，或為該設定檔路徑設定 API 金鑰。
查看 openclaw models status --json 中的 auth.unusableProfiles。Anthropic 速率限制冷卻可能是以模型為範圍，因此同層的 Anthropic 模型可能仍可使用。新增另一個 Anthropic 設定檔，或等待冷卻結束。
更多說明：疑難排解 與 常見問題。

​
相關內容

模型選擇

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

CLI 後端

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

提示快取

提示快取如何跨供應商運作。

OAuth 與驗證

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