乐于分享
好东西不私藏

OpenClaw 2026.4.29 正式发布

OpenClaw 2026.4.29 正式发布

OpenClaw 2026.4.29 正式发布

Messaging Steering + Memory Wiki + NVIDIA Provider + 4大渠道修复,367K Stars 的 AI Agent 引擎更新

5天4个Beta迭代,30+贡献者,100+修复,史上最密集的Beta周期

我是atyou, 今天教大家OpenClaw 2026.4.29 大版本核心更新解读

4月30日,OpenClaw 发布了 2026.4.29 正式版。367K Stars 的开源 AI Agent 引擎,在这个版本里完成了 Messaging Steering 机制默认化、Memory Wiki 人脉感知、 NVIDIA Provider 支持、Gateway 启动可靠性、多渠道稳定性等全面升级。

本文深度解析 2026.4.29 的核心亮点与改进逻辑,帮你判断是否需要升级,以及升级后需要注意的配置变化。

本版本所有Beta版共用相同的 Highlights 说明,beta.2/3/4 在 beta.1 基础上持续修复。正式版整合了所有Beta迭代的修复, 是最终稳定版本。

— — — — — — — — — —

一、核心架构改进

2026.4.29 在消息队列、子Agent路由和Gateway生命周期上做��架构级改进,这些变化直接影响Agent行为。

Step 1Messaging Steering 默认化 + 子Agent路由元数据

之前 Steering 机制需要手动开启,现在 active-run 默认走 Steering 队列,500ms followup 降级 debounce。消息不再直接输出, 而是经过模型边界排空。

关键变化:messages.queue 默认值从 passive 改为 steer,queue 模式保留为 one- at-a-time 的传统行为。

子Agent chat 和 agent broadcast payloads 现在暴露 spawnedBy 元数据,客户端无需额外 session 查找就能路由子会话事件。

⚠️踩坑:依赖旧行为

如果你的自动化脚本依赖消息立即输出,需要显式配置 messages.queue=passive。Steering 模式下消息会等待下一个模型边界才输出。

📌配置建议

大多数场景用默认 Steering 即可。需要即时响应的高速对话场景,设置 messages.queue=passive。

Step 2Commitments 承诺跟踪系统

新增可选的承诺跟踪功能:Agent 可以自动提取并记录用户的 follow-up 承诺,通过 heartbeat 定期提醒。

配置项:commitments. enabled 和 commitments.maxPerDay,默认关闭。CLI 管理命令:openclaw commitments。

承诺在 heartbeat 间隔到期时送达,不会立即 echo 造成重复。

📌适用场景

个人助手/秘书类Agent。团队场景慎用——多人会话的承诺归属需要明确。

Step 3Gateway 启动诊断时间线

Gateway 和 packaged-plugin 可靠性大幅增强:慢主机启动优化、事件循环就绪诊断、运行时依赖修复、陈旧 session 恢复、版本范围更新缓存。

新增 opt-in 启动诊断时间线,记录 Gateway 生命周期和插件加载各阶段, 配置 behind config flag,无需定制仪表化。

模型目录支持缓存:模型配置变更后 Gateway 控制面和 OpenAI-兼容请求不再阻塞在模型提供商重发现上。

📌诊断启用

Gateway 启动缓慢时,设置 gateway.diagnostics=true 查看各阶段耗时,快速定位瓶颈。

Step 4SQLite Keyed Store 插件状态存储

新增 api.runtime.state.openKeyedStore:restart-safe 的键值注册表,支持 TTL、驱逐和自动插件隔离。

持久化存储,重启不丢失数据,适合计数器、限流等需要跨重启保持状态的插件场景。

— — — — — — — — — —

二、Memory Wiki 人脉感知

Memory 在这个版本进化为半自动人脉知识库,支持人物卡片、关系图和溯源报告。

Step 1People Wiki 人脉元数据

Memory Wiki 新增面向 Agent 的人物元数据:规范别名、人物卡片、关系图、隐私/溯源报告、证据类型下钻。

