OpenClaw 2026.6.5 版本更新：更稳定的会话、更智能的工具和更安全的配置

OpenClaw 于 2026 年 6 月 9 日正式发布了 v2026.6.5 版本。这是采用新版本号方案（YYYY.M.PATCH，即年.月.补丁号）后的一个重要月度更新。本次更新包含超过 30 项功能改进和问题修复，重点集中在会话恢复稳定性、工具调用格式兼容性、多平台渠道交互以及配置与存储的安全性上。如果你正在使用 OpenClaw 搭建自动化工作流、聊天机器人或多渠道消息代理，这个版本非常值得升级。

下面我们用通俗的语言，逐一说明这个版本到底改了什么、为什么重要、以及你会直接感受到哪些变化。

一、核心亮点：几句话看懂这次升级

  • QQ 机器人不再输出“思考过程”：之前模型有时会把内部的推理标签（比如 <thinking> 内容）原样发到群里，现在会自动清理。
  • MCP 工具返回复杂内容时不再报错：如果工具返回了图片、音频或混合格式，OpenClaw 会先转换成纯文本或标准图片，避免让大模型 API 拒绝处理。
  • 长时间对话不会突然中断：Anthropic（Claude）模型的扩展思考模式在缓存过期或网关重启后能自动恢复，无需手动重试。
  • 新增一个内置搜索插件 Parallel：只需配置 PARALLEL_API_KEY 即可使用 web_search 功能，无需额外安装。
  • Google Vertex AI 用户重新恢复正常：使用 ADC（应用默认凭证）的开发者现在可以正常解析模型列表和调用。
  • Matrix 支持语音消息预检和线程回复：能更准确地区分语音消息，并在同一个讨论线程内回复。
  • 配置和插件安装状态更牢固：认证信息从文件迁移到 SQLite 数据库，安装的 npm 插件会记住可信版本。
  • macOS 节点模式不再频繁重连：如果已经有一个健康的直连网关会话，系统不会再自动切换到其他节点。
  • 升级过程更安全：旧的定时任务 JSON 存储会自动迁移，服务环境变量中的占位符不会错误掩盖真实密钥，WhatsApp 启动等待有超时限制。

二、主要变化详解

2.1 渠道消息处理：QQBot、Matrix、Google Chat 等

QQBot 为什么不再输出 <thinking> 标签？

在使用支持推理步骤的大模型（如 DeepSeek-R1、Gemini 等）时，模型内部会产生 <thinking>...</thinking> 这样的“思考过程”内容。旧版本中，QQ 机器人可能直接把这个标签连同最终答案一起发出，导致群聊里出现大量技术性杂音。

2026.6.5 的解决方式：在消息发送前，自动剥离所有类似的结构化思考框架。用户只会看到模型的最终回答，而内部推理记录仅保留在日志或会话记录中，不影响群聊体验。

Matrix 现在如何处理语音消息和线程？

  • 语音预检：在判断是否应该回复某个消息（例如根据 @ 提及条件）之前，系统会先识别出语音消息类型，避免因为无法解析音频内容而漏掉用户请求。
  • 线程感知：当用户在一个线程内回复时，OpenClaw 会正确地将新消息也放在同一个线程里，而不是另起一个话题。这对于长对话的分支讨论非常关键。
  • 测试覆盖：本次增加了针对语音和线程场景的自动化测试，确保未来修改不会破坏这些行为。

Google Chat 原生审批卡片

以前 Google Chat 中的审批动作（如确认、拒绝）走的是普通文本消息流，用户需要手动输入命令。现在改为平台原生的卡片按钮，点击即可完成操作，体验更像正规应用。

WhatsApp 重启和禁用逻辑

  • 如果某个 WhatsApp 账号的配置发生变化（比如修改了手机号或凭据），系统会正确重建该账号的控制器，而不是沿用旧状态。
  • 启动时设置最大等待时间，避免因为网络问题导致整个进程卡住。
  • 当你在配置文件中禁用某个 WhatsApp 账号，它会立即彻底关闭连接，而不是残留后台任务。

Feishu（飞书）限速重试

飞书服务端有时会返回速率限制错误（HTTP 429 或特定的错误码 230020、11232）。新版本会以线性退避方式自动重试，包括流式卡片发送也纳入重试机制，显著减少“发送失败”的提示。

其他渠道细节

  • Mattermost：斜杠命令的状态保存在全局对象中，回复默认留在原线程内。
  • iMessage：私有 API 调用失败和发送超时会给出明确错误原因，而不是静默失败。
  • Discord：运行时的适配器确保解析稳定。
  • ClickClack：回复工具尊重 toolsAllow 配置，只使用允许的工具集。

2.2 Agent 与工具调用：MCP 结果转换、缓存恢复、工具权限

MCP 工具返回了图片/音频/链接怎么办？

