Anthropic 建構了 Claude 模型家族。OpenClaw 支援兩種驗證方式:
OpenClaw 會偵測可用的 Anthropic 憑證,並選擇匹配的使用介面:
管理員 API 成本歷史記錄來自 Anthropic 的使用與成本 API。這是實際的供應商計費,獨立於 OpenClaw 的基於會話估算的成本。
互動式 Claude Code 仍從已登入的 Claude 計劃限制中扣除。API 金鑰驗證是直接的按用量付費計費,不依賴於該計劃。對於長期的網關主機、共享自動化和可預測的生產支出,請使用 Anthropic API 金鑰。
Anthropic 目前的支援文章可能會在沒有 OpenClaw 發布的情況下更改此行為:
最適合:標準 API 存取和按用量計費。
在 Anthropic Console 中建立 API 金鑰。
最適合:在沒有單獨 API 金鑰的情況下重複使用現有的 Claude CLI 登入。
OpenClaw 會偵測並重複使用現有的 Claude CLI 憑證。
Claude CLI 後端的設定和運行時詳細資訊請參閱 CLI Backends。
在任何安裝了 Claude Code 的機器上運行 claude setup-token。它會列印一個以 sk-ant-oat01- 開頭的長效令牌。
在入門過程中,透過選擇「透過 API 金鑰或令牌連線」下的 Anthropic setup-token,將令牌貼入 macOS 應用程式,或使用:
偏好使用標準的 Anthropic 模型參考加上 CLI 運行時覆蓋:
舊版的 claude-cli/claude-opus-4-7 模型參考仍可兼容使用,但新配置應將供應商/模型選擇保留為 anthropic/*,並將執行後端放在 provider/model 運行時策略中。
OpenClaw 在 Claude CLI 運行時使用 Claude Code 的非互動式 claude -p 路徑。Anthropic 目前將該路徑視為 Agent SDK/程式化使用:
Anthropic 可能會在沒有 OpenClaw 發布的情況下更改 Claude Code 的計費和速率限制行為。當計費可預測性很重要時,請檢查 claude auth status、/status 和 Anthropic 的連結文件。
捆綁的 Anthropic 外掛程式會在正常的會話側邊欄中新增一個 Claude Code 群組。行會在正常的聊天窗格中開啟。它會偵測網關和已連線節點主機上未封存的 Claude Code 會話:
偵測無需額外的 OpenClaw 設定。Anthropic 外掛程式是捆綁的並預設啟用;當本地 ~/.claude/projects/ 目錄存在時,原生 macOS 節點會廣告唯讀的 Claude 會話命令。當這些命令首次出現時,請批准節點配對升級。
側邊欄會按其網關或配對節點主機對行進行分組,並在該電腦響應後立即顯示每個主機最新的有界頁面。它會在主機連線更改後、頁面重新獲得焦點後,以及在可見時最多每 30 秒重新同步一次,因此在 OpenClaw 之外建立的 Claude 會話會顯示而無需重新載入。已變更的目錄會獲得更快的後續傳遞。使用目錄群組下方的「載入更多會話」來附加每個有更多歷史記錄的主機的下一頁;附加的行會保持可見,並在刷新時以相同深度重新獲取。目錄客戶端使用 sessions.catalog.list;開啟行使用 sessions.catalog.read。
終端機接管會在服務/守護進程 PATH 之前,從擁有主機用戶的登入 shell PATH 解析 claude。這會使應用程式啟動的會話與操作員在正常終端機中獲得的 Claude CLI 保持一致。
選擇一行會首先讀取最新的對話記錄頁面。載入較舊的對話記錄項目會遵循一個不透明的位元組游標,並從 JSONL 文件中讀取另一個有界部分,而不是載入整個歷史記錄。正常用戶、助手、推理、工具調用和工具結果內容會被保留。任何大於節點/網關安全上限的單獨項目都會被清楚標記為截斷。
對於網關本地的 claude-cli 行,在正常作曲家(composer)中輸入會調用 sessions.catalog.continue。OpenClaw 會重新解析本地目錄記錄,建立或重複使用一個模型鎖定的原生會話,導入最多 200 個可見項目或 512 KiB,並種子 Claude CLI 綁定。第一個回合會以 --fork-session 恢復;Claude 會為 fork 分配一個新的會話 ID,因此後續回合會使用 fork,而源會話保持不變。
無頭節點主機也可以透過啟用下方的節點本地設定並重新啟動節點主機來使其 Claude CLI 行可繼續:
僅當啟用設定且其本地 claude 可執行檔解析時,節點才會廣告 agent.cli.claude.run.v1。OpenClaw 會在該節點上重新解析目錄記錄,導入相同的有界歷史記錄,並將採用的會話綁定到節點和目錄報告的工作目錄。每個回合都會運行節點的實際 claude -p 進程,使用該節點的 Claude 文件和登入。節點的執行批准策略仍然適用;網關無法強制選擇加入。
節點繼續 v1 僅為一次性。它省略了網關迴環 MCP 設定和網關技能外掛程式參數,不會從網關對話記錄中重新種子,並且拒絕附件和圖像。Claude Desktop 行仍為唯讀。
配對節點的 Claude 會話仍為唯讀,除非無頭節點明確廣告 agent.cli.claude.run.v1。OpenClaw 絕不會修改 Claude Desktop 元數據或封存 Claude 會話。該頁面需要具有寫入範圍的操作員連線,因為它使用已驗證的 node.invoke;即使在啟用繼續功能的節點上,列表和讀取仍然是唯讀的。
請參閱 Nodes: Claude sessions and transcripts 了解節點命令和安全邊界。
anthropic/claude-opus-5 預設使用高強度自適應思考。使用 /think off 禁用思考,或使用 /think xhigh|max 以獲得模型更高的原生強度級別。OpenClaw 省略了 Opus 5 的手動思考預算、自訂採樣參數、助手預填充和優先級層,因為 Anthropic 在此模型上不支援這些請求功能。目錄顯示其 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 始終使用自適應思考,並預設為高強度。Anthropic 不允許為此模型禁用思考,因此 /think off 和 /think minimal 會映射到低強度。
anthropic/claude-mythos-5 是一個有限訪問的模型,具有相同的始終開啟自適應思考合約。OpenClaw 預設為高強度,將 /think off 和 /think minimal 映射到低強度,並省略了調用者選擇的採樣參數。目錄顯示其 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)預設為自適應。
透過 /think:<level> 或在模型參數中進行每條訊息的覆蓋:
使用 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 整合者配置一個備用模型。
備用方案發生在 Anthropic API 層級,因此 claude-opus-4-8 不需要包含在您配置的模型列表或備用鏈中 - 支援 Fable 的 API 金鑰始終可以提供 Opus。
已驗證實時:一個要求 Fable 5 重現其原始思考鏈的良性提示在沒有備用方案的情況下發送時,會因 category: "reasoning_extraction" 而被拒絕,而透過 OpenClaw 的相同提示會返回一個正常的 Opus 處理的答案,並附帶 provider_fallback 診斷。
請參閱 Anthropic 的 refusals and fallback guide 了解底層行為。
OpenClaw 支援 Anthropic 的提示快取功能,用於 API 金鑰驗證。
使用模型級別的參數作為基準,然後透過 agents.entries.*.params 覆蓋特定代理:
這允許一個代理保留一個長效快取,而同一個模型上的另一個代理則禁用快取以處理爆發性/低重複使用的流量。
OpenClaw 的共享 /fast 切換開關為 api.anthropic.com 的直接 API 金鑰流量設定了 Anthropic 的 service_tier 欄位。
捆綁的 Anthropic 外掛程式註冊了圖像和 PDF 理解功能。OpenClaw 會自動從配置的 Anthropic 驗證中解析媒體功能;無需額外設定。
當圖像或 PDF 附加到對話中時,OpenClaw 會自動透過 Anthropic 媒體理解供應商進行路由。
Claude Opus 5、Sonnet 5、Mythos 5 和 Fable 5 具有精確的 1,000,000 個 token 輸入窗口,並支援最多 128,000 個輸出 token。Anthropic 的 1M 上下文窗口也已在具有自適應思考的 Claude 4.x 模型上 GA:Opus 4.8、Opus 4.7、Opus 4.6 和 Sonnet 4.6。OpenClaw 會自動調整這些模型的大小,無需 params.context1m:
舊配置可以保留 params.context1m: true;對於這些模型來說,這是一個無害的 no-op,並且 OpenClaw 不再發送已停用的 context-1m-2025-08-07 beta 標頭。具有該值的舊 anthropicBeta 配置條目會在請求標頭解析期間被刪除,而不受支援的舊 Claude 模型將保持其正常上下文窗口。
對於 Claude CLI 後端(claude-cli/*),params.context1m: true 的行為相同;符合條件的 GA 模型 Opus 和 Sonnet 已經自動獲得 1M 窗口,因此該參數在那裡也是可選的。
anthropic/claude-opus-5 及其 claude-cli 變體預設具有 1M 上下文窗口;無需 params.context1m: true。
Anthropic 令牌驗證會過期且可能被撤銷。對於新設置,請改用 Anthropic API 金鑰。
Anthropic 驗證是每個代理的;新代理不會繼承主代理的金鑰。請為該代理重新運行入門流程(或在網關主機上配置 API 金鑰),然後使用 openclaw models status 進行驗證。
運行 openclaw models status 以查看哪個驗證配置檔處於活動狀態。重新運行入門流程,或為該配置檔路徑配置 API 金鑰。
檢查 openclaw models status --json 以查看 auth.unusableProfiles。Anthropic 的速率限制冷卻時間可能是按模型範圍劃分的,因此一個同級的 Anthropic 模型可能仍然可用。添加另一個 Anthropic 配置檔或等待冷卻期。
更多幫助:Troubleshooting and FAQ。
選擇供應商、模型參考和故障轉移行為。
Claude CLI 後端設定和運行時詳細資訊。
提示快取如何在供應商之間工作。
驗證詳細資訊和憑證重複使用規則。