搜索模式支持:人物查找、问题路由、源证据溯源、原始声明检索。

📌隐私说明

人脉数据默认私有。溯源报告让Agent告诉你每条信息的来源和可信度。

Step 2Active Memory 对话过滤

新增 per-conversation allowedChatIds 和 deniedChatIds 过滤器,选择性开启 recall。

可以在指定的 direct/group/channel 会话中启用记忆,同时跳过其他会话。

Step 3部分召回与 REM 预览

当 Memory 子Agent 超时时,返回有界的部分召回摘要, 有用的上下文不会被丢弃。

新增只读 doctor.memory.remHarness RPC,客户端可以预览有界 REM 梦境输出, 无需运行变更路径。

— — — — — — — — — —

三、NVIDIA Provider 新增

NVIDIA 正式加入 Provider 大家庭,API-key onboarding、静态目录、literal 模型引用支持。

Step 1NVIDIA Provider 上手指南

新增 NVIDIA Provider:API-key onboarding、setup docs、静态目录元数据、literal 模型引用选择器。

使用 Provider 前缀 nvidia/ 选择 NVIDIA 托管模型。

NVIDIA 的模型目录通过静态元数据提���,无需动态发现。

⚠️踩坑:API Key 配置

NVIDIA API Key 需要配置在 providers.nvidia.apiKey,不能用 NVIDIA NGC 的个人密钥。

— — — — — — — — — —

四、渠道稳定性修复

多渠道在这个版本得到了密集修复,尤其是 Slack Block Kit 限制和 Telegram 韧性。

Step 1Slack Block Kit 全套限制修复

这个版本 Slack 相关修复最多:按钮/选择 URL 截断、参数菜单截断、执行审批元数据限制、消息更新限制、 命令参数菜单限制等。

所有修复都围绕 Slack Block Kit 的 value 和 count 限制展开——长文本不再让 Slack 拒绝整个块载荷。

Step 2Telegram 韧性增强

流式预览改用持久消息编辑,不再使用本地草稿状态, 避免生成的回复在草稿→消息转换中闪烁��

低 long-polling 超时钳制:低于 getUpdates 轮询窗口的配置值不再强制每秒重建 HTTPS 连接。

Step 3WhatsApp / Signal / Feishu 修复

WhatsApp:要求 Baileys 出站消息 ID 才标记自动回复送达, 转录文本和 ack 反应不再让失败的群组回复看起来已发送。

Signal:SSE 监视器空闲时保持打开,signal-cli 0.14.3 事件流不再在入站消息到达前重连。

Feishu:跳过空文本消息,iOS 视频资源下载 502 时重试为 media 类型。

Step 4Yuanbao 新渠道

新增腾讯元宝 Yuanbao 通道文档入口, 插件 GitHub 位置更新为 YuanbaoTeam/yuanbao-openclaw-plugin。

通道目录新增 yuanbao 别名。

— — — — — — — — — —

五、安全与运营改进

OpenGrep 安全扫描、Docker 自动化、凭证安全比较。

Step 1OpenGrep 安全扫描集成

新增 OpenGrep 规则包、源规则编译器、溯源元数据检查、PR/全扫描工作流,验证第一方代码并上传 SARIF 到 GitHub Code Scanning。

规则包只读变更时不触发完整扫描。

Step 2凭证安全比较

凭证字节比较改用填充时序安全缓冲区,不再在相等性检查前哈希候选密码。

防止时序侧信道攻击。

Step 3Docker 自动化

新增 OPENCLAW_SKIP_ONBOARDING 环境变量,自动化 Docker 安装可以跳过交互式引导步骤, 同时应用 Gateway 默认值。

📌自动化部署

使用 OPENCLAW_SKIP_ONBOARDING=1 加 openclaw config 命令实现无人值守安装。

— — — — — — — — — —

六、重要配置变更

以下配置变更可能影响现有部署,升级前请检查。

Step 1tools.exec / tools.fs 不再隐式扩展受限配置文件

