OpenClaw v2026.6.5 发布:12 项核心改进,让你的 AI 代理更稳定、更安全
导语:2026 年 6 月,OpenClaw 发布 v2026.6.5。这不是一个”功能大爆炸”版本,而是一个”稳定性工程”版本——12 项核心改进,每一个都直击生产环境的痛点。作为 2021 年上岸的程序员,我把这些改进翻译成”人话”,告诉你哪些值得立即升级。

一、版本概览:为什么这个版本值得重视?

1.1 版本定位
v2026.6.5 是 OpenClaw 切换到月度补丁版本号(YYYY.M.PATCH)后的第二个正式版本。上一个版本是 v2026.6.1(6 月 1 日发布)。
版本号规则变化:
- • 旧规则:
v2026.5.7(语义化版本) - • 新规则:
v2026.6.5(年.月.补丁) - • 意义:更清晰的发布节奏,每月一个主版本,补丁号代表当月修复次数
1.2 核心主题:稳定性工程
这个版本没有”炫酷新功能”,但解决了 5 大类生产环境问题:
| 类别 | 问题数量 | 影响程度 |
|---|---|---|
| AI 回复质量 | 3 项 | ⭐⭐⭐⭐⭐ |
| 工具调用安全 | 4 项 | ⭐⭐⭐⭐⭐ |
| 会话恢复能力 | 2 项 | ⭐⭐⭐⭐ |
| 搜索能力增强 | 1 项 | ⭐⭐⭐⭐ |
| 移动端体验 | 2 项 | ⭐⭐⭐ |
二、核心改进详解:12 项必知更新

