编者摘要：OpenClaw 2026.5.28 是面向 AI 智能体与自动化开发平台的更新，核心围绕稳定性、安全性、模型生态、性能与体验全面升级，已提供 npm 包、macOS 安装包与源码，支持生产部署。

版本强化智能体与 Codex 运行时稳定性，实现子智能体工作空间隔离、锁机制优化，故障不影响共享状态；多渠道（Discord、Slack、Teams、WhatsApp 等）提升身份认证、消息投递与 URL 信任安全，降低越权与丢信风险。界面全面刷新，iOS Pro UI、Web 聊天与会话状态保留更完善。

模型支持大幅扩展，新增Claude Opus 4.8、Fal Krea 图像、NVIDIA 模型、MiniMax 流式音乐，支持加密 PDF 提取与 MCP 结构化输出；集成 GitHub Copilot 智能体运行时与 Codex Supervisor 插件，插件体系更完善。网关与插件热路径优化缓存、减少重复计算，性能显著提升；输入校验更严格，非法值提前拦截，避免运行异常。

本次修复覆盖智能体、多渠道、认证、网络、浏览器、媒体等场景，解决离线操作、会话过期、Token失效、传输错误等问题。文档附带 Claude 模型双认证方式（API 密钥 / CLI）、6 月 15 日新计费规则与配置示例，生产环境推荐使用 API 密钥保障计费可预测。整体发布流程可追溯，失败提供完整日志与证据，适配企业级稳定部署需求。

一、核心发布信息

• 版本：OpenClaw 2026.5.28
• 发布时间：2026.5.28（4 小时前发布）
• 代码提交：主分支726 次提交
• 交付形式：npm 包、macOS 安装包（dmg/zip）、源码包，提供完整校验与发布验证链接

二、八大亮点

1. 运行时更稳定

智能体与Codex 运行时恢复能力增强，子智能体保持工作目录隔离，上下文本地化，锁机制优化，故障不破坏共享状态。

2.安全能力升级

多平台（Matrix/iMessage/Slack/Discord/Teams/WhatsApp/Telegram）的频道交付、身份认证、URL 信任、权限校验全面加固。

3.界面全面刷新

移动端（iOS Pro UI）、Web 聊天、实时通话、会话管理优化，重连与空搜索状态保留更完善。

4.输入限制更严格

浏览器工具、网关端口、定时任务、Discord/Telegram 组件等提前拦截非法参数，保障上下文稳定。

5.模型与能力扩展

支持Claude Opus 4.8、Fal Krea 图像模型、NVIDIA 模型、MiniMax 流式音乐；支持加密PDF 提取、GitHub Copilot 智能体运行时。

6.错误处理与恢复优化

CLI、认证、服务启动失败更快响应，配置迁移更规范，重启指引可操作。

7.性能大幅提升

网关与插件热路径去重，缓存优化，减少重复计算与存储开销。

8.发布与测试更可靠日志、工件、跨系统验证增强，失败可追溯，不出现误报通过。

三、功能变更

1. 状态展示：
   
   状态输出显示活跃子智能体详情
2. 多语言：
   
   拆分默认语言包，扩展差异对比语言覆盖
3. ClawHub：
   
   新增插件显示名、技能验证与信任面板
4. iOS 端：
   
   Pro Command 刷新，支持实时通话回放、网关会话诊断
5. 文档处理：
   
   ClawPDF 支持加密PDF 提取，输出MCP 结构化内容
6. 模型支持：
   
   Claude Opus 4.8、Fal Krea、NVIDIA、MiniMax 音乐、语音模型目录全覆盖
7. GitHub 集成：
   
   新增Copilot 智能体运行时、Codex Supervisor 插件
8. 插件体系：
   
   GitHub Copilot/Tokenjuice 转为官方按需插件
9. 协作工具：
   
   新增智能体协调面板，跟踪与交接工作
10. Discord：
    
    草稿实时显示评论，暴露执行上下文
11. 插件SDK：
    
    新增回复payload 钩子，简化包类型
