Anthropic

Anthropic 建構 Claude 模型系列。OpenClaw 支援兩種驗證途徑：

• API 金鑰 - 直接存取 Anthropic API，採用量計費（anthropic/* 模型）
• Claude CLI - 重複使用同一主機上現有的 Claude Code 登入

​

用量與成本追蹤

OpenClaw 會偵測可用的 Anthropic 認證資訊，並選取相符的用量介面：

• Claude 訂閱／設定認證資訊會顯示配額週期與選用的額外用量預算。
• ANTHROPIC_ADMIN_KEY 或 ANTHROPIC_ADMIN_API_KEY 會在 Control UI 的 用量 中顯示供應商回報的 30 天組織成本與 Messages API 用量，包括每日支出、權杖／快取總計、最常用模型與成本類別。
• 儲存在 Anthropic 供應商設定檔中的 sk-ant-admin... 認證資訊，會自動偵測為 Admin API 金鑰。

Admin API 成本記錄來自 Anthropic 的用量與成本 API。這是供應商的實際帳單，與 OpenClaw 根據工作階段推算的預估成本不同。

OpenClaw 的 Claude CLI 後端會以非互動式列印模式 （claude -p）執行已安裝的 Claude Code CLI。Anthropic 目前的 Claude Code 文件 將該模式描述為 Agent SDK／程式化用法。Anthropic 於 2026 年 6 月 15 日的 支援更新暫停了先前宣布的獨立 Agent SDK 計費變更：Claude Agent SDK、claude -p 與第三方應用程式用量仍會計入已登入 訂閱方案的用量限制，而且在 Anthropic 修訂該方案期間，先前宣布的每月 Agent SDK 額度並不可用。

互動式 Claude Code 仍會計入已登入 Claude 方案的用量限制。 API 金鑰驗證採直接隨用隨付計費，不依賴該方案。 對於長期運作的閘道主機、共用自動化與需要可預測正式環境 支出的情境，請使用 Anthropic API 金鑰。

Anthropic 目前的支援文章可能在 OpenClaw 未發布新版本的情況下 變更此行為：

• Claude Code CLI 參考資料
• 搭配你的 Claude 方案使用 Claude Agent SDK
• 搭配你的 Pro 或 Max 方案使用 Claude Code
• 搭配你的 Team 或 Enterprise 方案使用 Claude Code
• 管理 Claude Code 成本

​

開始使用

API 金鑰

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

1. 取得你的 API 金鑰

   在 Anthropic Console 中建立 API 金鑰。

2. 執行導入設定

   openclaw onboard
   # 選擇：Anthropic API 金鑰
   

   或直接傳入金鑰：

   openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
   
3. 確認模型可用

   openclaw models list --provider anthropic
   

​

設定範例

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-5" } } },
}

Claude CLI

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

1. 確認 Claude CLI 已安裝並登入

   使用以下指令確認：

   claude --version
   
2. 執行導入設定

   openclaw onboard
   # 選擇：Claude CLI
   

   OpenClaw 會偵測並重複使用現有的 Claude CLI 認證資訊。

3. 確認模型可用

   openclaw models list --provider anthropic
   

Claude CLI 後端的設定與執行階段詳細資訊，請參閱命令列介面後端。

重複使用 Claude CLI 時，OpenClaw 程序必須與 Claude CLI 登入在同一主機上執行。Docker 安裝可以持久保存容器的家目錄，並在該處登入 Claude Code；請參閱 Docker 中的 Claude CLI 後端。 Podman 等其他容器安裝不會在設定或執行階段掛載主機的 ~/.claude；請在其中使用 Anthropic API 金鑰，或選擇 由 OpenClaw 管理 OAuth 的供應商，例如 OpenAI Codex。

​

取得設定權杖

在任何已安裝 Claude Code 的機器上執行 claude setup-token。它會輸出 一個以 sk-ant-oat01- 開頭的長效權杖。

在導入設定期間，於 macOS 應用程式中的 Connect with an API key or token 下選擇 Anthropic setup-token，然後貼上權杖，或使用：

openclaw models auth login --provider anthropic --method setup-token

​

設定範例

建議使用標準 Anthropic 模型參照，並加上 CLI 執行階段覆寫：

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

為了相容性，舊版 claude-cli/claude-opus-4-7 模型參照仍可使用， 但新設定應將供應商／模型選擇保留為 anthropic/*，並將執行後端放在供應商／模型的執行階段原則中。

​

計費與 claude -p

OpenClaw 在 Claude CLI 執行作業中使用 Claude Code 的非互動式 claude -p 路徑。 Anthropic 目前將該路徑視為 Agent SDK／程式化用法：

• Anthropic 於 2026 年 6 月 15 日的支援更新暫停了先前宣布的 獨立 Agent SDK 額度方案。
• 訂閱方案的 Claude Agent SDK、claude -p 與第三方應用程式用量 仍會計入已登入訂閱方案的用量限制。
• 在 Anthropic 修訂該方案期間，先前宣布的每月 Agent SDK 額度 並不可用。
• Console／API 金鑰登入採用隨用隨付 API 計費，且不會獲得 訂閱方案的 Agent SDK 額度。

如需暫停通知，請參閱 Anthropic 的 Agent SDK 方案 文章； 如需了解訂閱方案行為，請參閱 Claude Code 的 Pro／Max 與 Team／Enterprise 方案文章。

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

對於共用的正式環境自動化，請使用 Anthropic API 金鑰，而非 Claude CLI。OpenClaw 也支援來自 OpenAI Codex、Qwen Cloud、 MiniMax 與 Z.AI／GLM 的訂閱式選項。

​

跨電腦的 Claude 工作階段

內建的 Anthropic 外掛會在一般工作階段側邊欄中新增 Claude Code 群組。 各列會在一般聊天窗格中開啟。它會探索閘道與已連線節點主機上 未封存的 Claude Code 工作階段：

• Claude CLI 工作階段來自有效的專案索引記錄。對於未編入索引的 逐字稿，有限範圍的中繼資料備援會辨識 ~/.claude/projects/ 下同時存在、非側鏈的 互動式（cli）與無頭 Agent SDK CLI（sdk-cli）工作階段。
• 當 Claude Desktop 的中繼資料指向相同的 Claude Code 工作階段 ID 時， Claude Desktop 工作階段會使用 Desktop 標題、活動時間與封存狀態。
• 僅限 CLI 的工作階段沒有封存旗標，因此只要其逐字稿仍存在，就會保持可見。

探索功能不需要額外的 OpenClaw 設定。Anthropic 外掛 已內建且預設啟用；當本機 ~/.claude/projects/ 目錄存在時，原生 macOS 節點會公布唯讀的 Claude 工作階段命令。這些命令首次出現時，請核准節點配對升級。

側邊欄會依各自的閘道或配對節點主機將各列分組，並在每台電腦回應時立即顯示該主機 最新的有限範圍頁面。主機連線狀態變更後、頁面重新取得焦點時，以及頁面可見期間最多每 30 秒，它都會再次進行同步，讓在 OpenClaw 外部建立的 Claude 工作階段無須重新載入即可出現。 目錄變更時，系統會更快進行後續同步。在目錄群組下方使用 載入更多 工作階段，可為每個仍有更多記錄的主機附加下一頁；附加的資料列會保持可見， 並在重新整理時重新擷取至相同深度。目錄用戶端使用 sessions.catalog.list；開啟資料列則使用 sessions.catalog.read。

終端機接管會先從擁有該主機的使用者登入 Shell PATH 解析 claude， 再使用服務／常駐程式 PATH。這可使由應用程式啟動的工作階段， 與操作者在一般終端機中使用的 Claude CLI 保持一致。

選取資料列時，會先讀取最新的逐字稿頁面。載入較舊的逐字稿 項目會沿用不透明的位元組游標，並從 JSONL 檔案讀取另一個有限範圍的區段， 而非載入完整記錄。一般使用者、助理、推理、工具呼叫與工具結果內容都會保留。 若個別項目超過節點／閘道安全上限，會清楚標示為已截斷。

對於閘道本機的 claude-cli 資料列，在一般撰寫區中輸入內容會呼叫 sessions.catalog.continue。OpenClaw 會重新解析本機目錄記錄、 建立或重複使用鎖定模型的原生工作階段、匯入最多 200 個可見 項目或 512 KiB，並植入 Claude CLI 繫結。第一輪會使用 --fork-session 恢復；Claude 會為分支指派新的工作階段 ID，因此後續輪次會使用 該分支，而來源工作階段維持不變。

無頭節點主機也可以啟用下方的節點本機設定並重新啟動節點主機， 讓其 Claude CLI 資料列可以繼續：

{
  nodeHost: {
    agentRuns: {
      claude: { enabled: true },
    },
  },
}

只有在該設定已啟用，且能解析其本機 claude 可執行檔時， 節點才會公布 agent.cli.claude.run.v1。OpenClaw 會在該節點上重新解析目錄 記錄、匯入相同的有限範圍記錄，並將採用的工作階段繫結至該節點和目錄回報的工作目錄。 每一輪都會使用該節點的 Claude 檔案與登入，執行節點上真正的 claude -p 程序。節點的執行核准原則仍然適用；閘道無法強制選擇加入。

節點延續 v1 僅支援單次操作。它會省略閘道回送 MCP 設定與 閘道 Skills 外掛引數、不會從閘道逐字稿重新植入，並拒絕附件與圖片。 Claude Desktop 資料列仍為僅供檢視。原生 macOS 應用程式節點在應用程式公布執行命令前， 也仍為僅供檢視。

除非無頭節點明確公布 agent.cli.claude.run.v1，否則配對節點上的 Claude 工作階段仍為唯讀。 OpenClaw 絕不修改 Claude Desktop 中繼資料，也不會封存 Claude 工作階段。 此頁面需要具備寫入範圍的操作者連線，因為它使用經驗證的 node.invoke； 即使在已啟用延續功能的節點上，列出與讀取操作仍然是唯讀。

請參閱節點：Claude 工作階段與逐字記錄， 以瞭解節點命令與安全邊界。

​

思考預設值（Claude Opus 5、Sonnet 5、Mythos 5、Fable 5、4.8 與 4.6）

anthropic/claude-opus-5 預設使用 high 強度的自適應思考。 使用 /think off 可停用思考，或使用 /think xhigh|max 採用模型原生的 較高強度等級。由於 Anthropic 不支援在此模型的要求中使用這些功能，OpenClaw 會省略手動思考預算、自訂取樣參數、助理預填，以及 Opus 5 的 Priority Tier。 目錄會公布其 1,000,000-token 上下文視窗、128,000-token 輸出限制、圖片 輸入，以及 $5/$25 輸入／輸出定價。

anthropic/claude-sonnet-5 使用相同的自適應思考預設值與要求 限制。目錄採用 Anthropic 的入門 $2/$10 輸入／輸出 定價，適用至 2026 年 8 月 31 日；標準 $3/$15 定價自 2026 年 9 月 1 日起生效。

anthropic/claude-fable-5 一律使用自適應思考，且預設為 high 強度。Anthropic 不允許停用此模型的思考，因此 /think off 與 /think minimal 會改為對應至 low 強度。OpenClaw 也會 省略 Fable 5 要求中的自訂 temperature 值，因為 Anthropic 會拒絕 任何啟用思考之要求中的 temperature 覆寫。

anthropic/claude-mythos-5 是受限存取的模型，採用相同的一律啟用 自適應思考合約。OpenClaw 預設使用 high，將 /think off 與 /think minimal 對應至 low，並省略呼叫端選取的取樣參數。 目錄會公布其 1,000,000-token 上下文視窗、128,000-token 輸出 限制、圖片輸入，以及 $10/$50 輸入／輸出定價。

Claude Opus 4.8 在 OpenClaw 中預設關閉思考。當你使用 /think high|xhigh|max 明確啟用自適應思考時，OpenClaw 會傳送 Anthropic 的 Opus 4.8 強度值；Claude 4.6 模型（Opus 4.6 與 Sonnet 4.6） 預設為 adaptive。

使用 /think:<level> 覆寫個別訊息，或在模型參數中設定：

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

相關 Anthropic 文件：

• 自適應思考
• 延伸思考

​

安全拒絕備援（Claude Fable 5）

使用 Claude Fable 5 也代表會使用 Claude Opus 4.8。Fable 5 隨附的 安全分類器可能拒絕要求，而 Anthropic 核准的 復原方式是讓 claude-opus-4-8 處理該輪。OpenClaw 會針對直接使用 API 金鑰的要求 自動選用此機制，因此部分 Fable 輪次會由 Claude Opus 4.8 回答 並計費。如果你的政策或預算無法接受 由 Opus 處理的輪次，請勿選取 anthropic/claude-fable-5。

​

此機制存在的原因

Fable 5 分類器會對受限領域中的要求傳回 stop_reason: "refusal"， 而且也會對鄰近的良性工作誤判為陽性（安全 工具、生命科學，甚至是要求模型重現其原始 推理）。若沒有備援，即使另一個 Claude 模型願意處理，該輪仍會 因錯誤而終止——Anthropic 自己的拒絕訊息 會要求 API 整合者設定備援模型。

​

運作方式

1. 對 anthropic/claude-fable-5 的每個直接 API 金鑰要求，OpenClaw 都會傳送 Anthropic 的伺服器端備援選用設定： server-side-fallback-2026-06-01 beta 標頭加上 fallbacks: [{"model": "claude-opus-4-8"}]。Claude Opus 4.8 是 Anthropic 唯一允許 Fable 5 使用的備援目標。
2. 只有安全分類器的拒絕會觸發備援。速率限制、 過載與伺服器錯誤的行為完全維持不變，並會經由 OpenClaw 的一般模型容錯移轉處理。
3. 救援會在同一次呼叫內進行。若在產生任何輸出前遭到拒絕， 除延遲外不會有任何跡象；整份答案都來自 Opus 4.8。若在 串流途中遭到拒絕，部分文字會保留為備援 模型接續生成的前綴，而遭拒模型的推理與工具呼叫 會依 Anthropic 的重播規則捨棄（不得將其回傳或 執行）。
4. 如果 Claude Opus 4.8 也拒絕，該輪會將拒絕呈現為 錯誤，與此功能推出前完全相同。

備援發生在 Anthropic API 層級，因此你的已設定模型清單或備援鏈 不需要包含 claude-opus-4-8——能使用 Fable 的 API 金鑰一律能處理 Opus。

​

可觀測性與計費

• 由備援處理的輪次會在助理訊息中記錄 provider_fallback 診斷， 其中列出 fromModel 與 toModel，且訊息的 responseModel 會回報 claude-opus-4-8。
• Anthropic 按每次嘗試計費：輸出前遭拒不收費，而救援 會依 Claude Opus 4.8 費率計費（目前為 Fable 5 費率的一半）。OpenClaw 的 每輪成本估算會以 Opus 費率計算由備援處理的輪次，以維持一致。
• 若在串流途中遭拒，Anthropic 端還會對已串流的 Fable 部分 額外計費；該部分會回報於 API 的每次嘗試 用量中，但不會納入 OpenClaw 的每輪估算。

​

範圍

適用於使用 API 金鑰向 api.anthropic.com 進行驗證的 anthropic/claude-fable-5。 OAuth（重複使用 Claude 命令列介面訂閱）、Proxy 基底 URL、 Bedrock、Vertex 與 Foundry 要求皆不受影響，仍會在這些情況下 將拒絕呈現為錯誤。

已即時驗證：在未使用 備援時，要求 Fable 5 重現其原始思維鏈的良性提示會遭 category: "reasoning_extraction" 拒絕；同一提示經由 OpenClaw 傳送時，則會傳回一般的 Opus 處理 答案，並附上 provider_fallback 診斷。

底層行為請參閱 Anthropic 的拒絕與備援 指南。

​

提示快取

OpenClaw 支援 Anthropic 的提示快取功能，適用於 API 金鑰驗證。

值	快取期間	說明
"short"（預設）	5 分鐘	自動套用於 API 金鑰驗證
"long"	1 小時	延長快取
"none"	不快取	停用提示快取

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

個別代理程式的快取覆寫

以模型層級參數作為基準，再透過 agents.entries.*.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.entries.*.params（符合 id，依鍵覆寫）

如此可讓一個代理程式保留長效快取，同時讓使用相同模型的另一個代理程式針對突發性／低重複使用流量停用快取。

Bedrock Claude 注意事項

• Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/*anthropic.claude*）在設定後可接受 cacheRetention 直接傳遞。
• 非 Anthropic Bedrock 模型會在執行階段強制設為 cacheRetention: "none"。
• 若未設定明確值，API 金鑰智慧預設值也會為 Bedrock 上的 Claude 參照填入 cacheRetention: "short"。

​

進階設定

快速模式

OpenClaw 共用的 /fast 切換開關會為直接使用 API 金鑰且傳送至 api.anthropic.com 的流量設定 Anthropic 的 service_tier 欄位。

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

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

• 僅適用於使用 API 金鑰直接提出的 api.anthropic.com 要求。OAuth／訂閱權杖要求與 Proxy 路由一律不會收到 service_tier 欄位。
• 若同時設定，明確的 serviceTier 或 service_tier 參數會覆寫 /fast。
• Claude Opus 5 與 Sonnet 5 不支援 Priority Tier，因此 OpenClaw 會省略這些模型的 service_tier。
• 在沒有 Priority Tier 容量的帳戶上，service_tier: "auto" 可能解析為 standard。

媒體理解（圖片與 PDF）

隨附的 Anthropic 外掛會註冊圖片與 PDF 理解功能。OpenClaw 會從已設定的 Anthropic 驗證方式自動解析媒體能力，不需要 額外設定。

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

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

1M 上下文視窗

Claude Opus 5、Sonnet 5、Mythos 5 與 Fable 5 具有精確的 1,000,000-token 輸入視窗，並支援最多 128,000 個輸出 token。 Anthropic 的 1M 上下文視窗也已在採用自適應 思考的 Claude 4.x 模型上正式推出：Opus 4.8、 Opus 4.7、Opus 4.6 與 Sonnet 4.6。OpenClaw 會自動設定這些模型的 容量，不需要 params.context1m：

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

較舊的設定可以保留 params.context1m: true；它對 這些模型是無害且不執行任何動作的設定，而 OpenClaw 無論如何都不再傳送已淘汰的 context-1m-2025-08-07 beta 標頭。要求標頭解析期間會捨棄值為該內容的舊版 anthropicBeta 設定 項目，而不支援的舊版 Claude 模型會維持其一般上下文視窗。

params.context1m: true 在 Claude 命令列介面後端 （claude-cli/*）的行為相同：符合資格且支援正式版功能的 Opus 與 Sonnet 模型 已會自動取得 1M 視窗，因此該參數在此同樣為選用。

需要你的 Anthropic 認證資訊具備長上下文存取權。OAuth／訂閱權杖驗證會保留必要的 Anthropic beta 標頭，但若已淘汰的 1M beta 標頭仍存在於較舊設定中，OpenClaw 會將其移除。

Claude Opus 5 1M 上下文

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

​

疑難排解

401 錯誤／權杖突然失效

Anthropic 權杖驗證會過期，也可能遭撤銷。新設定請改用 Anthropic API 金鑰。

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

Anthropic 驗證是依代理程式分別設定；新代理程式不會繼承主要代理程式的金鑰。請為該代理程式重新執行導引設定（或在閘道主機上設定 API 金鑰），然後使用 openclaw models status 驗證。

找不到設定檔 "anthropic:default" 的認證資訊

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

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

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

更多協助：疑難排解和常見問題。

​

相關內容

模型選擇

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

命令列介面後端

Claude 命令列介面後端的設定與執行階段詳細資訊。

提示快取

提示快取如何在不同提供者之間運作。

OAuth 與驗證

驗證詳細資訊與認證資訊重複使用規則。