OpenClaw v2026.3.2：新增 PDF 分析工具、Telegram 流式传输优化与多项改进

新功能

PDF 分析工具

新增原生 pdf 工具，支持 Anthropic 和 Google PDF 提供商的原生 PDF 处理。对于不支持原生 PDF 的模型，自动降级到文本提取。可配置默认选项：agents.defaults.pdfModel、pdfMaxBytesMb、pdfMaxPages。

Secrets/SecretRef 覆盖扩展

SecretRef 支持扩展到 64 个目标，覆盖运行时收集器、openclaw secrets 规划/应用/审计流程、onboarding SecretInput UX 等。未解析的引用在活跃表面会快速失败，非活跃表面报告非阻塞诊断。

MiniMax 高速模型支持

新增 MiniMax-M2.5-highspeed 模型支持，同时保持旧版 MiniMax-M2.5-Lightning 的兼容性。

Sessions 内联附件

sessions_spawn（subagent 运行时）新增内联文件附件支持，支持 base64/utf8 编码、内容脱敏、生命周期清理和可配置限制。

CLI 配置验证

新增 openclaw config validate 命令（支持 --json），可在 Gateway 启动前验证配置文件，并在启动错误中包含详细的无效键路径。

Memory Ollama Embeddings

新增 memorySearch.provider = "ollama" 和 memorySearch.fallback = "ollama" 支持，可直接使用本地 Ollama 进行内存嵌入。

Telegram 改进

流式传输默认启用

新安装的 Telegram 配置默认 streaming = partial，开箱即获得实时预览流式传输。

DM 流式传输优化

私聊预览使用 sendMessageDraft，在 DM 推理流模式下保持推理/回答预览通道分离。

语音提及门控

群组/主题配置新增可选 disableAudioPreflight，可跳过入站语音消息的提及检测预检转录。

插件与扩展

Zalo Personal 插件重构

使用原生 zca-js 集成重建通道运行时，移除外部 CLI 依赖，QR 登录 + 发送/监听流程完全在 OpenClaw 内部运行。

Plugin SDK 改进

• ChannelGatewayContext 暴露 channelRuntime，外部通道插件可访问共享运行时辅助函数
• 新增 api.runtime.stt.transcribeAudioFile(...) 用于音频转录
• 新增 runtime.system.requestHeartbeatNow(...) 用于立即唤醒目标会话
• 新增 runtime.events.onAgentEvent 和 runtime.events.onSessionTranscriptUpdate 用于事件订阅

Outbound 适配器

Discord、Slack、WhatsApp、Zalo、Zalouser 等通道新增共享 sendPayload 支持，支持多媒体迭代和分块感知文本回退。

破坏性变更

Onboarding 工具配置默认值

新本地安装默认 tools.profile = messaging，不再默认启用广泛的编码/系统工具，除非显式配置。

ACP Dispatch 默认启用

ACP 调度现在默认启用，除非显式设置 acp.dispatch.enabled=false。

Plugin SDK HTTP 处理器变更

移除 api.registerHttpHandler(...)，插件必须通过 api.registerHttpRoute({ path, auth, match, handler }) 注册显式 HTTP 路由。

Zalo Personal 不再依赖外部 CLI

升级后需要运行 openclaw channels login --channel zalouser 刷新会话。

Bug 修复

• 飞书：修复出站渲染模式问题，现在正确尊重账户的 renderMode 配置
• 插件命令：规范化插件命令名称/描述验证，防止格式错误的命令规格导致启动崩溃
• Telegram：修复重复令牌检查和 Gateway 启动时的令牌规范化，防止 token.trim() 崩溃
• Discord：修复生命周期启动状态，在调试监听器附加前推送已连接状态快照
• 飞书入站提及：保留所有入站提及语义，规范化飞书提及占位符

其他改进

• Tools/Diffs：新增 PDF 文件输出支持和渲染质量自定义控制
• CLI Banner：新增 cli.banner.taglineMode（random | default | off）控制启动输出的趣味标语
• Media/Audio Echo：新增可选 tools.media.audio.echoTranscript 发送转录确认消息
• Hooks：新增 message:transcribed 和 message:preprocessed 钩子事件，message:sent 包含更丰富的上下文

完整更新日志请查看 GitHub CHANGELOG。