12. 安全策略：
    
    强化策略对比、入口一致性、沙箱状态检查

四、重点问题修复

1. 智能体/ Codex：
   
   离线可删除智能体、授权收紧、上下文隔离、锁机制修复、流式传输稳定、重启不丢失状态
2. 多渠道：
   
   各平台消息投递、身份、轮询、警告、URL 信任修复，避免重复执行与丢失消息
3. 认证与CLI：
   
   非法输入拦截、凭据忽略、心跳与令牌生命周期管控、多厂商认证兼容
4. 网关与安全：
   
   令牌过期、去重、陈旧会话清理、元数据规范、状态驱逐
5. 解析与网络：
   
   严格解析、IPv6 兼容、配置规范化、端口与媒体校验
6. 浏览器与自动化：
   
   非法索引、尺寸、权限、延迟限制修复
7. 定时任务：
   
   速率限制重试、预检查回退
8. 媒体与文件：
   
   图像缓存、HTML 附件、视频下载、传输错误处理
9. 性能：
   
   缓存复用、JSON 解析优化、存储开销降低
10. 发布与CI：
    
    跨系统打包、日志绑定、失败可追溯

五、Claude 模型接入说明（重点）

1. 两种认证方式
• API 
  
  密钥：标准Anthropic API 访问，按使用计费，适合生产环境
• Claude CLI
  
  ：复用本地登录凭证，适合开发测试

2.计费规则（2026.6.15 起）

o claude -p（Agent SDK）优先扣每月Agent SDK 额度，再扣标准API 信用

o API 密钥为纯按需计费，不享受Agent SDK 信用

o 生产环境建议用API 密钥保证可预测支出

3.模型配置

oClaude Opus 4.8 默认关闭思考，可通过/think或参数开启（high/xhigh/max）

o支持提示缓存：短（5 分钟）、长（1 小时）、无（关闭）

o支持1M 上下文窗口、快速媒体理解

六、文档附加价值

• 提供安装命令、配置示例、故障排查（401 / 凭证缺失等）
• 明确兼容策略与向后兼容约定
• 标注贡献者与感谢名单

总结

这是一次稳定性、安全性、性能、模型生态全面升级的版本，聚焦智能体运行可靠、多平台接入安全、开发体验优化，并深度集成Claude Opus 4.8 等主流模型，适合AI 智能体开发与自动化部署使用。

附录一 OpenClaw 2026.5.28 已上线

OpenClaw 2026.5.28已上线 🧠 支持Claude Opus 4.8 🎨 通过fal 支持Krea 图像模型⚡ 更快的Gateway/plugin/session 热路径 💬 Discord 进度草稿现在显示评论 更清晰的模型，更生动的运行。

openclaw 2026.5.28

github-actions于4 小时前发布

·自该版本以来，共有726次提交到主分支

v2026.5.28 e932160

亮点

l智能体和Codex运行时恢复更加稳定：子智能体保持当前工作目录/工作空间分离，挂钩上下文保持在提示本地，会议锁在超时中止时释放，而实时OpenClaw锁在清理时依然保持有效，避免过期重启继续，并且Codex应用服务器/助手故障不再破坏共享运行时状态。（#87218, #86875, #87409, #87399, #87375, #88129）

