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

claude --version

openclaw onboard# 選擇：Claude CLI

openclaw models list --provider anthropic

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

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

跨電腦的 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 應用程式節點在應用程式公布執行命令前， 也仍為僅供檢視。

請參閱節點：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" },        },      },    },  },}

安全拒絕備援（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 金鑰驗證。

{  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-opus-5": {},        "anthropic/claude-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

疑難排解

相關內容