📊 版本概览

🆕 重大新功能 & 亮点

📁 文件传输插件 (全新)

• 新增内置 file-transfer 插件，提供 file_fetch、dir_list、dir_fetch、file_write 等 Agent 工具，支持配对节点间的二进制文件操作
• 每节点 plugins.entries.file-transfer.config.nodes 默认拒绝策略 + 操作员审批
• 默认拒绝符号链接遍历（可选 followSymlinks）
• 单次传输上限 16 MB

🚀 Gateway 性能大幅提升

• 启动和 Control UI 热路径延迟加载：插件发现、Cron、Schema、会话、模型元数据等
• 推迟维护定时器到就绪后启动
• 消除重复的插件自动启用工作
• 新增启动 CPU/Profile 控制

🔌 插件安装体系全面加固

• 官方插件安装、卸载、更新、onboarding、ClawHub 回退全面强化
• NPM 依赖状态报告 + Beta 通道更新路径
• 外部化插件现在像一等公民一样安装管理

💬 渠道回复能力增强

• Discord 状态反应 + 降级传输报告
• 新增 WhatsApp Channel/Newsletter 目标支持
• Telegram、飞书、Matrix、Microsoft Teams、Slack 投递/恢复行为收紧

🤖 Agent 运行时可靠性

• 保留流式 Provider 回复、延迟 A2A 会话回复
• Prompt/工具投递、Memory 召回、Web 搜索 Provider 发现
• Provider 特定的思考/模型元数据跨边界场景保留

✨ 新功能 (Changes)

📡 流式传输统一

• 新增统一 streaming.mode: "progress" 草案模式
• 自动单字状态标签 + 跨 Discord、Telegram、Matrix、Slack、Teams 共享进度配置
• 暴露 streaming.progress.label、labels、maxLines、toolProgress 配置

🎮 Agent 命令

• 新增 /steer <message> 命令 — 队列无关的活动会话转向，无需开启新轮次
• 新增 /side 命令（作为 /btw side question 的文本和斜杠命令别名）

🛠️ 工具系统

• tools.profile: "full" 现在授予所有工具，包括浏览器等可选插件工具
• tools.deny: ["write"] 不再隐式禁止 apply_patch（需显式 deny apply_patch 或 group:fs）
• LLM 任务工具在工具禁用时保持仅 JSON 的内嵌模型运行
• 新增 Tree-sitter 驱动的 Shell 命令解释器（为未来审批/命令审查界面做准备）

📋 Doctor/Config

• doctor --fix 现在能提交安全遗留迁移，即使其他验证问题（如缺少插件）阻止完整验证通过
• agents.defaults.llm 等遗留键始终被清理
• Gateway 启动和热重载不再自动恢复无效配置（失败关闭）
• 新增 openclaw gateway restart --force 和 --wait <duration>

☁️ 扩展的 QA 框架

• Mantis：新增 Discord smoke 测试运行器和手动 GitHub workflow（频道可见性、发消息、反应、上传）
• Slack：新增实时传输 QA 运行器（canary + mention-gating）

🔧 其他新功能

• 插件 Cron：delivery.mode: "none" 任务无投递预览显示
• Gateway/Usage：持久化 transcript 聚合缓存、锁定安全刷新、过期状态提示
• 插件 Hooks：支持从配置绑定 timeoutMs / timeouts
• Telegram：新增 mediaGroupFlushMs 配置，可调专辑缓冲
• 飞书：支持 blockStreaming 配置控制
• Memory LanceDB：声明 apache-arrow 运行时依赖

🐛 Bug 修复 (Fixes)

💬 各渠道修复

飞书 (Feishu)

• 抑制语音媒体回复时的重复文本
• 保留普通音频文件标题
• 支持多账户配置的 setup/status 探测
• 飞书打包启动绕过 Lark SDK ESM __dirname 路径
• 入站去重包含 file_key 和 image_key，相同消息 ID 的不同媒体也能正确处理
• 隐藏超时 env 解析（避免安全扫描误报）

Discord

• 反应工具可配置 trackToolCalls: true
• 共享工具显示表情符号表，状态输出反映 Discord 传输降级或事件循环饥饿
• 解析 SecretRef 令牌，未解析的配置令牌不再导致崩溃
• 持久化斜杠命令部署哈希，不变的命令集跳过重新部署，避免重启循环 429
• CJK 和多行命令描述不再触发冗余 PATCH 爆发
• 修复仅工具公会频道 statusReactions 生命周期

Telegram

• 抑制陈旧同会话回复
• 重用成功 getMe 探测启动轮询
• 保留回复和引用上下文，避免引用文本驱动图片加载

WhatsApp

• 允许 libsignal-node 在 onlyBuiltDependencies 中
• 群组文本/媒体标题原生提及解析
• 提及令牌必须在单词边界结束

Mattermost

• 接受并执行 streaming: "off" 配置
• 暴露 streaming progress 配置标签

Microsoft Teams

• 原生进度流支持工具进度行
• toolProgress=false 时抑制独立工具消息

Slack/Matrix

• 修复空白进度草案消息问题
• Matrix 审批反应目标跨重启持久化
• Matrix 工具进度预览检查修复

