OpenClaw 2026.3.2 更新日志

OpenClaw 2026.3.2 更新重点总结

🚀 主要新功能

• PDF 分析工具：新增对 PDF 文件的一流支持，原生适配 Anthropic 和 Google 的 PDF 处理能力，并提供降级提取方案及可配置参数（pdfModel、大小/页数限制）。
• 密钥引用全面覆盖：SecretRef 支持范围扩展至 64 个用户凭证相关场景（运行时收集器、plan/apply/audit 流程、初始化界面等），未解析的引用在活跃表面会快速失败，非活跃表面仅输出诊断信息。
• 多渠道出站增强：为 Discord、Slack、WhatsApp、Zalo、Zalouser 等渠道增加共享的 sendPayload 支持，实现多媒体迭代发送及分块文本回退。
• 会话附件支持：子代理运行时（sessions_spawn）支持内联文件附件（base64/UTF-8 编码），自动清理生命周期并受配置限制。
• MiniMax 模型集成：原生支持 MiniMax-M2.5-highspeed 模型，同时保持对旧版 Lightning 的兼容性。
• Ollama 嵌入支持：可将 memorySearch.provider 设为 ollama，使用 Ollama 生成记忆向量，复用现有模型配置。
• CLI 配置验证：新增 openclaw config validate 命令（支持 --json），启动前即可检查配置文件错误，错误信息包含无效键路径。
• Telegram 流式改进：默认启用 partial 流式传输（新安装）；私聊使用 sendMessageDraft 预览；新增 disableAudioPreflight 选项，可跳过语音消息的提及检测预转录。
• 工具差异输出增强：支持生成 PDF 格式的差异文件，并可自定义渲染质量（fileQuality、fileScale、fileMaxWidth），在消息渠道压缩图片时作为优选方案。
• 插件 SDK 扩展：向插件暴露更多运行时能力，包括 channelRuntime 上下文、音频文件转录（stt.transcribeAudioFile）、会话生命周期钩子（含 sessionKey）、事件订阅（onAgentEvent、onSessionTranscriptUpdate）及主动唤醒会话方法。

⚠️ 破坏性变更

• 新安装默认工具配置：tools.profile 默认值改为 messaging（原为包含系统/编码工具），新用户需显式配置才能获得广泛工具权限。
• ACP 分发默认启用：除非设置 acp.dispatch.enabled=false，否则 ACP 路由将始终参与消息分发。
• 插件路由注册方式变更：移除 api.registerHttpHandler，改用 api.registerHttpRoute 显式注册 HTTP 路由；动态 Webhook 需使用 registerPluginHttpRoute。
• Zalo Personal 插件重构：不再依赖外部 zca-compatible CLI 二进制，改为内置 zca-js 原生集成，升级后需重新登录。

🛠️ 关键修复

• Feishu 多项修复：多机器人群组中正确识别 @提及（避免误触）；/new 和 /reset 命令触发会话记忆重置钩子；群组系统提示实际生效；监控启动时预热去重状态，防止重启后重复事件。
• Telegram 稳定性：修复账户令牌缺失时的启动崩溃；插件命令名称/描述规范化，避免非法值导致启动失败。
• Discord 启动状态：在生命周期监听器附加前立即推送连接状态快照，避免状态翻转。
• Slack 格式化：增加文本规范化空值保护，防止未定义内容导致提及去除或格式转换崩溃。
• 网关安全加固：限制回环源开发允许仅为实际本地套接字客户端；对主机头回退添加警告；强化正则表达式超时防护；插件路由注册要求显式认证。
• 语音调用生命周期：修复端口占用导致的 EADDRINUSE 循环，确保启动失败后资源彻底清理。
• 浏览器/CDP 诊断：启动超时错误中包含 Chrome stderr 输出及 Linux 无沙箱提示，便于调试。
• Synology Chat：加强 Webhook 请求体读取限制（大小+超时），防止未认证慢速攻击。

此版本聚焦于扩展模型/工具支持、增强渠道稳定性与插件能力，同时引入多项安全加固和配置验证以提升运维体验。建议升级前查阅文档中对应的破坏性变更说明。