.png)
本次更新速览
📁 配对节点的文件传输
🧭 支持 /steer 与 /side 实现智能体实时控制
🔌 插件安装与升级已做强化加固
🛠️ 修复通道及版本升级相关问题
重磅版本更新，日常细碎小问题大幅减少。
详细更新日志
新增功能
1、文件传输插件（New!）
新增内置 file-transfer 插件，含 file_fetch、dir_list、dir_fetch、file_write 工具
默认拒绝策略：每节点路径需 operator 审批，符号链接默认不允许，单次上限 16MB
2、统一进度草稿流
新增 streaming.mode: "progress" 统一配置，支持 Discord、Telegram、Matrix、Slack、Microsoft Teams
自动单字状态标签，共享进度配置
3、命令增强
/steer <message>：队列独立式当前会话运行指令，会话空闲时不开启新轮次
/side：新增为 /btw 旁路问题的文本和斜杠命令别名
4、Agent 工具优化
当工具拒绝列表已屏蔽时，跳过可选的媒体/PDF 工具工厂，减少热路径性能开销
沙箱容器/浏览器注册表改为每运行时分片文件，降低锁竞争
tools.deny: ["write"] 不再隐式拒绝 apply_patch，需显式拒绝
5、配置与诊断
doctor --fix 现在即使存在无关验证问题（如插件缺失），也会提交安全的遗留配置迁移
Gateway 启动和热加载不再自动恢复无效配置 → 失败关闭，由 doctor --fix 负责恢复
新增树形语法解析器（tree-sitter）支持的 Shell 命令解释器（为未来审批/审查界面准备）
6、网络与代理
允许受信任的 Web 搜索提供者和模型提供者主机在 Surge/Clash/sing-box fake-IP DNS 下工作
Provider 代理设置：无显式调度器策略时，遵从 env-proxy 设置
web_fetch 新增 tools.web.fetch.useTrustedEnvProxy（默认关闭），支持代理专用环境
7、QA 测试框架
新增 Mantis Discord-Smoke QA 运行器和 GitHub 手动工作流
新增 Slack 直播传输 QA 运行器（canary + mention-gating 测试）
平台通道更新
1、Discord
状态反应支持 trackToolCalls: true，跟踪后续工具进度
channels.discord.commands.native=false 时跳过斜杠命令注册，低功耗 Gateway 快速启动
传输降级或事件循环饥饿时在状态输出中提示
持久化斜杠命令部署哈希，跨进程重启复用
DM 接收后立即发送本地输入提示
2、Telegram
新增 channels.telegram.mediaGroupFlushMs 可配置相册缓冲时间（原硬编码 500ms）
抑制旧同会话回复，防止并发消息错乱
复用 getMe 探测结果，减少 Bot API 控制面调用延迟
3、WhatsApp
支持显式 Channel/Newsletter @newsletter 输出目标
修复 @whiskeysockets/libsignal-node 依赖，解决 pnpm v9 下 Baileys 子依赖拒绝问题
群组提及：@+<digits> / @<digits> 解析为真实 WhatsApp 参与者
4、Google Meet
大量修复：真实标签页媒体权限、加入后才启动音频桥、暴露实时转录、播放权限检查
使用本地通话静音按钮而非远程禁音，新增状态实时刷新
CLI 会话命令通过 Gateway 运行时路由，确保加入的实时会话在 CLI 进程退出后持续
5、Feishu（飞书）
新增 channels.feishu.blockStreaming 配置（顶层 + 每账号），默认关闭
修复重复语音媒体文本，保留普通音频文件说明
每聊天顺序队列阻塞上限（默认 5 分钟），防止单次挂起阻塞后续消息
6、Mattermost
接受 channels.mattermost.streaming 配置，streaming: "off" 禁用草稿预告
暴露 streaming.progress.* 配置标签
7、Microsoft Teams
原生进度流中支持进度工具行，toolProgress=false 时隐藏
8、Slack
不创建空白进度草稿消息（当 label=false 时）
DM 中允许草稿预览流（当 replyToMode: "off" 时）
9、Matrix
持久化待审批反应目标，Gateway 重启后仍可审批
10、QQ Bot
结构化 clientSecret SecretRef 解析，暴露 secret 合约
11、Control UI / WebChat
折叠重复的文本发送，快速重复提交不再创建新分发
大会话存储避免 sessions.list 完全重加载
修复技能详情弹窗在所有浏览器中无法打开的问题
会话检查点解释：压缩边界可见，提供直接链接
重要修复精选
1、升级安装
LaunchAgent 升级：避免 launchctl kickstart -k 在刚启动后触发 SIGTERM
macOS 更新：清理悬空插件运行时符号链接，升级不残留损坏导入路径
Gateway 服务：gateway install --force 优先选择系统 Node，避免 nvm 等版本管理器问题
插件安装：从完整 npm 根运行 npm install，不修剪已安装的同级插件
Beta 通道保持：Beta 已装的插件持续从 @beta 更新，不回落至 stale latest
2、性能
启动提速：惰性加载运行时发现、关闭钩子、定时任务、Schema 元数据等
Control UI：大会话存储下 sessions.list 延迟从数秒降至正常响应
Gateway/usage：费用和用量从持久缓存提供，避免重复全量扫描
会话列表：标题/预览仅读取首尾，缓存模型 ID 标准化，防止事件循环阻塞
3、Agent/模型
流式回复活：跃流式 Provider 回复的 fetch 超时在原始数据块上刷
DeepSeek V4：OpenRouter 路由下 /think 验证不再拒绝 xhigh/max 思考级别
MaxTokens模型： maxTokens 作为 OpenAI 兼容响应的默认输出限制
重试熔断连续： 5 次空闲超时后停止重试，防止费用失控
A2A延迟回复：软超时后仍保持存活，避免过期目标回复
4、记忆/存储
LanceDB声明： apache-arrow 运行时依赖，确保安装完整
嵌入重试：扩展重试分类器覆盖 fetch failed、ECONNRESET、socket hang up 等
归档搜索：轮转和删除的转录文件可搜索
内存状态：本地向量存储故障与 Provider 故障分开报告
5、安全
systemd env：保留 operator 添加的密钥，只清理 OpenClaw 管理的键
终端凭据：openclaw onboard 向导中隐藏 API Key、Token 输入
ClawHub 安装：提供 429 错误重置窗口和未认证更高速率限制提示
6、WebChat/Control UI
重复提交：快速重复发送合并到当前运行，不创建新分发
Talk CORS：浏览器 WebRTC SDP 交换修复，去除服务端专属头部
技能弹窗：showModal() 延迟至 DOM 连接后，修复全浏览器崩溃
升级注意事项
🚨 升级前必读
运行 openclaw doctor --fix
修复遗留配置迁移（agents.defaults.llm 等）
重置 stale plugins.slots.memory / contextEngine 引用
迁移旧 streaming.progress → streaming.preview.toolProgress
⚠️ Doctor 即使有其他验证错误也会执行安全迁移
注意外部化插件
Discord、Brave、Feishu 等插件已外部化为 npm 包
确保已正确安装：openclaw plugins install <plugin-name>
此次升级进一步加固了外部插件的安装/更新/回退路径
配置验证
messages.visibleReplies 和 messages.groupChat.visibleReplies 布尔值自动转换为枚举模式
无效配置不会自动回滚 → 需 doctor --fix 修复
tools.deny: ["write"] 不再隐式拒绝 apply_patch，需显式添加
macOS 用户注意
升级后 LaunchAgent 可能标记为未加载 → doctor --fix 自动恢复
避免旧版 launchctl kickstart -k 触发 SIGTERM
Bonjour 仅在 macOS 上默认启动，Linux/容器避免 mDNS 探测
代理/网络环境
在 Surge/Clash/sing-box fake-IP DNS 下工作的用户需确认配置兼容
web_fetch 新增 useTrustedEnvProxy 选项（默认关闭），代理专用环境需手动开启
插件相关
官方插件优先从 npm 安装，ClawHub 走 ClawPack 包格式
Beta 通道自动降级 stable（找不到时），不再直接崩
纯 TypeScript 源码的插件包被拒绝（需含编译 dist/*.js）
安装/更新时 npm tarball 验证完整性，可变标签不能绕过校验