版本说明：安全补丁版，无新增功能，聚焦安全漏洞修复、稳定性问题修复；AI Agent 可直接读取原版：https://raw.githubusercontent.com/openclaw/openclaw/main/CHANGELOG/2026.11.3.md
发布规模：56 个 PR、44 次直接提交、36 位贡献者；PR 数量包含向后移植代码，直接提交统计为发布分支独立变更。
安全公告
本次版本修复：
-
工作节点传输时指纹为空场景下的证书校验问题 -
强制沙箱镜像预览越目录访问问题 -
凭证泄露风险
请升级 OpenClaw 获取以上安全修复。
本补丁解决的典型故障：升级后网关停止服务、低速存储下备份失败、敏感信息泄露，同时附带多项可靠性优化。
更新与维护模块
-
修复 Windows 网关运行态锁丢失问题：系统启动信息不一致时丢失锁 -
修复 Linux 下陈旧锁恢复失败：旧进程 PID 被工作线程复用，导致启动异常 -
修复非原生包更新卡在初始存在性检测超时：原有安装标识仍可读取时依然超时；从 2026.9.3 / 2026.9.4 升级被该超时阻塞的，需要按官方文档操作，仅选择新版本无法修复内置更新器 -
修复托管 macOS 网关：更新维护期间 LaunchAgent 后台服务未退出，导致网关异常重启；单独停止服务不再触发 SQLite 迁移误判数据库变更 -
修复大容量备份超时：原先所有文件共用同一个 SQLite 检索截止时间 -
修复部分中断的包更新错误上报为成功：无法保留中断状态与恢复路径 -
修复中断的托管更新 / 修复流程：恢复校验允许重启，但网关仍处于停止态；维护流程完成后网关仍无法启动 / 校验时，修复流程会给出手动启动和状态排查指引；网关恢复运行 ≠ 更新成功 -
修复 SQLite 校验超时产生误导性备份检索报错，引导运维查阅更新文档 -
修复低速存储场景备份、更新检索超时：大体积 SQLite 校验改为分批重试；单个文件持续超时仍会阻断备份；从 2026.10.10 / 2026.11.1 升级被该超时阻塞的，仅切换新版本无法修复内置更新器，需参考文档 -
修复聊天发起的续更流程：在插件执行前，已授权配置文件鉴权校验失败；已吊销请求方依旧拦截 -
修复更新修复流程被数据库变更阻断：Doctor 接管前后发生数据库写入，Doctor 无法自动恢复数据库（无法确认写入主体） -
降低大会话检索索引压缩修复时的内存占用，避免 OOM
消息通道
-
修复 Matrix 通道：@机器人消息中包含重复未闭合链接，在提及校验阶段卡死网关 -
修复长文本、大量标点消息在中止校验阶段卡死网关 -
修复 Tlon 通道：多条审批待处理时，所有者审批决策绑定到错误请求；多请求审批时必须带上请求 ID -
修复 Mattermost 目录检索：多账号共用 Token 时，漏掉独立服务实例或受网络策略影响的实例 -
修复 Teams 机器人：错误复用其他机器人缓存的父消息上下文
记忆模块
相关概念：compaction（记忆压缩）、memory embedding（记忆向量嵌入）
-
修复记忆压缩：注释行紧跟标记时，压缩逻辑误删除手写注释和对应段落 -
修复高频工具调用场景下的记忆压缩：决策信息、待办内容被挤出摘要；工具结果精简，更早上下文会被丢弃 -
修复记忆向量嵌入凭证跨提供者泄漏：无共享端点时，凭证被其他记忆提供者继承 -
保存共享记忆提供者配置变更时，保留对应 Agent 的记忆提供者独立设置 -
修复记忆提供者标识 none/auto大小写不敏感解析不一致问题
技能插件
-
修复网关延迟启动场景下插件技能加载丢失：插件根目录已在元数据登记，但技能未加载；替换元数据快照时清理废弃技能链接
模型与服务商
-
针对输出上限未知的模型，在上下文窗口内上调默认截断上限，减少回答 / 工具调用被截断； doctor命令可识别旧的上限配置（不会自动修改）；服务商返回超限报错时，手动配置maxTokens -
修复模型登录页隐藏 OAuth 刷新失败、密钥不可用报错；禁止绑定属于其他服务商的凭证 -
修复内嵌 Agent 任务：凭证查询 / 服务商鉴权卡住时，任务超时不终止；同时阻止鉴权晚于取消 / 超时后，再写入凭证 -
修复 Anthropic 模型调用：API 额度耗尽后仍反复重试，现在可触发配置的降级模型 -
修复 AI 包 TS 类型声明：OpenAI 命名空间别名被扁平化，保留原始类型结构 -
修复 Ollama 引导配置：云端别名选错响应上限，原有保存上限保留
自动化与调度
-
修复自动化规则转换丢失历史：开启「运行后删除」的退出型自动化转为间隔 / Cron 定时任务时，历史记录被误删 -
修复 Cron 调度恢复后，排队任务无法启动缺少告警：请求保持排队，网关输出错误日志
插件与集成
-
修复 Firecrawl 搜索：跨不同 API Key 复用缓存结果 -
修复 Exa、Tavily 搜索与抽取：禁止跨 API 凭证复用缓存 -
修复 ACP 应答任务：客户端重试消息或等待结果时，提前标记任务完成
安全与隐私（重点）
-
修复节点 TLS 指纹为空时，网关端点证书锁定配置失效 -
Twitch IRC 解析异常：不再将原始消息写入错误日志，仅保留解析失败标记 -
沙箱会话（含完全访问模式）图片预览：禁止读取允许目录以外文件；管理员可单独放行指定外部图片 -
Signal 托管守护进程环境变量裁剪：移除无关凭证继承；代理、信任库、自定义包装变量不再自动继承，需要通过 Java 属性、包装器或外部守护进程单独配置 -
Shell 动态断言 test和[ ]增加鉴权：补齐自动放行漏洞；带元字符的引号字面文件名同样需要审批，关闭审批时可能直接拒绝；命令解析器增加对 ANSI-C 转义引号、PID 前缀引号后未转义 glob 的捕获 -
修复工作节点传输 TLS 空指纹逻辑：空指纹走标准 CA 证书校验；非法非空 HTTPS pin 直接拒绝 -
修复配置读取泄露 env.vars明文；无法安全脱敏时屏蔽原始配置输出 -
修复会话准备阶段：会话订阅者、控制界面获取到私有补全文本和活动信息 -
限制服务商插件跳转能力：禁止插件将服务商连接劫持到非预期地址，降低凭证发往错误端点风险 -
内置语言服务器裁剪继承环境：默认不传递网关凭证；依赖旧环境变量的服务需要在插件包配置中放行或使用包装器 -
修复 Firecrawl 检索抓取：凭证和远端端点错误混用；依赖该混合逻辑的配置需要调整 -
Exa API Key 在错误回显时自动脱敏 -
修复仪表盘授权成员发送聊天消息：会话权限提前误判拒绝
使用体验优化
-
网关启动阶段减少文件加载（无历史会话数据的实例收益明显） -
修复应答准备丢失投递标记：丢失「自动发送 / 通过消息工具发送」标识 -
修复仅会话元数据变更时，会话回合被误报「策略已变更」拒绝执行 -
降低记忆索引、会话记忆预加载的启动开销 -
修复会话列表：会话执行完成后 Token 用量显示旧缓存数据
其他 Bug 修复
-
TUI 网关终端 /reset soft软重置：修复连带删除会话历史、丢失末尾消息；本地内嵌模式提示不支持软重置 -
Git 工作区准备：拉取修复流程异常时不再继续执行，上报清理状态不确定 -
修复子代理：子任务被取消替换、子代理执行完成后，父任务无法恢复 -
修复工具被拦截仅输出警告时，任务被错误标记成功 -
优化大历史输入会话的工作节点内存耗尽问题，同时保留回放校验记录 -
修复排队应答、 steer 动态更新时，无变更的会话权限、工具配置、记忆权限校验失败 -
修复网关空闲后重试已消费聊天输入，返回 UNAVAILABLE -
避免无关会话历史任务阻塞空闲消息发送回执 -
修复数据库校验在写操作阻塞时，会话历史读取失败