“Your own personal AI assistant. Any OS. Any Platform. The lobster way.”
一、核心能力升级
1.1 代理(Agents)规范强化
本次更新对 Agent 开发规范进行了系统性收紧,明确修复应默认采用 clean bounded refactors,内部结构保持精简,并建立 显式插件 SDK/API 弃用路径。这意味着未来插件生态的演进将更加可控,开发者可以更清晰地规划迁移路线。
1.2 技能(Skills)体系扩展
autoreview重命名:本地 Codex 关闭审查技能及辅助工具重命名为autoreview,同时保留 Codex-first 回退行为- 新增 meme-maker 技能:支持精选模板搜索、本地 SVG/PNG 渲染、Imgflip 托管渲染,以及 Know Your Meme 溯源链接
- 新增 Python 调试技能:支持 pdb、
breakpoint()、事后检查(post-mortem inspection)和 debugpy 远程附加 - 新增节点检查器调试、融合图表生成、临时 spike 工作流技能
- Obsidian 技能更新:转向官方
obsidianCLI,要求注册二进制文件而非第三方obsidian-cli - 技能 CLI 全局安装:
openclaw skills install和openclaw skills update支持--global标志,可针对共享托管技能操作
1.3 工具插件系统(Tool Plugins)
重大新增:引入 defineToolPlugin 及 openclaw plugins build / validate / init 命令,支持:
- 类型化的简单工具插件
- 生成的清单元数据
- 可选的工具声明
- 上下文工厂
这标志着 OpenClaw 的插件生态从”脚本式”迈向”声明式”,开发者可以用更规范的范式构建工具。
二、平台与客户端
2.1 Mac 应用重设计
Settings 页面全面重构:
- 一致的卡片布局,导航缓存更流畅
- 权限/语音/技能/定时任务/调试面板更整洁
- 原生侧边栏周围间距更稳定
- Voice & Talk 识别语言和唤醒短语设置采用与其他 Settings 一致的紧凑卡片行
2.2 Android Talk Mode 实时化
Talk Mode 切换为 实时 Gateway 中继语音会话,支持:
- 流式麦克风输入
- 实时音频播放
- 工具结果桥接
- 屏幕内转录
2.3 浏览器(Browser)能力增强
- 快照中展示待处理及最近处理的模态对话框
- 当操作打开模态框时返回
blockedByDialog - 支持
browser dialog --dialog-id回答待处理对话框 - 新增
openclaw browser evaluate --timeout-ms,允许长运行页面函数扩展评估动作和请求超时预算 - 强制执行当前标签页 URL 白名单检查(
/actevaluate/batch 动作和/highlight路由)
2.4 控制 UI(Control UI)改进
- 从会话范围的
session.toolGateway 事件渲染实时工具进度,外部启动的运行也能在活跃会话中显示工具卡片 - 聊天删除确认弹窗在小屏幕上保持在可见视口内
- 修复助手响应结束后阅读指示器卡住的问题
三、Gateway 与基础设施
3.1 启动与重启优化
- 重叠启动日志与插件服务启动,与频道 sidecar 并行以减少重启就绪延迟,同时保留
/readyzsidecar 门控 - 重启追踪成本归因:启动探针、配置、运行时和资源计数成本在重启追踪中归因,不改变就绪行为
- 更新检查延迟启动:推迟到就绪之后,避免包更新检查阻塞 sidecar-ready 启动
3.2 配置热重载
暴露配置查找重载元数据,工具可在应用配置编辑前区分需要重启的字段、可热重载的字段和无操作字段。
3.3 Docker / Podman 构建增强
- 新增
OPENCLAW_IMAGE_APT_PACKAGES作为运行时中立的镜像构建参数(OPENCLAW_DOCKER_APT_PACKAGES作为遗留回退) - 新增
OPENCLAW_IMAGE_PIP_PACKAGES用于本地镜像构建中的可选 Python 包安装
3.4 代理(Proxy)支持
支持 HTTPS 托管转发代理端点,以及 proxy.tls.caFile CA 信任用于代理端点 TLS。
四、消息与频道
4.1 Telegram
- 论坛主题流量隔离:入站序列化、媒体/文本缓冲区、账户 API 队列按主题感知通道路由,避免论坛主题阻塞兄弟主题流量
- 队列论坛主题后续消息:避免继承已取代的源中止信号,同一主题后续用户回合仍可运行和回复
- 允许列表原生 DM 草稿预览,用于临时工具进度,最终答案保持正常持久交付路径
- 保留话题 ID,生成的媒体完成通过请求代理移交回论坛主题
/btw和只读状态命令不会中止活跃运行- 日志改进,记录成功出站交付元数据,消息正文不在日志中
4.2 Discord
- 流式回复预览保留:当恢复的工具警告最终在助手最终回复之前或之后交付时
- 实时 Discord 语音会话:与 OpenAI realtime 配合,预缓冲助手播放避免生硬启动
- 子代理线程绑定:委托会话的初始回复路由到绑定的 Discord 线程
4.3 Slack
持久化已交付入站消息 ID,当同频道线程回复失去线程上下文时失败关闭,防止延迟重复回复和意外频道根发布。
4.4 消息插件与子代理
- 新增频道渲染器的演示能力限制;原生渲染前适配富消息控件
- 将频道交付路由存储为规范会话元数据
- 弃用临时子代理钩子交付源字段,改用核心路由投影
五、Codex 集成
5.1 提示指导范围化
Codex app-server 根据运行时表面范围 OpenClaw 提示指导:
- 原生 Codex 保留 Codex 拥有的基础/人格指令
- OpenClaw 仅贡献运行时上下文、交付指导和显式范围命令提示
5.2 插件管理
新增 /codex plugins list / enable / disable 命令,无需手动编辑配置即可从聊天管理配置的原生 Codex 插件。
5.3 工具桥修复
- 保留插件工具认证配置,当 Codex 拥有模型传输时,OpenClaw 动态工具可解析其提供商凭证
- 完成 OpenClaw 动态工具诊断在请求边界
- 暴露 OpenClaw 的沙盒路由 shell 为
sandbox_exec/sandbox_process - 在排队运行前水合当前入站图像附件
- 保持原生代码模式可用,不强制仅代码模式
六、内存与搜索
6.1 内存搜索性能修复
JS 侧回退向量路径按有界 rowid 批次扫描,并在批次间让出事件循环,大块表不再能钉住 Node.js 主线程数秒。SQL 预编译语句保持在本地,防止 node:sqlite 在堆压力下中途终结。
6.2 Memory Wiki 修复
- 桥源页面写入因非符号链接文件系统安全原因失败时,保留 fs 安全诊断
wiki_lint工具输出路径安全,vault 内部 lint 报告作为相对路径报告
6.3 QMD 导出
归档会话转录命中在 QMD 导出后保持可见,同时保留仅类似 .md 的会话 ID。
七、QA-Lab 质量保障体系
本次更新大幅扩展了 QA-Lab 的测试覆盖:
- 第一小时 20 回合和可选 100 回合运行时对等场景,带标准与浸泡 QA 门控的层级元数据
openclaw qa suite --runtime-parity-tier将标准 Codex-vs-Pi 层级连接到发布检查- Codex Pi 形 Read 词汇金丝雀:运行时对等捕获原生工作区读取提示兼容性漂移
- 插件钩子崩溃、清单合约错误、WebChat 直接回复自消息路由的自健康场景
- 运行时工具夹具场景和覆盖率报告
openclaw qa coverage --tools通过工具暴露运行时工具夹具覆盖率- Codex-vs-Pi 运行时 token 效率 artifact 车道
- 硬门控 OpenClaw 动态运行时工具漂移验证
- 个人代理批准/拒绝场景、本地任务后续场景
- 仅报告梦境影子试验场景、分享安全诊断 artifact 场景
- 个人代理无假进度场景
八、依赖与运行时
@openclaw/proxyline更新至 0.3.3- Pi 包更新至 0.75.1
- Node.js 最低支持版本提升至 22.19
- CLI 启动器中强制执行 Node.js 22.19 运行时底线
九、性能与稳定性
- Gateway 重启基准工具:
pnpm test:restart:gateway用于重复重启就绪、停机、追踪和资源斜率证据 - 发布稳定性:修复请求代理完成移交、QA-Lab mock spawn 归属、Slack 监控测试隔离等广泛门控回归
- 媒体处理:防止未识别图像字节调用外部解码器;Sharp 不可用时回退 sips、Windows 原生成像、ImageMagick、GraphicsMagick 或 ffmpeg
- TTS 指令应用时机:在消息工具发送到达核心前应用,确保语音笔记而非泄漏原始标签
十、修复汇总(精选)
| 领域 | 关键修复 |
|---|---|
| CLI | 拒绝超过 65535 的显式端口号;修复 root-owned npm install EACCES 恢复 |
| 记忆 | 大表扫描不再钉住主线程 |
| Telegram | 论坛主题流量隔离;队列后续消息信号继承修复 |
| Twitch | 刷新聊天 token 与 Twurple 聊天意图注册 |
| Anthropic | 保留当前 Claude 模型行的原生图像输入;保留 Claude 4 图像能力 |
| DeepSeek | MCP 工具模式用 anyOf / oneOf 归一化 |
| 技能 | 拒绝空或仅空白技能名称和描述;watched skill roots 变化时刷新会话技能快照 |
| Cron | 隔离调度任务运行链接到其稳定 cron 会话 |
| LM Studio | 通过标准 SecretInput 路径解析 env-template API 密钥 |
| 代理回复 | 模型回退重试期间仅持久化一次排队后续用户消息和助手错误 stub |
| ClawHub | 构建 API 请求 URL 时保留配置的 base URL 路径前缀 |