Google Chat

• 自定义 Google auth 传输头规范化修复

🎭 Agent & 运行时

• 流式 Provider 回复保持活动状态（刷新带锁获取超时）
• 表面真实 prompt 流超时而非部分助手片段
• 延迟 A2A 回复在软等待窗口超时后仍保持
• 修复会话文件修复后删除已投递回复的问题
• 超大 transcript 轮次保留为省略消息占位符
• Agent 不完整轮次检测警告
• 自动压缩后无最终可见回复时重试一次
• 空闲超时新增成本失控断路保护（5 次连续超时后停止重试）
• 修复 /think 显示错误的思考级别问题
• Codex 心跳提示对齐 heartbeat_respond 工具

🔌 插件系统

• 修复 @openclaw/* 插件安装保留已有同组插件
• 修复外部 context-engine 插件加载时机
• 修复路径插件工具工厂按需加载
• 修复钩子插件在 Gateway 启动时包含
• 修复 plugins/installs.json 为空时从 NPM root 恢复
• 修复重复清单兼容性诊断输出
• 修复源仅 TypeScript 包的安装拒绝
• ClawHub 接受新旧格式的 artifact 字段名
• ClawHub 429 错误标注重置窗口和匿名限速提示
• Beta 通道外部化插件正确处理

🖥️ Gateway & CLI

• Gateway 会话列表行轻量化（标题/预览限制为 transcript 头尾读取）
• 缓存每运行详细级别会话读取
• 移除冗余的 lsof 扫描
• 修复模型列表降级路径
• 修复插件启用/禁用后不持久化错误插件 ID
• 修复停止管理服务前拒绝自更新
• openclaw logs --follow 自动重连
• openclaw gateway start 修复陈旧服务定义
• Gateway Bonjour 仅 macOS 主机自动启动
• macOS LaunchAgent 修复 kickstart -k 问题

🧠 Memory 系统

• 内置 SQLite-vec 存储就绪性与嵌入 Provider 就绪性分离
• 保留轮换和删除的 transcript 可搜索
• 嵌入重新索引重试分类器扩展（fetch failed、ECONNRESET、socket hang up 等）
• 修复 no active memory plugin 误报
• LanceDB 安装包含 apache-arrow 运行时对等依赖
• SQLite-vec 标记为可选

🌐 网络 & 代理

• 允许受信任的 Web 搜索和模型 Provider 在 fake-IP DNS 下工作
• Proxy 设置对受保护 Provider 模型获取生效
• 新增 tools.web.fetch.useTrustedEnvProxy 配置（代理独占环境）
• 目标 TLS 主机名验证保留

🔧 其他修复

• Config 布尔值 visibleReplies → 强制转换为文档化枚举模式
• 全渠道 streaming 配置元数据暴露
• Dokcer Gateway .env 值传递修复
• Control UI WebChat 合并重复发送优化
• Control UI Skill 详情对话框修复
• Media 支持 MEDIA:~/... 路径
• 并行/Windows 更新 smoke 脚本修复
• TTS 插件激活时机修复
• CORS Talk 修复（WebRTC）
• Provider LM Studio 推理元数据规范化
• Provider Ollama 上下文窗口转发修复
• Provider Arcee AI Trinity Large Thinking 标记修复

🏅 特别感谢

感谢以下贡献者（排名不分先后）：

@omarshahine, @vincentkoc, @hclsys, @dorukardahan, @joshavant, @RomneyDa, @luckylhb90, @jesse-merhi, @ottodeng, @neo19482, @afiqfiles-max, @dsdsddd1, @BunsDev, @zqchris, @keshavbotagent, @brokemac79, @Marvinthebored, @scottgl9, @mjamiv, @cosmicnet, @donbowman, @tomascupr, @iAbhi001, @lilesjtu, @SymbolStar, @mayank6136, @jonathanlindsay, @neilofneils404, @LindalyX-Lee, @cheechnd, @volcano303, @martingarramon, @bek91, @jwong-art, @byungskers, @crpol, @wwf3045, @MkDev11, @xialonglee, @aaajiao, @joeyfrasier, @anurag-bg-neu, @sallyom, @nickmopen, @stevenchouai, @som-686, @daruire, @chinar-amrutkar, @VACInc, @GodsBoy, @mlopez14, @zhengsx, @jackiedepp, @ThisIsAdilah, @neeravmakwana, @fede-kamel, @abnershang, @rolandrscheel, @trojy13, @RayWoo, @AnathemaOfficial, @ai-hpc, @obviyus, @keen0206, @ThePuma312, @pashpashpash, @CharZhou, @bonelli, @wenxu007, @Hollychou924, @ruji9527, @yelog, @buyitsydney, @willemsej, @Countermarch, @amknight, @fabkury, @vishutdhar, @zknicker, @HangGlidersRule, @Ricardo-M-L, @solodmd, @openperf, @Lucenx9, @Conan-Scott, @100menotu001, @HeilbronAILabs, @artnking, @dashhuang, @jack-stormentswe, @bubucilo, 等。

「每个版本都在变得更强大！芙宁娜大人超满意～」 ✨