l频道交付和会话身份在出站插件钩子、Matrix房间ID、iMessage反应/批准、Slack最终回复、Discord恢复工具警告、运行时配置消息操作、WhatsApp个人资料认证根、Telegram轮询和Microsoft Teams服务URL信任检查方面变得更加安全。(#73706, #75670, #87366, #87451, #87334, #84535, #82492, #83304, #87160)

l移动和聊天界面进行了更广泛的刷新：iOS Pro UI、托管推送中继默认值、实时通话标签播放、网关聊天传输、入职、通话权限、WebChat 重新连接交付和会话选择器行为现在在重新连接和空搜索时能够保留更多状态。(#87367, #87531, #87682, #88096, #88105) 感谢@ngutman 和@BunsDev。

l浏览器、渠道和自动化输入的限制更为严格：浏览器工具超时、视口/标签页索引、网关端口、cron重试处理、Discord组件ID、模式数组引用、Telegram回调页面以及频道进度回调现在会更早拒绝格式不正确的值，并保持预期的交付上下文。（#82887）

l提供者、媒体和文档覆盖范围随着Claude Opus 4.8、Fal Krea图像模式、NVIDIA特色模型、MiniMax流音乐响应、加密PDF提取、语音模型目录、GitHub Copilot智能体运行时支持以及用于委托Codex工作流的Codex Supervisor插件路径的扩展而扩大。(#87845, #87890, #80775, #84764, #87751, #87794)

lCLI、身份验证、医生和提供者路径的失败速度更快且恢复更清晰：格式不正确的数字/版本选项被拒绝，工作区dotenv提供者凭据被忽略，心跳默认值、OAuth/令牌生命周期以及本地服务启动请求都有界限，智能体身份验证健康标签更加清晰，遗留api_key身份验证配置文件迁移到规范形式，重启指导是可操作的。(#87398, #86281, #87361, #88133, #83655, #87559, #88088, #85924) 感谢@vincentkoc和@giodl73-repo。

l插件和网关的热路径在保持安装记录、配置JSON 解析、工具搜索目录、会话存储、清单模型行、自动启用的插件配置、浏览器令牌、查看者资产和发布分割的外部插件包的缓存正确性的同时，减少了重复工作。（#86699）

l释放、质量保证和端到端验证现在绑定了更多日志、工件、工具和跨操作系统的等待，因此失败的通道产生证明，而不是挂起或错误变绿。

变更

l状态：在状态输出中显示活动子智能体详细信息。

l差异：拆分默认语言包，并扩展默认差异的语言覆盖范围，同时保持主机楼层对齐。（#87370，#87372）感谢 @RomneyDa。

lClawHub: 添加插件显示名称以及技能验证和信任表面。(#87354, #86699) 感谢@thewilloftheshadow 和@Patrick-Erichsen。

liOS：使用Pro Command 刷新开发应用程序，包括聊天、智能体、设置、托管推送中继默认值，以及与网关会话、诊断、聊天和实时通话连接的实时通话回放。（#87367, #88096, #88105）感谢@Solvely-Colin 和@ngutman。

l文档：明确Codex计算机使用设置、粘贴令牌标准输入认证设置、macOS网关休眠故障排除、原生Codex钩子中继恢复、容器模型认证、安装部署卡、设备令牌管理员权限控制、CLI设置流程兼容性、Notte云浏览器CDP设置以及后向移植目标。（#87313，#63050，#87685）感谢@bdjben、@liaoandi和@thewilloftheshadow。

lPDF/工具：使用ClawPDF进行PDF提取，支持加密PDF提取，并在智能体工具结果中呈现MCP结构化内容。(#87670, #87751)

l提供者：添加Claude Opus 4.8支持、Fal Krea图像模型架构、NVIDIA特色模型目录、MiniMax流媒体音乐响应，以及提供者支持的语音模型目录。（#87845, #87890, #80775, #84764, #87794）感谢@eleqtrizit和@vincentkoc。

lCodex/GitHub: 添加GitHub Copilot 智能体运行时和Codex 监督者插件包。

l插件：将GitHub Copilot 和Tokenjuice 外部化为官方的按需安装插件，使用npm 和ClawHub 发布元数据。

l工作板：添加智能体协调工具以跟踪和交接活跃智能体工作。

lDiscord: 显示正在进行的草稿评论，以便实时Discord 运行可以暴露有用的进行中上下文。(#85200)

l插件SDK：为需要传递频道拥有的回复的插件添加一个回复有效载荷发送钩子，并为SDK声明简化包类型。（#82823, #87165）感谢@piersonr 和@RomneyDa。

l政策：增加策略比较、入口通道一致性和沙箱状态一致性检查。(#85572, #85744, #86768)

问题修复

l智能体：当可选智能体删除网关探测无法进行身份验证时，回退到本地配置修剪，因此离线安装仍然可以删除智能体而不移除共享工作区。

l收紧电话控制变异授权[AI]. (#87150) 感谢@pgondhi987。

l明确指令持久性授权政策[AI]. (#86369) 感谢@pgondhi987。

l智能体/Codex：保持生成的智能体工作目录/工作区状态分离，转发ACP生成的附件，保持钩子上下文为本地提示，在超时中止和运行时清理时释放会话锁而不删除活跃的OpenClaw拥有的锁，避免会话事件队列自等待，清理执行中止监听器，增量流式传输助手增量，恢复原始缺失线程压缩失败，保持旋转压缩会话身份，保持压缩超时快照可继续，保持启动或辅助失败期间共享应用服务器状态，保持原生钩子中继在重启期间存活并修剪过时的桥接文件，关闭原生钩子中继替换竞态，保持Claude实时工具进度可见以便于监控恢复，抑制被放弃请求者的完成移交，通过工具路由工作区内存，首先解决Codex运行时模型，报告隔离的动态工具，格式化技能命令输出，将节点自动审查绑定到准备的计划，重试Claude CLI转录探测，及绑定压缩/引导重试。（#87218, #86875, #86123, #88129, #87399, #87375, #72574, #87383, #87400, #83022, #87671, #87738, #87747, #87706, #87546, #87541, #81048）感谢@mbelinky, @Alix-007, @luoyanglang, @yetval, @sjf, @joshavant, @benjamin1492, @c19354837, @fuller-stack-dev, @pfrederiksen，以及@dodge1218。

lCodex Supervisor: 保持真实家庭应用服务器MCP 会话列表在加载状态路径上，绑定存储的历史扫描，并干净地关闭WebSocket 探测。

l渠道：将线索标准会话密钥串接到出站钩子中，保持Matrix房间ID大小写，保持回退工具警告提及无效，保留在晚间清理期间送达的Slack最终回复，拒绝反应后继续iMessage轮询，抑制重复的本地执行批准，解决针对活动运行时配置的网关消息操作，保留Telegram SecretRef提示配置和轮询保持活动，保留WhatsApp配置文件授权根、二维码显示、文档文件名和插件钩子配置，抑制Discord恢复工具警告，保留Discord语音出站助手，限制Discord/Signal/Zalo频道请求和容器超时，并阻止不受信任的Teams服务URL，同时保持TeamsSDK模式一致。(#73706, #75670, #87366, #87451, #87465, #87334, #84535, #76262, #83304, #82492, #87581, #77114, #86426, #85529, #87160) 感谢@zeroaltitude, @lukeboyett, @jarvis-mns1, @xiaotian, @funmerlin, @joshavant, @eleqtrizit, @heyitsaamir, @amittell, @lidge-jun, @liorb-mountapps, @masatohoshino, @bladin，以及@giodl73-repo。

lCLI/auth/doctor/providers: 拒绝格式不正确的数字/超时/子命令版本输入，忽略工作区dotenv 提供者凭据，等待重启子进程关闭，绑定心跳默认值加上Codex、GitHub Copilot、OpenAI、Anthropic、Google、飞书、LM Studio、MiniMax、小米TTS 和本地提供者OAuth/token/model 请求，加强Codex 身份验证探测，按智能体标记身份验证健康，在Codex 模型迁移期间保留显式agentRuntime 固定，主线程之外进行提供者身份验证，尊重Codex 响应超时，停止将当前Claude Haiku 4.5 配置迁移到Sonnet，绑定本地服务启动，解决无缓存目录的GPT-5.5，迁移遗留内存自动提供者配置，重写非规范的api_key 身份验证配置，并使医生重启后的跟进工作可操作。(#87398, #86281, #87361, #88133, #83655, #87559, #87719, #88088, #85924, #84362) 感谢@Patrick-Erichsen, @samzong, @giodl73-repo, @alkor2000, @mmaps, @nxmxbbd 和@vincentkoc。

l网关/安全/会话状态：在身份验证轮换后使浏览器令牌过期，作用域助手幂等性去重，排除探测客户端关闭，避免陈旧重启续用，保留重试后回退和陈旧速率限制冷却探测，限制网页聊天图像和文档记录扫描，包含入站元数据时间戳的秒数，清除已完成会话的活跃运行，清除陈旧的聊天流缓冲区，并在行限制下逐出当前插件状态命名空间。(#87810, #87833, #75089) 感谢@joshavant 和@litang9。

lConfig/parsing/network: 拒绝部分数字解析，严格解析提供者/Discord 重试头和日期，尊重IPv6 和裸IPv6 no_proxy 条目，保留空的插件允许列表，规范化密钥目标数组索引，拒绝格式错误的媒体内容长度，检查的TCP 端口，市场内容长度，cron 纪元，沙箱状态字段，不安全的持续时间值，空的配置路径段，非规范架构数组引用，不安全的Telegram 回调页面，以及无效的Teams 附件提取DNS 目标。（#87883）感谢@zhangguiping-xydt。

l浏览器/输入强化：拒绝无效的标签索引、过度的视口尺寸调整、显式零的CDP端口、格式错误的地理定位选项、不安全的屏幕截图或权限授予超时、过松的响应体限制、无效的cookie过期时间和非有限的浏览器工具延迟/超时。

lCron/自动化：在等待下一个预定时间之前，重试由于瞬时模型速率限制而导致的重复作业，并在跳过预定工作之前进行模型的预检查回退。（#82887）感谢@chen-zhang-cs-code。

l自动回复/指令：在指令持久化过程中尊重提供者和中继通道元数据，以确保通道起源的决策保持其预期上下文。（#87683）

lWhatsApp：从活动配置文件中解析身份验证目录，以便配置文件范围内的WhatsApp 安装不会漂移到错误的凭证根目录。（#82492）感谢@lidge-jun。

l网关/会话状态：清除已完成会话的活跃运行，避免为MCP库存冷加载提供程序，缓存单会话子索引，限制握手定时器，并绑定预认证、认证保护、媒体、成绩单、准备状态和端口选项。

lChannels/replies: 在关闭详细输出时保留频道拥有的进度回调，保持群组房间进度抑制不变，偏好外部会话交付上下文，转义Discord组件ID分隔符，强制最终TUI聊天重绘，显示Slack推理预览，并规范化Discord/Matrix/Mattermost频道数字选项。(#87476, #87423)

l智能体/工具参数：增强智能引用参数修复以编辑数组和精确转义参数，以便模型生成的工具调用能够在不损坏有效输入的情况下恢复。（#86611）感谢@ferminquant。

l提供者/智能体：保留种子化的Anthropic签名，保留签名思维有效负载，连接签名增量块，保留DeepSeek推理内容在层后缀中的重放，应用OpenRouter strict9 ids到Mistral路由，推广Ollama明文工具调用，加载NVIDIA特色模型目录，流式传输MiniMax音乐生成响应，以及恢复空预检压缩。（#87593, #87493, #80775, #84764）感谢@Pluviobyte和@eleqtrizit。

l媒体/图片：在解析生成的图像时跳过CLI 图像缓存引用，允许受信任的生成HTML 附件，并限制生成视频下载，以便过期引用和慢速提供者能够干净失败。(#87523, #87982)

l文件传输：在归档验证或解包已完成后处理延迟的tar 标准输入管道错误。

l性能：在重载之间信任安装记录缓存，优先使用原生JSON解析，重用未改变的工具搜索目录，重用网关会话和插件元数据路径，跳过未改变的存储序列化，修补单入口会话写入，添加预计算会话补丁写入器，减少存储克隆分配，缓存清单模型目录行和自动启用的插件配置，避免对条目读取进行完整会话快照，延迟配置的Slack完整启动，优先使用捆绑的插件分发条目，以及精简当前元数据身份缓存。（#87760）

lDocker/release/QA：打包运行时工作区模板，流式传输跨操作系统服务的工件，保留稀疏的Crabbox运行工件，按包隔离npm插件安装，拒绝不兼容的包插件API安装，在Rastermill迁移后从包清单中删除剩余的root Sharp依赖项，绑定OpenClaw实例日志、插件挑战中继日志、MCP通道缓冲区、厨房水槽扫描、智能体轮换断言、QA-Lab凭证中介调用、QA Matrix底层请求，以及发布场景日志，并保持release/google实时保护程序更新。(#87647, #87477) 感谢@rohitjavvadi 和@vincentkoc。

l发布/持续集成：绑定手动git 获取、ClawHub 验证器响应、ClawHub 所有者元数据、依赖守卫错误消息体、Parallels 限制、启动/测试/内存预算解析，以及差异查看器构建警告，以便发布通道失败时提供有用的证据，而不是挂起。(#87839)

发布验证

lnpm package: https://www.npmjs.com/package/openclaw/v/2026.5.28

lregistry tarball: https://registry.npmjs.org/openclaw/-/openclaw-2026.5.28.tgz

lintegrity: sha512-p7jGN9wzCrqEvHNI6Y7+eh6DWoYDzJ1iQGKTm8xqQ2uQ9/2mY1CCf87WoZeb0+m3eHKSGchlI3tN33fE1lMtEA==

lnpm 预检: https://github.com/openclaw/openclaw/actions/runs/26692293231

l完整发布验证：https://github.com/openclaw/openclaw/actions/runs/26692292739

lrelease checks: https://github.com/openclaw/openclaw/actions/runs/26692419552

lnpm Telegram 包E2E: https://github.com/openclaw/openclaw/actions/runs/26692496669

lplugin npm publish: https://github.com/openclaw/openclaw/actions/runs/26693306143

lplugin ClawHub publish: https://github.com/openclaw/openclaw/actions/runs/26693807853

lOpenClaw npm 发布：https://github.com/openclaw/openclaw/actions/runs/26693561375

lmacOS 预飞行/签名/公证：https://github.com/openclaw/releases/actions/runs/26694473893

lmacOS 验证：https://github.com/openclaw/releases/actions/runs/26695381614

lmacOS publish/appcast: https://github.com/openclaw/releases/actions/runs/26695523506

lappcast: https://raw.githubusercontent.com/openclaw/openclaw/main/appcast.xml

lmacOS zip: https://github.com/openclaw/openclaw/releases/download/v2026.5.28/OpenClaw-2026.5.28.zip

lmacOS dmg: https://github.com/openclaw/openclaw/releases/download/v2026.5.28/OpenClaw-2026.5.28.dmg

lmacOS dSYM: https://github.com/openclaw/openclaw/releases/download/v2026.5.28/OpenClaw-2026.5.28.dSYM.zip

附录2  Anthropic构建了Claude模型家族

OpenClaw支持两种身份验证路线：

1.API密钥— 直接的Anthropic API访问，使用基于使用量的计费（anthropic/*模型）

2.Claude CLI — 在同一主机上重新使用现有的Claude Code登录

警告

OpenClaw的Claude CLI后端以非交互式打印模式运行已安装的Claude Code CLI。Anthropic当前的Claude Code文档将claude -p描述为智能体SDK/编程使用。从2026年6月15日起，Anthropic表示订阅计划claude -p的使用不再从正常Claude计划的限制中扣除；首先从单独的每月智能体SDK信用中扣除，然后在启用这些信用时按标准API费率扣除使用信用。

交互式Claude代码仍然受到已登录Claude计划限制的约束。API密钥认证仍然是直接按需付费的API账单。对于长期存在的网关主机、共享自动化和可预测的生产支出，请使用Anthropic API密钥。

Anthropic目前的公开文档：

Claude Code CLI参考

使用Claude Agent SDK与您的Claude计划

使用Claude代码与您的专业或高级计划

使用Claude Code与您的团队或企业计划

管理Claude Code成本

开始使用

API key

最适合：标准API访问和基于使用的计费。

1.获取您的API密钥

在Anthropic控制台中创建API密钥。

2. 进行入职培训

BASHCopy code

openclaw onboard# choose: Anthropic API key

或者直接传递密钥：

BASHCopy code

openclaw onboard –anthropic-api-key “$ANTHROPIC_API_KEY”

3. 验证模型是否可用

BASHCopy code

openclaw模型列表—提供者anthropic

配置示例

JSON5Copy code

{ env: { ANTHROPIC_API_KEY: “example-anthropic-key-not-real” },  agents: { defaults: { model: { primary: “anthropic/claude-opus-4-8” } } },}

Claude CLI

最佳适用场景：重新使用现有的Claude CLI登录，而无需单独的API密钥。

4. 确保Claude CLI 已安装并登录

验证：

BASHCopy code

claude –version

5. 进行入职培训

BASHCopy code

openclaw onboard# choose: Claude CLI

OpenClaw检测并重用现有的Claude CLI 凭证。

6. 验证模型是否可用

BASHCopy code

openclaw模型列表—提供者anthropic

注意

Claude CLI后端的设置和运行时详细信息在CLI 后端中。

警告

Claude CLI重用期望OpenClaw 进程在与Claude CLI 登录相同的主机上运行。诸如Podman 的容器安装不会在设置或运行时挂载主机的~/.claude；在此使用Anthropic API 密钥，或选择如OpenAI Codex 等具有OpenClaw 管理的OAuth 的提供者。

配置示例

首选标准的Anthropic模型参考加上CLI运行时覆盖：

JSON5Copy code

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

遗留的claude-cli/claude-opus-4-7 模型引用仍然可以使用以保持兼容性，但新的配置应将提供者/模型选择保持为anthropic/*，并将执行后端放入提供者/模型运行时策略中。

7.计费和claude -p

OpenClaw使用Claude Code的非交互式claude -p路径进行Claude CLI运行。Anthropic目前将该路径视为Agent SDK/程序化使用。

截至2026年6月15日，订阅计划处理遵循已登录账户的Anthropic的活跃Claude代码规则。

1.从2026年6月15日起，订阅计划claude -p的使用首先从用户的每月Agent SDK信用中扣除，然后在启用使用信用的情况下，按标准API费率从使用信用中扣除。

控制台/API密钥登录使用按需付费的API 计费，且不享受订阅智能体SDK 信用。

Anthropic可以在没有OpenClaw发布的情况下更改Claude Code的计费和速率限制行为。当计费可预测性很重要时，请检查claude auth状态、/status和Anthropic的相关文档。

提示

对于共享生产自动化，使用Anthropic API密钥而不是Claude CLI。OpenClaw还支持来自OpenAI Codex、Qwen Cloud、MiniMax和Z.AI / GLM的订阅式选项。

思维默认值（Claude 4.8和4.6）

Claude Opus 4.8在OpenClaw 中默认关闭思考功能。当您明确启用自适应思考功能时，使用/think high|xhigh|max，OpenClaw 会发送Anthropic 的Opus 4.8 努力值；Claude 4.6 模型默认采用自适应模式。

每条消息用 /think:<level> 或在模型参数中进行覆盖：

JSON5Copy code

{ agents: {    defaults: {      models: {        “anthropic/claude-opus-4-8”: {          params: { thinking: “high” },        },      },    },  },}

注意

相关的Anthropic文档：

适应性思维

扩展思维

提示缓存

OpenClaw支持Anthropic 的提示缓存功能用于API 密钥认证。

值	缓存时长	描述
“短“（默认）	5分钟	自动应用于API密钥认证
“长“	1小时	扩展缓存
“无“	不缓存	禁用提示缓存

JSON5Copy code

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

每个智能体的缓存覆盖Bedrock Claude注释

高级配置

快速模式媒体理解（图像和PDF）1M上下文窗口Claude Opus 4.8 1M上下文

故障排除

401错误/ token突然无效未找到提供者“anthropic”的API密钥未找到配置文件“anthropic:default”的凭证没有可用的身份验证配置文件（全部进入冷却状态）

注意

更多帮助：故障排除与常见问题解答。