Anthropic

Anthropic 打造了 Claude 模型系列。OpenClaw 支援兩種驗證途徑：

• API 金鑰 - 直接存取 Anthropic API，依用量計費（anthropic/* 模型）
• Claude 命令列介面 - 重複使用同一主機上現有的 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 onboard# 選擇：Anthropic API 金鑰

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 --version

openclaw onboard# 選擇：Claude 命令列介面

openclaw models list --provider anthropic

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

跨電腦的 Claude 工作階段

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

• Claude 命令列介面工作階段來自有效的專案索引記錄，以及位於 ~/.claude/projects/ 下、其受限中繼資料前綴識別為非側鏈 sdk-cli 工作階段的目前 JSONL 檔案。
• 當 Claude Desktop 的中繼資料指向相同的 Claude Code 工作階段 ID 時，Claude Desktop 工作階段會使用 Desktop 標題、活動時間和封存狀態。
• 僅有命令列介面的工作階段沒有封存旗標，因此只要其逐字記錄仍存在，就會維持可見。

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

側邊欄一開始會顯示各主機最新的受限頁面，並依一般的 30 秒週期重新整理。使用目錄群組下方的 載入更多工作階段，為每個仍有更多記錄的主機附加下一頁；附加的列會保持可見，並在重新整理時重新擷取至相同深度。目錄用戶端使用 sessions.catalog.list；開啟一列則使用 sessions.catalog.read。

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

對於閘道本機的 claude-cli 列，在一般撰寫框中輸入內容會呼叫 sessions.catalog.continue。OpenClaw 會重新解析本機目錄記錄、建立或重複使用鎖定模型的原生工作階段、匯入最多 200 個可見項目或 512 KiB，並初始化 Claude 命令列介面繫結。第一輪會使用 --fork-session 繼續；Claude 會為分支指派新的工作階段 ID，因此後續輪次會使用該分支，而來源工作階段保持不變。Claude Desktop 與配對節點上的列僅供檢視。

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

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

anthropic/claude-sonnet-5 預設會以 high 力度使用自適應思考。使用 /think off 可停用思考，或使用 /think xhigh|max 選擇模型更高的原生力度等級。由於 Anthropic 不支援在此模型的要求中使用這些功能，OpenClaw 對 Sonnet 5 會省略手動思考預算、自訂取樣參數、助理預填內容與 Priority Tier。 目錄採用 Anthropic 的上市優惠輸入／輸出價格 $2/$10，有效至 2026 年 8 月 31 日；標準價格 $3/$15 將於 2026 年 9 月 1 日開始。

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

anthropic/claude-mythos-5 是存取受限的模型，採用相同的永遠啟用自適應思考合約。OpenClaw 預設使用 high，將 /think off 與 /think minimal 對應至 low，並省略呼叫者選取的取樣參數。 目錄會發布其 1,000,000 權杖的上下文視窗、128,000 權杖的輸出限制、圖片輸入，以及 $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-4-8": {          params: { thinking: "high" },        },      },    },  },}

安全拒絕備援（Claude Fable 5）

此功能存在的原因

Fable 5 分類器會對受限制領域的請求傳回 stop_reason: "refusal"， 也可能對相近但無害的工作誤判為陽性（例如安全性工具、 生命科學，甚至是要求模型重現其原始推理）。若沒有備援，該次互動會以錯誤終止， 即使其他 Claude 模型其實願意處理；Anthropic 自己的拒絕訊息會指示 API 整合者設定備援模型。

運作方式

1. 對於每個直接使用 API 金鑰向 anthropic/claude-fable-5 發出的請求，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 CLI 訂閱）、 代理伺服器基底 URL、Bedrock、Vertex 和 Foundry 請求均維持不變， 在這些情況下仍會將拒絕呈現為錯誤。

已透過實際環境驗證：在未傳送備援設定時，要求 Fable 5 重現其原始思維鏈的 無害提示會以 category: "reasoning_extraction" 遭到拒絕；同一提示透過 OpenClaw 傳送時，則會傳回由 Opus 處理的一般答案，並附上 provider_fallback 診斷資訊。

如需瞭解底層行為，請參閱 Anthropic 的拒絕與備援 指南。

提示快取

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

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

{  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: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

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

疑難排解

相關內容