MCP（模型上下文协议）工具可以返回丰富的内容块，包括 resource_link、resource、audio 甚至格式不完整的图片。旧版本在把这些结果送给大模型时，可能因格式不匹配导致 Anthropic API 返回 400 错误，甚至污染会话历史，使后续所有调用失败。

修复逻辑：在数据进入提供者转换器之前，增加一层“物化边界”处理：

  • 合法图片块保持不变。
  • 非文本非图片块（如音频、资源链接）强制转换成文本描述（例如“[音频内容]”）。
  • 畸形的图片块也转成文本。

这样既保留了有效信息，又保证了 API 兼容性。

长时间使用 Claude 思考模式时，会话如何恢复？

Claude 的“扩展思考”功能会生成预签名令牌。如果提示缓存过期或网关服务重启，旧的恢复逻辑可能错过 message_start 事件，导致无法继续会话。

新版本改为：流式启动事件必须等到 message_start 返回才开始处理后续内容。如果检测到签名错误，自动触发已有的重试恢复机制，用户无感知地继续对话。

工具调用的安全与效率加固

  • MCP 租约：释放租约时不再刷新 lastUsedAt 时间戳，避免租约无限延期。
  • 提示缓存工具名：不再暴露未经验证的工具名称。
  • 本地工具目录：保持精简，只加载必要的条目。
  • 动态工具：如果某个工具文件不可读，系统会将其隔离，不会让它影响主流程。
  • 仅所有者可用的 HTTP 工具：现在会正确检查权限，非所有者无法调用。
  • 后台子代理：完成任务后，结果能稳定传递回监控服务，不会丢失。

2.3 模型与提供商：Google Vertex、Ollama、OpenRouter 等

Google Vertex ADC 用户再次正常工作

之前使用应用默认凭证（ADC）的开发者发现模型目录为空或解析错误。原因是在生成 catalog 时丢失了认证标记。本次修复后，静态 catalog 行和运行时模型解析都恢复了正常。

单一提供者冷却恢复

如果某个单一提供者（比如只有一个 OpenAI 账号）因为限速或错误进入冷却状态，系统现在会定期重新尝试探测该提供者是否已恢复，而不是永久标记为不可用。

其他提供者修复

  • Ollama：保留 catalog 元数据（如模型描述、参数大小）。
  • Gemini：正确去除路径中的 google/ 前缀。
  • Foundry Responses：推理重放的 ID 能幸存下来。
  • MiniMax M3：思考模式保持开启。
  • Vertex AI 多区域：调用时使用正确的区域主机地址。
  • OpenRouter：流式生成结束后，成本信息能被正确核算。

2.4 网关、移动端与桌面客户端

macOS 节点模式不再“自我重连”

某些情况下，即使 macOS 客户端已经通过直连方式与网关建立了健康会话，系统仍然会尝试重新配对到其他节点，导致会话频繁切换。本次通过限制节点配对请求频率，并优先保持已有直连会话，解决了这个问题。

iOS 和 Android 界面改进

  • Android：模型选择界面现在会清晰显示已过期、不可用、未解决等状态；支持主题模式切换（浅色/深色/跟随系统）。
  • iOS：诊断页面、网关连接行、附件标签、复制备用文本等控件即使在 Talk 标签页不可用时也能触达。

网关配置补丁语义修正

使用 config.patch 命令时，如果要对数组进行替换（而不是合并），新版本会严格遵循替换语义。例如原本 ["a","b"]，patch 为 ["c"]，结果只包含 "c"，而不会变成 ["a","b","c"]。

限流与探针警告去重

同一身份的网关探测警告不再重复输出，降低日志噪音。

2.5 存储与迁移：SQLite 逐步取代 JSON 文件

许多组件之前使用临时文件或 JSON 文件存储状态，容易在并发或异常退出时损坏。本次将以下数据迁移到 SQLite 管理的存储中：

  • Matrix 同步和加密辅助数据
  • 内存维基导入/源同步状态
  • 沙箱注册表状态
  • ACPX 进程状态
  • 设备配对通知状态
  • Zalo 托管媒体
  • 插件 SDK 去重状态

此外，认证配置文件（auth profiles）也完全存入 SQLite，读写更原子，避免手动编辑错误。

2.6 升级与运维：安全、可靠

定时任务（cron）迁移

旧的 cron JSON 存储文件在 doctor 预检阶段会自动迁移到 SQLite。这样在正式读取时不会因为文件格式不兼容而失败。

服务环境占位符处理

在规划服务环境变量时，如果发现某个变量值含有未解析的占位符（如 ${STATE_DIR}/.env 中引用了其他变量），系统会跳过它，避免覆盖掉已经存在于 state-dir 中的真实值。

WhatsApp 启动超时

启动 WhatsApp 连接时，如果超过设定时间仍未成功，会放弃并记录错误，不会阻塞其他渠道启动。

三、安装与升级方式

获取最新版本

你可以通过 npm 直接安装或升级到 2026.6.5：