2.1 QQBot 不再泄露”思考过程”(#89913, #90132)
问题:以前用 QQBot 时,模型会偶尔把 <thinking> 标签里的思考过程直接发出来,用户看到一堆”内部独白”。
修复:现在 QQBot 会在发送前自动剥离 reasoning/thinking 脚手架,只把最终答案发给用户。
影响:QQ 群里的 AI 回复更干净,不再出现”我在思考…”之类的尴尬内容。
2.2 MCP 工具结果更健壮(#90710, #90728)
问题:MCP(Model Context Protocol)工具返回非文本/图片内容时(如音频、资源链接),会导致 Anthropic 400 错误,甚至”毒化”会话历史。
修复:现在在 materialize 边界强制转换非文本/图片块——保留有效图片,其他内容转为文本描述。
影响:使用 MCP 工具(如文件系统、数据库工具)时,会话更稳定,不会因为工具返回”奇怪内容”而崩溃。
2.3 Anthropic 扩展思考会话恢复(#90667, #90697)
问题:使用 Anthropic 的扩展思考(extended-thinking)模式时,如果 prompt cache 过期或 Gateway 重启,会话会中断且无法恢复。
修复:流式启动事件现在等待 message_start 信号,让预生成签名错误能触发已有的恢复重试机制。
影响:长会话(如代码审查、文档分析)更可靠,不会因为”思考太久”而断线。
2.4 Parallel 搜索成为内置插件(#85158)

新功能:Parallel 搜索现在是一个捆绑的 web_search 提供商,无需额外安装。
配置方式:
# 设置 API Key
export PARALLEL_API_KEY=your_key_here
# 在配置中启用
openclaw config set search.providers.parallel.enabled true
特点:
- • 自动发现
PARALLEL_API_KEY - • 受保护的端点处理(防止滥用)
- • 缓存安全的会话 ID
- • onboarding 流程支持
影响:搜索能力更强,Parallel 的实时搜索现在”开箱即用”。
2.5 Google Vertex ADC 静态目录恢复(#90506)
问题:Google Vertex 的 ADC(Application Default Credentials)用户无法使用静态目录行和运行时模型解析。
修复:恢复了静态目录行,单提供商冷却恢复和内存适配器状态检查也更可靠。
影响:使用 Google Cloud 的开发者可以正常解析模型目录了。
2.6 Matrix 语音消息和线程支持(#78016, #90415)
改进:
- • 语音消息预检(mention gating 前检查)
- • 线程读取/回复保留 Matrix 关系分页
- • QA 覆盖语音和线程流程
影响:Matrix 渠道的用户体验更完整,语音消息和线程对话更稳定。
2.7 认证和插件状态更持久(#89102, #88585)
改进:
- • 认证配置文件现在存储在 SQLite 中(以前是 ad hoc 文件)
- • 官方 npm 插件安装记录保留受信任的 pin
- • 预发布回退完整性检查避免携带过时的完整性校验
影响:重启后认证状态不丢失,插件安装更可靠。
2.8 工具循环更严格(#91124, #91233, #90022, #90261)
安全加固:
- • MCP 租约时间戳检查更严格
- • prompt-cache 工具名称受保护
- • 本地工具目录保持精简
- • 不可读动态工具被隔离
- • 仅所有者的 HTTP 工具限制
影响:工具调用更安全,不会因为”工具名冲突”或”权限泄露”导致意外行为。
2.9 macOS 节点模式不自动重连(#90668, #90815)
问题:macOS 节点模式会”静默自我重连”,从健康的直接 Gateway 会话断开,导致意外的伴侣应用会话流失。
修复:不再自动重连,保持健康的直接会话。
影响:macOS 用户会话更稳定,不会因为”自动重连”而频繁掉线。
2.10 Cron 遗留 JSON 存储迁移(#90072)
改进:doctor 配置预检现在将遗留的 cron JSON 存储迁移到 SQLite。
影响:定时任务状态更持久,重启后不丢失。
2.11 服务环境变量占位符修复(#90208, #90277)
问题:服务环境变量占位符会掩盖状态目录的 .env 值。
修复:跳过未解析的占位符,保留状态目录的秘密。
影响:服务配置更安全,不会因为”占位符覆盖”导致敏感信息泄露。
2.12 移动端状态显示优化(#90752, #91201)
改进:
- • Android 提供商/模型屏幕显示过期、不可用、未解析和注意状态
- • Android 添加主题模式选择
- • iOS 设置和 Talk 标签保持诊断、Gateway 行、附件标签可用
影响:移动端用户体验更清晰,状态一目了然。
三、升级指南:如何平滑升级

3.1 升级前检查
# 检查当前版本
openclaw --version
# 检查配置状态
openclaw doctor
# 备份配置(重要!)
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
3.2 升级命令
# 通过 npm 升级
npm install -g openclaw@latest
# 或通过 Homebrew(Mac)
brew upgrade openclaw
# 验证升级
openclaw --version
# 应显示:OpenClaw 2026.6.5 (5181e4f)
3.3 升级后验证
# 1. 检查 Gateway 状态
openclaw status
# 2. 验证 cron 任务(如有)
openclaw cron list
# 3. 测试搜索功能(Parallel)
openclaw config get search.providers.parallel.enabled
# 4. 验证认证状态
openclaw auth list
3.4 常见问题
Q:升级后认证丢失?
A:v2026.6.5 将认证迁移到 SQLite,升级后应自动保留。如丢失,从备份恢复:
cp ~/.openclaw/openclaw.json.backup ~/.openclaw/openclaw.json
openclaw doctor
Q:Parallel 搜索如何启用?
A:获取 Parallel API Key 后:
export PARALLEL_API_KEY=your_key
openclaw config set search.providers.parallel.enabled true
Q:QQBot 仍泄露思考过程?
A:确认 Gateway 版本也是 v2026.6.5:
openclaw gateway status
四、影响分析:这些改进如何改变你的工作流

4.1 对内容创作者(喇叭花团队)
| 改进 | 影响 |
|---|---|
| QQBot 思考剥离 | 飞书/QQ 群 AI 回复更专业 |
| MCP 工具健壮性 | 文件操作工具更稳定 |
| Cron 迁移 SQLite | 定时任务重启不丢失 |
| Parallel 搜索 | 热点扫描更快 |
4.2 对开发者(大力团队)
| 改进 | 影响 |
|---|---|
| Anthropic 会话恢复 | 长代码审查不中断 |
| 工具循环严格 | 自定义工具更安全 |
| macOS 节点稳定 | 本地开发不掉线 |
| 认证持久化 | 重启后不用重新登录 |
4.3 对运维人员
| 改进 | 影响 |
|---|---|
| 服务环境变量修复 | 配置更安全 |
| 遗留存储迁移 | 数据更持久 |
| 发布流程改进 | 升级更可靠 |
五、总结与行动清单
5.1 核心要点
- 1. v2026.6.5 是稳定性版本——没有炫酷功能,但生产环境更可靠
- 2. 12 项改进覆盖 AI 回复质量、工具安全、会话恢复、搜索能力、移动端体验
- 3. 版本号改为月度补丁制——
YYYY.M.PATCH,更清晰 - 4. 升级风险低——主要是修复和加固,无破坏性变更
5.2 行动清单
- • [ ] 备份当前配置(
openclaw.json) - • [ ] 执行升级(
npm install -g openclaw@latest) - • [ ] 运行
openclaw doctor验证 - • [ ] 检查 cron 任务是否完整(
openclaw cron list) - • [ ] 测试 Parallel 搜索(如有 API Key)
- • [ ] 验证 QQBot/飞书回复质量
- • [ ] 确认 Anthropic 长会话稳定性
👇 互动话题
你升级 v2026.6.5 了吗?最期待哪项改进?评论区聊聊~
如果这篇文章对你有帮助,欢迎「在看」+「转发」给需要的朋友
作者:Alex | 云境易贸 合集:OpenClaw 入门指南(OG_035) 日期:2026-06-11
夜雨聆风