编者摘要：OpenClaw v2026.10.3 以升级链路稳定性为核心，解决大量升级阻塞、旧更新器锁死、Windows/FreeBSD/pnpm 环境包修复问题。Doctor 诊断工具现在会保护登录凭证、记忆文件、插件配置，修复前自动备份 Canvas 文档与 Memory Core 记忆文件。 Mac 客户端重点修复本地网关鉴权报错，证书更新自动重连；模型侧新增 Muse Wonder、MiniMax M3.1 Flash 预览模型，支持多档位思考强度。增强模型应答中断恢复，ChatGPT、压缩历史场景支持对话续传，DeepSeek 过滤内部工具标记，新增 IPv6 网络降级策略。 插件系统保护被路径安全拦截的插件配置，Codex 旧版本提前拦截避免对话崩溃；Webhook 回调、节点配对逻辑优化。内存文件可处理畸形 UTF-8，防止记忆合并失败丢失原始内容。网关重启、云远端 worker 处理逻辑优化，提升运维稳定性。
10 个关键问题 Q&A（运维 / 开发者场景）
- Q：OpenClaw v2026.10.3 本次最核心的改进是什么？
A：重点解决大量升级阻塞问题；Doctor 诊断修复时自动保护登录凭证、Memory 记忆文件；支持对话压缩、服务商连接中断后的对话续传，大幅提升跨平台升级稳定性。 - Q：升级卡住、旧更新器锁死，该执行什么命令处理？
A：等待更新进程结束，执行 openclaw doctor --fix清理废弃更新器副本；若为历史中断升级，参考文档包恢复方案，保留恢复日志与快照。 - Q：Mac 客户端提示 “Gateway rejected auth” 网关鉴权拒绝，新版本能否解决？
A：可以。v2026.10.3 修复「On this Mac」本地部署场景该鉴权报错；网关证书更新后 Mac 客户端还支持自动重连。 - Q：MEMORY.md 记忆文件出现 UTF-8 格式异常合并失败，会丢失数据吗？
A：不会。Doctor 会保留原始文件字节，不会直接覆盖损坏文件；需要备份原文件，转码为标准 UTF-8 后再重试合并。 - Q：新版本新增了哪些大模型，有什么能力？
A：新增 Meta Muse Wonder（图文输入 + 深度思考）、MiniMax M3.1 Flash Preview，支持 5 档思考强度，预览版默认 max 思考；原有 Spark1.3 保持默认。 - Q：ChatGPT 连接中断、应答没跑完，现在能续对话吗？
A：可以。正常连接关闭造成的中断，在重试限额内，基于已保存会话上下文继续生成回复。 - Q：pnpm 环境升级替换包文件夹，会破坏网关服务命令吗？
A：修复后新 / 重建网关服务使用 pnpm 持久化链接，替换版本包目录不会损坏服务；旧绑定旧目录的命令需要修复或重规划。 - Q：Doctor 执行修复的时候，已保存的账号登录凭证会不会被清空？
A：不会。本次修复：旧鉴权文件无法读取时，不再自动删除 OAuth 登录档案；但已手动删除的凭证无法恢复。 - Q：本地插件被路径安全检查阻断，升级会清空插件配置吗？
A：不会。插件启用状态、设置、策略全部保留，插件仅保持阻断状态，直到路径安全问题修复完成。 - Q：升级前有什么必须注意的风险点？
A：①很多底层修复必须使用新版更新器来启动升级；②存在待迁移任务时，先跑完 openclaw doctor --fix再重启网关；③升级修复前会自动生成快照，但旧快照不会自动补新增的 Canvas/Memory 文件。
附录 OpenClaw v2026.10.3 发行说明
原文：Release notes v2026.10.3 AI 智能体与工具可直接读取这份更新日志：https://raw.githubusercontent.com/openclaw/openclaw/main/CHANGELOG/2026.10.3.md
OpenClaw 2026.10.3 版本修复了多项升级阻塞问题；在执行 Doctor 诊断修复时，保留已保存的登录凭证与记忆文件；解决 Mac 客户端本地部署连接故障；同时修复对话压缩、模型服务商应答中断场景下的对话续传能力。 本次版本规模：79 个 PR、8 次直接提交，97 位贡献者参与。
一、更新与维护模块 Updates and Maintenance
- 升级阻塞问题修复
升级程序可清理残留恢复任务、归档已完成升级记录（这类旧记录会阻断后续升级）。已经被卡住的旧版更新器，需参考文档包发布恢复方案；也可通过工具保留已完成记录，解除旧更新器锁。 - 2026.9.8 中断升级修复
更新后的 CLI 工具可处理中止的升级记录。该旧恢复链路在无法二次校验包内容时会给出告警，需保留恢复证据，按修复文档操作。 - FreeBSD 软件包恢复
修复后的更新器恢复助手，可修复 / 终止 FreeBSD 平台中断的 npm 包更新。旧助手仅支持状态查询；包恢复操作与网关重启、网关校验相互独立。 - 残留更新器副本清理
Doctor 诊断工具可清理废弃的 npm 更新器副本（该副本会阻止升级）。操作步骤：等待更新进程执行完毕，在目标安装目录执行 openclaw doctor --fix，再重试升级；保留恢复日志与权限不变。 - 旧更新器的候选版本校验
不再仅仅因为 Doctor 会更新版本 / 配置 / 迁移台账就拒绝新版本候选包；真实配置修复与数据迁移逻辑保持原有流程。 - 旧版 Node 更新器时间判断
新旧升级进程时间计算逻辑不一致，曾误把合法升级判定为丢失任务；本次修复避免不必要的版本回滚。 - 聊天内触发升级
修复 Doctor 清理校验误判权限、回滚对话中发起的升级请求的缺陷，该问题有时会导致插件升级不完整。 - 升级过程中的 Doctor 诊断
当更新器本身校验通过，后续进程检查失败时，Doctor 仍可继续执行；新建命令记录失败场景下，确认进程停止后自动清理，避免残留任务阻塞后续修复。 - Windows 服务账户
升级程序识别同一服务账户在任务计划程序里的不同名称；重启网关时，不会重写不属于当前用户的服务。 - Windows 升级与恢复路径
更新器识别安装目录短名称、大小写差异；恢复快照不再拒绝 Windows 自身临时目录。路径修正依赖新版更新器先安装再执行升级。 - pnpm 服务命令
新建 / 修复网关服务命令使用 pnpm 持久化安装链接，替换版本化包文件夹不会破坏服务；升级规划可识别嵌套 pnpm 路径的安装。旧命令若绑定旧文件夹，需要修复或重新规划。 - pnpm 12 启动器
原生 pnpm 更新修复后，分阶段清理后 openclaw命令仍可用，全局 bin 软链接场景也支持。已损坏命令需要手动修复或备份后使用备选安装方式。 - 服务刷新拒绝逻辑
当系统判定不适合重写网关服务定义时，可安全拒绝改写并保留原有服务并重启；重启仍要求原有定义、服务所有权校验通过，保留自定义配置。 - 数据库繁忙状态
不再仅因数据库短暂繁忙终止升级；升级历史写入减少阻塞网关业务的时长。强制恢复写入仍不可跳过；该驱动层优化需要新版更新器启动升级。 - 无关依赖拷贝
升级不再拷贝外层无关环境依赖，也不会扫描无关 npm 全局工具；需要新版更新器执行升级。 - 配置内存限制继承
使用服务配置的升级命令，会保留预先配置的 Node 内存上限，包含 Shell 单独设置的内存覆盖参数。依赖新版更新器。 - 修复结果与后续指引
Doctor 未完成维护任务标记为 “待处理” 并给出明确操作；数据迁移失败场景指向对应的修复命令。保留新安装文件与恢复快照；修复任务未稳定期间按提示停止网关。 - 升级交接报告
已上报的升级结果不会重复抛出误导性失败；后台助手已接受的升级任务保持 pending 状态。通过状态与健康命令查询最终结果。 - 升级告警详情优化
恢复拷贝告警会标注受影响数据库；候选配置读取失败会输出详细错误，且不改动原有服务定义。 - Git 升级清理
进度上报失败时，临时工作树清理逻辑继续执行；原始错误保留并附带辅助诊断信息。无法确认升级进程停止时，保留恢复文件并终止升级，依赖新版更新器。 - 迁移告警与校验计时器
插件迁移完成后，不再展示过时的未完成告警；系统时间变更时，包校验的截止时间保持不变；真正待处理迁移任务依旧提醒用户。 - 修复前自动创建恢复副本
迁移前的恢复快照包含旧画布文档与 Memory Core 记忆文件。Doctor 和升级恢复不再因后台数据库维护修改文件而拒绝备份。代理列表为空时，升级校验也可正常运行。已有旧快照不会自动补全新增文件。
二、消息模块 Messaging
- 重启后的通道工具
对话 / 运维任务启动、重启的消息账号，任务结束后通道工具持续可用；每一轮对话依旧执行权限校验。 - 正在发送中的消息
恢复扫描保留消息的发送者上下文，修复竞态条件导致排队消息发送失败问题。 - 网关重启后继续受控对话
只要原始授权源有效，人工对话在修正配置 + 网关重启后可恢复。已失败会话不会自动重开，丢失发送者权限不会自动重建。
三、记忆模块 Memory
- 记忆文件修复
当内存文件 MEMORY.md与旧版memory.md因畸形 UTF-8 编码无法合并时，Doctor 保留原始字节。保留原文件 / 归档，转为 UTF-8 后重试合并。
四、原生客户端 Native Apps
Mac 客户端
- 本机部署连接修复
解决 “本机部署” 场景网关鉴权拒绝的报错，减少多余前置等待。无法保存新令牌时，安装流程终止并返回可重试错误。 - 证书续期自动重连
网关可信证书更新后，Mac 客户端自动重连；自动学习指纹可随信任校验更新，手动指定的指纹保持固定不变。 - 升级恢复状态校验
识别受保护的 Bun 网关命令，修复网关健康但恢复页面卡死问题；保护启动参数、所有权校验机制保留。
五、模型与服务商 Models and Providers
- Muse Wonder
Meta 用户可选择 Muse Wonder，支持图文输入与深度思考模式。Spark 1.3 Standard 同样支持深度思考，并保持默认；API 支持 Wonder Standard；max effort 模式不会自动选用 Wonder Full。 - MiniMax M3.1 Flash Preview
符合条件的 Token 套餐或 MiniMax Code 用户可选用预览模型；支持低 / 中 / 高 /xhigh/ 最高五档思考强度，预览版默认最高。M3 依旧为默认模型。目录标价缺失≠免费使用。 - MiniMax 登录令牌续期
全球与中国区 OAuth 登录会在对应区域账号端点自动更新过期令牌。旧登录凭证、跨区域切换，需要手动执行登录命令刷新。 - 原生压缩后的模型应答
等待对话历史重建可读之后再返回下一条消息，避免历史压缩阶段直接报错。 - ChatGPT 中断应答续传
正常连接关闭导致 ChatGPT 应答中断时，在重试限额内，可基于已保存对话继续生成回复。 - Codex 后续消息
对话准备失败时，兼容的后续消息仍可继续处理，后台命令持续运行；权限 / 策略变更会拒绝不合法操作。 - 切回 OpenAI 模型
Codex 插件禁用时，OpenAI 模型可复用内置运行时（前提运行时兼容 OpenAI）；手动指定 Codex 运行时则仍需要开启 Codex 插件。 - Claude CLI 工具发现
Claude CLI 可读取注册在 OpenClaw 内的工具名称与应答指引，减少工具查找失败；仅加载当前对话具备权限的工具。 - Claude CLI 会话工具
一轮连接任务结束后，后续对话保持授权会话、历史记录与管理员工具；每个调用方独立权限与吊销校验。 - Copilot 提示词容量
无原生上限的模型，采用账号返回的真实提示上限，不再固定使用 128K 估算值；可刷新缓存重新获取。 - DeepSeek 应答与工具调用
内部工具标记不会混入最终回复；托管会话可恢复合法工具调用（包含 calls 包装块）。直接服务商调用、最终回复会过滤标记，畸形 / 未完成标记块会隐藏且不执行。 - IPv6 服务商降级
IPv4 不可达且 Node 开启地址族自动选择时，模型请求自动尝试可用 IPv6 地址；配置的网络安全校验依旧生效。
六、自动化与调度 Automations and Scheduling
- 一次性任务优化
一次性任务时间戳正确时，Doctor 不再重复创建冗余恢复备份；真正修复场景仍然保留备份保护。
七、插件与集成 Plugins and Integrations
- 本地插件设置保护
路径安全校验拦截的插件，Doctor 与升级流程保留插件启用状态、配置与策略；插件保持阻断状态，直到路径问题修复。 - oc-path 文件编辑
oc-path 可选插件在写入文件前，校验非法 UTF-8，拒绝 openclaw path set非法编辑，保留原始字节；需备份修复文件后重试。 - 升级期间 Webhook 回调
延迟替换插件前，保留官方 Webhook 通道回调（含 Microsoft Teams）；自定义回调与退出设置依旧生效。 - 原生插件目录
目录刷新不再重复加载未变更的已安装原生插件，缓解内存持续上涨；刷新失败时，下一次请求使用目标配置。 - 配对节点命令
更新配对信息、写入其他设备配对配置时，未变更的已连接节点可持续处理命令、请求与事件；凭证吊销、令牌轮换依旧切断旧连接。 - Codex 插件兼容性
早于 2026.9.7 的官方外部 Codex 包会标记不可用，避免破坏对话。合格版本跟随核心版本升级；失败返回详细原因。可使用 openclaw update repair或openclaw plugins update codex。存在待迁移任务时，完成 Doctor 诊断后再重启。 - 插件包修复
数据包迁移未完成时，仍可保存插件替换包，允许 Doctor 继续执行。必须执行完 openclaw doctor --fix再重启 / 重载插件。自动选择 ClawHub 版本不可用时，可使用同版本可信 npm 包，或保留兼容代码并输出重试告警。删除插件条目会保留备份与待迁移任务。
八、安全与隐私 Security and Privacy
- Doctor 修复时保留登录凭证
无法读取的旧鉴权文件不再让清理流程删除 OAuth 账号配置。Doctor 识别文件，用户可检查或恢复后重试；已经删除的凭证、废弃导入凭据不会自动恢复。
九、使用体验优化 Quality-of-Life Improvements
- 云工作节点不可访问时重启网关
网关停止 / 重启操作可以延后停止不可访问的远端云节点并上报该延迟；远端机器不会立刻停止或删除，后续仍需要清理。
十、其他 Bug 修复 Other Bug Fixes
- 删除未完成对话
删除会话会先记录取消状态，再终止正在生成的应答，聊天客户端可收到会话已取消状态。