npm install -g openclaw@2026.6.5

或者从 registry 下载 tarball：

wget https://registry.npmjs.org/openclaw/-/openclaw-2026.6.5.tgz
npm install -g ./openclaw-2026.6.5.tgz

验证完整性

本版本的 npm 包 integrity 校验值为：

sha512-sRgF0TexfRcJX8Eg0lcL6Jj0YdZbSxUbbp8EbG+qo3v6TtVayE6tKPEs3oCKD7YfYe2C/8Qg26HUxTnycd44ZQ==

你可以使用 shasum -a 512 比对下载的 tarball。

升级前注意事项

  • 如果你使用了 beta 版本的 SQLite 会话迁移，本次正式版暂不执行该迁移（仍在 main 分支开发中）。当前版本继续使用 JSON 后端的会话元数据，稳定可靠。
  • 建议在执行 openclaw doctor 之前，备份原有的 ~/.openclaw 或 state-dir 目录。

四、常见问题（FAQ）

问：Parallel 搜索插件是什么？我需要额外安装吗？

答：Parallel 是一个内置的 web_search 提供者。你不需要手动安装插件，只需在环境变量或配置文件中设置 PARALLEL_API_KEY，然后就可以在工具调用中使用 web_search。系统会自动发现该密钥并启用对应的端点处理。

问：我使用 Claude 模型，经常会话突然无法继续，这个版本真的修复了吗？

答：是的。2026.6.5 修复了两个关键点：一是等待 message_start 事件后才开始真正的流式处理，二是对于提示缓存过期或网关重启导致的签名错误，会触发重试恢复。如果你还遇到问题，可以在 GitHub 上提交 issue，引用 PR #90697。

问：我的 Google Vertex AI 配置以前能用，现在报“找不到模型”，怎么办？

答：这个版本恢复了静态 catalog 行和运行时模型解析。请确保你使用的认证方式（如 ADC 或服务账号 JSON）与环境变量 GOOGLE_APPLICATION_CREDENTIALS 一致。如果仍然有问题，检查一下 openclaw providers list 是否能看到 Google 的模型列表。

问：QQBot 输出内容里还是有 <thinking> 标签啊？

答：本次修复针对的是模型推理脚手架（比如某些模型显式输出的 <thinking> 结构）。如果你是指消息中其他类型的标记，可能需要检查 QQBot 插件的版本。建议在配置中确认 qqbot.stripReasoning 选项（如果有）已开启，或者升级插件到与核心匹配的版本。

问：我看到“auth profiles now live in SQLite”，那我之前的认证文件会丢失吗？

答：不会。首次启动 2026.6.5 时，系统会自动从旧的文件存储（如 auth-profiles.json）迁移到 SQLite。迁移完成后旧文件不会被删除，但不再使用。建议迁移成功后手动备份并删除旧文件以避免混淆。

问：我是 Windows 用户，Parallels 搜索测试报错说找不到 pnpm？

答：这是 CI 测试环境的问题，不影响运行时。实际使用 Parallel 搜索插件不需要 pnpm。如果遇到报错，请检查 PARALLEL_API_KEY 是否正确设置，以及网络能否访问 api.parallel.ai/v1/search。

问：Matrix 语音消息预检是什么意思？我需要写额外代码吗？

答：不需要。预检是指 OpenClaw 在内部处理 Matrix 事件时，会先识别事件是否为语音消息。如果是，并且你的机器人设置了“仅当被 @ 时才回复”，那么语音消息也会触发 @ 检查，而不是因为无法解析内容而忽略。这完全自动。

问：升级后，我的 cron 任务不见了？

答：请运行 openclaw doctor。该命令会自动将旧版 JSON 存储的 cron 任务迁移到 SQLite。迁移完成后，openclaw cron list 应能看到原有任务。如果依然丢失，请检查 ~/.openclaw/cron 目录是否有备份文件。

问：这个版本稳定吗？适合生产环境吗？

答：2026.6.5 是正式月度发布，经过了完整的 CI 验证（包括超过 30 项端到端测试、插件发布验证、升级存活测试等）。发布证据和验证报告均可公开查阅。对于多数使用场景，建议升级。但如果你依赖还在 beta 中的 SQLite 会话迁移功能，可以等待下一版本。

五、更多资源与致谢

本次发布包含来自社区 22 位贡献者的提交，特别感谢以下开发者的修复与功能：

完整的发布报告、CI 运行链接和 npm 包信息如下：

如果你遇到任何新版本的问题，请先在 GitHub Issues 中搜索是否已有类似报告（标签 v2026.6.5），或新建 issue 并提供日志与配置（注意脱敏）。

版本更新周期：从 2026 年 6 月起，OpenClaw 采用月度补丁编号（YYYY.M.PATCH），每月发布一个稳定版。下一个版本预计在 7 月上旬。如果你想体验最新开发功能，可以使用 main 分支，但生产环境建议跟踪月度 release。