严格配置文件(messaging、minimal)不再隐式包含 tools.exec / tools.fs。需要显式添加 alsoAllow 条目。

启动时警告标识受影响的配置。

⚠️踩坑:受限配置下的工具

如果你的消息类配置突然无法使用 exec/fs 工具,这是原因。显式添加 alsoAllow 即可。

Step 2local 模型上下文窗口安全边界

小 local 模型不再被固定的 16k/32k 预检截止线拒绝——从有效模型窗口派生 4k/8k 安全边界。

— — — — — — — — — —

七、常见问题与排错

是否需要立即升级?

建议升级。Gateway 启动诊断、模型缓存、渠道稳定性修复和多渠道改进值得升级。但先在非生产环境验证, 尤其是如果你依赖受限配置文件(messaging/minimal)下的 exec/fs 工具。

Beta 版本和正式版有什么区别?

所有 Beta 版共享相同的 Highlights 说明。Beta.2/3/4 在 Beta.1 基础上持续累积修复。正式版整合了所有 Beta 迭代的修复,是最终稳定版本。建议生产使用正式版。

Commitments 功能开启后会影响对话体验吗?

默认关闭。不开启不影响任何行为。开启后 Agent 会跟踪你的 follow-up 承诺并到期提醒——适合个人助手场景, 多人频道慎用以避免混乱。

NVIDIA Provider 如何配置?

需要 NVIDIA API Key(不是 NGC 个人密钥),配置在 providers.nvidia.apiKey。选择模型时使用 nvidia/ 前缀。 目录通过静态元数据提供,无需动态发现。

Slack 用户需要注意什么?

好消息:这个版本修复了大量 Slack Block Kit 限制, 长文本命令和参数不再被 Slack 拒绝。但仍然建议命令参数简洁——这是 Slack 本身的限制,修复只是防止整个块载荷失败。

— — — — — — — — — —

八、安全建议

凭证比较使用时序安全缓冲区,防止侧信道攻击

HTML 标签在纯文本净化时剥离,防止 XSS

文件下载使用规范路径预检授权,防止目录遍历

OAuth client_secret 文件不作为提交候选

敏感凭证请使用环境变量或 SecretRef,不要硬编码在配置文件中

⚠️重要提醒

本文中出现的所有 Token 均为示例或已脱敏处理。请务必使用你自己的 Token,并妥善保管。切勿将敏感凭证提交到 Git 仓库。

— — — — — — — — — —

总结

OpenClaw 2026.4.29 是一个架构级改进版本:Messaging Steering 默认化、Memory Wiki 人脉感知、NVIDIA Provider 支持、Gateway 启动可靠性、多渠道稳定性增强。

升级优先级:高。Gateway 可靠性和渠道修复值得立即升级,但受限配置文件用户需要检查 alsoAllow 配置。

Beta 迭代模式说明:正式版整合了 5 天 4 个 Beta 的所有修复,是最终稳定版本。

版本v2026.4.29 正式版

Beta 迭代4次(beta.1 → beta.2 → beta.3 → beta.4 → 正式版)

Stars367K

主要贡献者30+

核心改进Messaging Steering + Memory Wiki + NVIDIA Provider

渠道修复Slack Block Kit + Telegram + WhatsApp + Signal + Feishu

安全改进OpenGrep + 时序安全凭证比较 + HTML 净化

配置注意受限配置需显式 alsoAllow exec/fs

建议升级,但先在非生产验证

— — — — — — — — — —

我是atyou, 您有什么感兴趣的主题,可以给我留言让我们一起拥抱AI, 共同进步,享受美好生活。

参考文档:

OpenClaw GitHub → 点击访问

https://github.com/openclaw/openclaw

v2026.4.29 正式版发布说明 → 点击访问

https://github.com/openclaw/openclaw/rel eases/tag/v2026.4.29

v2026.4.29-beta.4 发布说明 → 点击访问

https://github.com/openclaw/openclaw/rel eases/tag/v2026.4.29-beta.4