编者摘要：OpenClaw v2026.10.2 重点修复上一版本升级流程与 Doctor 自检修复缺陷，解决会话回复丢失、重复输出，完善长对话处理，修复大工具返回内容下凭证脱敏失效问题。本次共 80 个 PR、12 次提交，107 位贡献者参与。
安装层：升级脚本自动选用兼容 Node 运行时，规避版本误报。WebUI 新增语音听写稳定性优化，/stop命令增强队列清理；会话重连复用已加载插件，解决会话冻结。
更新维护是本次重头戏：修复 Windows/Linux 升级、备份校验、容器文件复制、数据库时间戳误判、旧会话迁移残留文件等大量修复项，完善openclaw health、openclaw update status运维命令。
模型侧全面增强长对话压缩（compaction），支持 OpenAI、Anthropic、Bedrock 服务商原生缓存；Claude CLI、ChatGPT 长流式输出截断问题被修复，本地 llama.cpp 部署前置环境校验。支持主模型配额冷却时使用降级模型做会话摘要。
消息通道优化 Telegram、飞书流式预览与错误提示，智能体间转发消息保留发送者上下文。自动化定时任务优化重启后插件加载，合并首页通知减少消息风暴。安全方面强化长文本凭证脱敏，修复密钥出口代理证书校验问题；同时修复浏览器标签回收、子助手结果交付、图片损坏处理、Windows 与 Rosetta 跨平台兼容性等各类边界场景缺陷。
6个关键问题 Q&A
- 升级重点风险？
2026.9.7 旧容器版本，需要手动 npm 装修复包一次，后续才能自动修复；旧版 CLI 升级仍会报模块缺失，用
openclaw update status查询真实状态。
- compaction 会话压缩变化是什么？
默认开启服务商原生检查点压缩，长对话在调用工具 / 审批前自动摘要；主模型限流冷却期，降级模型承担摘要，不更换会话选定模型。OpenAI 手动
/compact成本更高。
/stop和界面 Stop 按钮区别？
/stop在会话内清空排队后续任务；UI Stop 按钮、离线回放，只终止当前单次运行，不会清空排队任务。
- 凭证脱敏改进
拆分在超长工具返回文本里的密钥也会被识别脱敏，解决长文本处理卡死、栈溢出，降低内存开销。
- Claude 缓存能力
大文档 / 图片 / 工具交互后，Claude 依然复用历史缓存；Bedrock 自动匹配模型支持的缓存时长。
- macOS Rosetta 用户注意
Intel OpenClaw 在 Rosetta 可正常运行，但进程巡检类维护操作，仍然需要原生 arm64 Node。
附录 OpenClaw v2026.10.2 版本更新说明
原始版本文档地址：https://raw.githubusercontent.com/openclaw/openclaw/main/CHANGELOG/2026.10.2.md 本版本重点：修复从 2026.10.1 升级、Doctor 自检修复流程的各类报错；解决回复丢失 / 重复问题，优化长对话能力；修复大工具输出场景下凭证脱敏失效问题。 本次迭代规模：80 个 PR、12 次直接提交，107 位贡献者。
一、安装与初始化
- 安装阶段 Node 运行时
恢复安装场景，优先使用 OpenClaw 自带兼容 Node 版本，即便系统 PATH 里旧 Node 靠前，避免脚本版本误报错误。参考文档：https://docs.openclaw.ai/install/node -
PR#164677，感谢 steipete、jarvisnextgeneration20-lang
二、Web 界面
- 仪表盘对话回复
日常闲置重置后聊天可正常应答，解决后台标题任务阻塞回复；委托等待类后台命令不会重复输出最终答案。PR#162689 / #166362 - 语音听写
长按麦克风录音，松开不再提前终止录制；可连续说话，手动点停止后插入转写文本。PR#166843 - 打开 / 重连会话
加载可用工具时，复用已运行兼容大型插件，避免重复加载造成会话卡死、请求阻塞。PR#167374 - 文本停止命令
/stop在非全局会话中输入 /stop，会清空排队后续任务 + 当前执行任务，等待中的消息不会立刻重启智能体；界面 Stop 按钮、离线回放仅终止单次运行。参考文档：https://docs.openclaw.ai/web/control-ui/chat，PR#167860
三、更新与维护（本版本核心修复模块）
- 从 2026.10.1 升级
首次升级稳定版 2026.10.1，修复包替换后的清理报错；Windows 升级可完成旧更新器无法调用的最终插件校验。PR#168849 / #169031 - Windows 更新校验
不再因启动器启动方式误判合法更新；备份校验支持文件夹短名称、大小写兼容识别。PR#166530 / #168968 - 更新清理 CLI
更新成功后清理阶段不再报模块缺失错误；旧版 CLI 首次升级仍会出现该提示，可使用新命令 openclaw update status查询升级结果。文档：https://docs.openclaw.ai/cli/update，PR#165233 - 更新 & 修复报告
历史标记成功的更新，不会因为结果展示失败误报更新失败；可选配置降级提示改为警告；修复报告会提示处于停止状态的会话账号，可用 openclaw health --json排查。文档：https://docs.openclaw.ai/cli/update/repair-and-recovery，PR#169037 / #165539 - 容器文件拷贝
容器禁止克隆文件时，改用字节复制完成更新。2026.9.7 版本用户需要手动 npm 安装修复包，后续更新才可自动修复；建议保持原生文件系统防护。PR#165257 - 工作区头像
更新校验不再拒绝工作区内合法绝对头像路径；旧更新器仍建议使用相对路径如 avatar.png。PR#164638 - 容器替换后的 Doctor 自检
容器退出替换后，Doctor 会等待旧网关锁过期继续修复；修复流程不再触发虚假 “离线维护中” 拦截。文档：https://docs.openclaw.ai/cli/doctor/recovery，PR#165355 / #165417 - Linux 修复校验
数据库内容未变仅时间戳改动，不再触发更新 / 恢复拦截；数据库慢校验避免 Doctor 停止网关维护前，出现虚假服务管理器超时。PR#165775 / #168161 - 旧会话历史修复
Doctor 清理残留会话文件时，保留当前对话标签和活跃会话；冲突原始文件会保留用于恢复，警告 / 归档不等于历史已导入或可直接删除。提交哈希：329857b / 80117e8 - 残留迁移文件
Doctor 归档已删除通道账号的旧发送列表，继续修复；内存索引锁文件不再对健康数据库反复抛出恢复告警。损坏账号文件、真实恢复锁仍需人工处理。文档：https://docs.openclaw.ai/cli/doctor/state-migrations，PR#167651 / #166517 - 维护被拒后的重启
检测版本已是最新但网关为维护而停止，在恢复安全后自动重启服务；维护任务仍标记失败。用户手动停止、存在数据风险而停止的服务，保持停止状态。PR#166548
四、消息通道
- 启动阶段消息
消息等待对应智能体启动完成；已经就绪的智能体独立正常应答。PR#168826 - Telegram 预览
替换回复未就绪 / 被拒绝时，旧预览文本保持可见；替换成功后清除旧预览，即使最终发送失败也保留有效文本。文档：https://docs.openclaw.ai/channels/telegram/messaging，PR#164649 - Telegram 发送失败提示
账号归属未解决导致本地拦截回复时，给出准确失败提示，不再是不确定送达告警，需要修正账号归属配置。文档：https://docs.openclaw/openclaw/gateway/doctor/config-migrations#channel-ownership-during-an-update，PR#167470 - 飞书流式输出
跳过过时等待预览，避免完整回复被旧版本阻塞。PR#166610 - 智能体间消息转发
回放消息保留原始发送者标签，A 智能体转发他人消息时，接收方可在后续轮次保留完整上下文。PR#169130
五、记忆模块
- 工具搜索记忆召回
工具搜索记忆时，支持设置相关性分数阈值、结果数量限制，不再报错。PR#158632 - 长对话前置摘要压缩
长对话场景，在处理工具返回结果 / 审批跟进前执行会话压缩（compaction），不切换会话选用模型。文档：https://docs.openclaw.ai/concepts/compaction，PR#163117 - 应答中途修正上下文
上下文引擎开启时，在 AI 输出过程中发送修正指令，该轮对话会正常存入会话上下文，不会丢失。PR#168394
六、模型与服务商
- 服务商侧会话压缩
OpenAI Responses 接口、Anthropic 密钥会话默认启用服务商托管检查点压缩长对话；Anthropic 会话在服务商拒绝检查点后可在下一轮恢复。手动 /compact本地开销更高，文档包含路由限制、降级、关闭选项。文档：https://docs.openclaw.ai/concepts/compaction，PR#168164 - 模型限流冷却期压缩
主模型配额耗尽进入冷却时，配置的降级模型可执行会话摘要，不修改会话选定模型；手动指定压缩模型保持不变。PR#166459 - Claude CLI 压缩
Claude Code 自动轮后压缩独立生效，规避 Anthropic 密钥报错，维持原生会话连接；手动 /compact为独立逻辑。文档：https://docs.openclaw.ai/gateway/cli-backends，PR#162066 - Claude CLI 长回复
修复大量流式分片场景下，Claude CLI 任务完成丢失最终报告的问题。PR#153545 - Claude CLI 会话历史导入
导入历史避免消息、转发内容重复，保留发送人信息；后台指令不会被识别为用户消息，大工具输出归类为工具活动，原始转录数据完整保留。PR#163521 / #166080 / #168851 - ChatGPT 订阅长 HTTP 回复
HTTP 通道长回复不再因流式总数据量截断；WebSocket 原生会话连接超时后，可基于已保存会话恢复继续输出。PR#166853 / #167063 - Codex 会话启动
关闭闲置后台终端线程，不阻塞后续轮次；卡住的启动等待可被取消，遵守请求预算。PR#166693 - Codex 服务商异常
工具执行完成后服务商报错会展示恢复建议，不会仅显示静默停止；已完成动作不会重复执行，Stop 指令仍直接终止任务。PR#165488 - 代码模式任务
模型复用旧请求编号时，长 Code Mode 任务可持续调用工具；Node 命令错误提示会说明如何在目标机器执行 shell。PR#165210 - OpenAI 工具兼容性
插件 / MCP 工具输入规则存在特定模式（即使未启用该工具），OpenAI 调用不再直接失败。文档：https://docs.openclaw.ai/providers/openai/advanced，PR#166999 - 本地模型应答
严格遵循 Chat Completions 模板的本地模型，后台通知不再触发消息格式报错，可持续回复。PR#167309 - 自定义 Bedrock 路由
自定义 Bedrock 服务商 ID 请求正常访问 AWS，使用路由配置区域。文档：https://docs.openclaw.ai/providers/bedrock，PR#164406 - llama.cpp 本地部署
下载模型文件前校验服务可用性，无法启动时给出替代方案；macOS 托管二进制最低要求 macOS13.3，旧 Mac 可对接外部自定义服务。提交哈希 e0de4147026d54096ace25a4785fa30fb50db575 - 加载已保存会话模型
打开存档会话、修改会话设置时，加载模型列表不再无限卡死；超时支持重试，不会残留半创建会话、延迟应用错误配置。PR#166089 / #166376 - 启动阶段模型列表变更
：启动校验和执行之间模型列表发生变动，不再拒绝会话 / 定时任务启动。PR#168410 - 降级与消息持久化
：首请求失败后自动切换备选服务商重试，原始消息不变；智能体间消息回放保持原文与发送上下文。提交哈希 9def9c191a7d2947194259f010658d83870bbfec、36f630504df528ad70675238f90e4021cfcea6e0 - Claude 历史缓存
文档 / 图片 / 大量工具交互后，Claude 可复用符合条件的历史缓存；Bedrock 自动选用模型支持的缓存时长。文档：https://docs.openclaw.ai/reference/prompt-caching，PR#168042 - 会话历史缓存
重新打开会话，保持模型看到的工具结果精简文本；浏览器会话可复用缓存文本，Claude 缓存不会附带临时一次性指令。PR#168392
七、自动化与定时任务
- Codex 最大思考量
定时任务、Webhook 触发轮次，会读取 max-thinking 配置，不再静默使用模型默认思考力度（模型支持该参数时生效）。PR#165444 - 重启后条件校验
网关重启后的首次定时脚本校验，不重复加载已加载插件，解决网关其他任务超时卡顿。文档：https://docs.openclaw.ai/automation/cron-jobs/schedules，PR#166991 - 手动启动任务权限
聊天会话启动自动化任务，会话结束后任务仍能使用授权工具；任务权限独立保存，禁用 / 删除任务会终止运行。PR#168037 - 首页通知优化
批量新建会话不再为每个会话单独推送通知，多条新会话合并为一条汇总通知，保留提醒类消息通道。文档：https://docs.openclaw.ai/concepts/main-session#what-flows-into-the-main-session，PR#168239
八、浏览器与电脑操作
- 托管浏览器标签回收策略
：达到标签上限时，优先清理未跟踪、较早页面，最近使用会话标签延后回收，符合条件最旧会话标签仍会被清理。PR#166666
九、插件与集成
- 插件授权等待
插件工具等待用户审批时，不会提前判定超时取消；未应答请求仍会超时失效。文档：https://docs.openclaw.ai/plugins/plugin-permission-requests，PR#161821 - 长工具会话上下文
上下文引擎插件，工具持续调用时维持历史在模型上下文窗口内，避免上下文超限报错；超大工具输出依然会超出限制。PR#166120 - Codex 模型发现清理
模型探测超时会释放后台进程，避免内存持续累积；后续任务可以新建进程。文档：https://docs.openclaw/openclaw/plugins/codex-harness-runtime/recovery，PR#168365
十、安全与隐私
- 凭证脱敏
长工具输出中被拆分的密钥凭证也可正常脱敏；长文本 / 重复文本脱敏不再冻结、栈溢出，在原有规则下降低计算开销。PR#161480 / #166701 - 密钥代理 HTTPS 命令
使用出口密钥代理执行 HTTPS 请求，新证书不再触发严格证书校验失败，包含 macOS 上 Python 命令。升级后重启网关并新建命令；建议保持证书校验开启，旧调试代理证书不变，仍可能校验失败。提交哈希 f1cd78c7ec954542db26ee965adae4fb8baab309
十一、体验优化
- 配置错误提示
助手启动失败，直接输出真实启动错误和受影响文件，不再返回无关 trim 报错。PR#165373 - 文件 / 控制台日志
日志、JSON 控制台输出密钥脱敏，临时内存占用降低，脱敏逻辑不变。PR#167943
十二、其他 Bug 修复
- Windows 带引号命令
Windows 节点命令包装器，正确保留带空格的多词参数、URL、程序路径。PR#158160 - Apple Silicon Rosetta 兼容
：Intel 版 OpenClaw 在 Rosetta 下运行，使用 Git 处理工作区，规避原生进程检测崩溃；进程巡检维护任务仍需要 arm64 原生 Node。PR#165088 - 子助手应答
ACP / 共享 CLI 降级子助手，完整长报告结果传回主智能体；延迟旧结果不会覆盖新确认答案。文档：https://docs.openclaw.ai/tools/subagents/announce，PR#165800 / #166139 - 子助手返回结果应答
子助手交付超时，主智能体依然可处理子助手返回结果，不会丢失最终回复；任务总时限、Stop 指令依旧生效。文档：https://docs.openclaw.ai/concepts/subagent-yield-handoff，PR#164282 - 后台工具任务状态
后台工具执行成功后，不会因为后续模型输出达到上限，将整个任务判定为停滞取消。文档：https://docs.openclaw.ai/concepts/queue，PR#166997 - 图片处理
图片解码器可用时，损坏图片会从请求中剔除，保证后续文本对话继续；丢失旧图片会给出中性提示，不会让 AI 拒绝历史图片检查。PR#166564 / #166165 - 会话上下文持久化
提示钩子 / 替换提示追加到消息的上下文，跨轮次、会话重开后保留；聊天界面保持用户原始输入。子助手返回后的应答，保留主会话指令，减少本地模型重复提示处理。PR#167938 / #167898 - Node 工作进程强制终止
强制停止 Node 工作节点时，终止残留子进程，清理完成后释放任务槽位。文档：https://docs.openclaw.ai/gateway/background-process，PR#168746