引言
OpenClaw v2026.4.5 于 2026 年 4 月 6 日正式发布,是 AI Agent 开发平台走向工程化成熟的重要里程碑。
本次更新涵盖 Memory 系统重构、音视频生成能力内置化、多 Provider 生态扩展、Claude CLI 安全加固以及 Cron 稳定性等多个维度,变化数量超过 150 项。这里不一一罗列,重点解析对日常使用影响最大的五大核心更新。
验证说明:本文所有代码、配置和命令均经过实际验证,运行环境为 WSL2 Ubuntu 22.04,OpenClaw 版本
2026.4.5(已通过openclaw status确认)。
亮点一:Memory 梦境系统重构——三阶段调度 + 加权记忆提升
旧版痛点
此前的 Memory 系统依赖每日笔记的手动整理和提升,记忆recall全凭触发关键词,效率低下且不可预测。
新版架构
v2026.4.5 将梦境系统重构为三个协作阶段(浅睡 → 深睡 → REM),每个阶段有独立调度和恢复行为:
- 浅睡(Light Sleep):快速扫描近期记忆,识别值得保留的片段
- 深睡(Deep Sleep):对高频出现的模式进行加权提升,将关键记忆写入持久层
- REM:最终协调阶段,展示可能的持久真理,支持重放和 promotion explain
核心配置
新增可配置的 aging 控制参数:
# 推荐配置示例(通过 openclaw config set)
openclaw config set memory.dreaming.enabled true
openclaw config set memory.dreaming.frequency "6h"
openclaw config set memory.dreaming.recencyHalfLifeDays 3
openclaw config set memory.dreaming.maxAgeDays 30
参数说明:
| 参数 | 含义 | 推荐值 |
|---|---|---|
recencyHalfLifeDays |
记忆衰减半衰期,越短越注重新近记忆 | 3 |
maxAgeDays |
超过此天数的记忆不参与提升 | 30 |
frequency |
梦境运行间隔 | 6h 或 daily |
验证命令
# 查看梦境状态
openclaw status --verbose | grep -i dream
# 运行 REM harness(预览提升决策)
openclaw memory rem-harness
# 查看提升解释
openclaw memory promote-explain
实际验证
$ openclaw cron status
{
"enabled": true,
"storePath": "/home/ubuntu/.openclaw/cron/jobs.json",
"jobs": 15,
"nextWakeAtMs": 1775574000741
}
Cron 调度器正常运行,梦境任务可正常排期。梦境内容现在写入顶级 dreams.md 而非每日笔记,便于显式读取而不干扰默认召回。
原文引用
"将梦境重构为三个协作阶段(浅睡、深睡、REM),具有独立调度和恢复行为,使持久记忆提升可在后台运行,减少手动配置。" —— v2026.4.5 Changelog
亮点二:视频 + 音乐生成——内置工具化 + 多 Provider 支持
内置工具上线
v2026.4.5 新增两个内置工具,无需安装额外插件即可使用音视频生成:
# 视频生成(内置工具)
video_generate
# 音乐生成(内置工具)
music_generate
视频 Provider 支持
新增三个视频提供商,并提供实时测试和默认模型接线:
| 提供商 | 模型 | 说明 |
|---|---|---|
| xAI | grok-imagine-video |
Grok 系列视频生成 |
| 阿里 Model Studio | Wan 系列 | 阿里云视频能力 |
| Runway | 默认可用 | 行业领先的 AI 视频 |
音乐 Provider 支持
内置捆绑两个音乐提供商:
- Google Lyria:支持
durationSeconds等可选提示(不支持时仅警告而非拒绝) - MiniMax:异步任务跟踪,完成后推送音频
// 音乐生成调用示例
const music = await music_generate({
prompt: "upbeat electronic music, 120bpm",
durationSeconds: 30,
provider: "minimax" // 或 "google-lyria"
});
异步完成路径
新增 tools.media.asyncCompletion.directSend 配置,支持异步媒体任务完成后直接推送,而非唤醒请求者会话:
openclaw config set tools.media.asyncCompletion.directSend true
原文引用
"新增内置
video_generate工具,支持通过配置的提供商生成视频,并可将生成的媒体直接返回到回复中。" —— v2026.4.5 Changelog
"新增内置
music_generate工具,捆绑 Google (Lyria) 和 MiniMax 提供商,包含异步任务跟踪和完成音频的后续推送。" —— v2026.4.5 Changelog
亮点三:多 Provider 生态扩展——Qwen / Fireworks AI / StepFun / MiniMax
新增捆绑 Provider
本次版本将以下 Provider 纳入捆绑分发,安装即用:
| Provider | 类型 | 说明 |
|---|---|---|
| Qwen(通义千问) | 聊天 | 阿里大语言模型 |
| Fireworks AI | 聊天 | 高性能推理平台 |
| StepFun | 聊天 | StepFunction 集成 |
| MiniMax TTS | 语音 | MiniMax 文本转语音 |
| Ollama Web Search | 搜索 | 本地 Ollama 搜索增强 |
| MiniMax Search | 搜索 | MiniMax 搜索集成 |
Amazon Bedrock 增强
新增 Mantle 支持,以及推理配置发现和自动请求区域注入,使 Bedrock 托管的 Claude、GPT-OSS、Qwen、Kimi、GLM 等路由的安装配置更简便。
# Bedrock 配置示例
openclaw config set providers.bedrock.mantle.enabled true
openclaw config set providers.bedrock.region "us-east-1"
MiniMax 模型升级
- 捆绑的
MiniMax-M2.7和MiniMax-M2.7-highspeed模型定义现在广告图片输入,图片能力流可正确通过 M2.7 系列路由 MINIMAX_API_HOST环境变量对隐式捆绑目录生效,中国托管 API Key 无需手动 Provider 配置即可选择api.minimaxi.com/anthropic
Memory 搜索增强
Amazon Bedrock embeddings 现在支持 Titan、Cohere、Nova 和 TwelveLabs 模型:
openclaw config set memory.embeddings.provider "auto" # AWS 凭证链自动检测
原文引用
"新增捆绑的 Qwen、Fireworks AI 和 StepFun 提供商,以及 MiniMax TTS、Ollama Web Search 和 MiniMax Search 集成,涵盖聊天、语音和搜索工作流。感谢 @vincentkoc。" —— v2026.4.5 Changelog
亮点四:Claude CLI 安全加固——清除后门路由
背景
Claude CLI(claude-cli 后端)可以通过环境变量和 config-root 路径被静默重定向,存在安全风险。v2026.4.5 对此进行了全面加固。
三项关键修复
修复 1:清除继承的 config-root 和 plugin-root env 覆盖
# 原来可能存在的风险环境变量
CLAUDE_CONFIG_DIR=~/.custom-claude-config
CLAUDE_CODE_PLUGIN_ROOT=/custom/plugins
# v2026.4.5 现在清除这些继承覆盖
# OpenClaw 启动的 Claude CLI 运行不会被静默指向备用配置树
修复 2:清除继承的 Provider 路由和托管 auth env
# 原来可能存在的风险:
# CLAUDE_PROVIDER_OVERRIDE=bedrock
# ANTHROPIC_VERTEX_PROJECT=my-project
# VERTEX_TOKEN=xxx
# v2026.4.5 清除上述覆盖,Claude CLI 后门会话不能被重定向到代理、Bedrock、Vertex、Foundry 或父托管 token 上下文
修复 3:强制 --setting-sources user
# 强制使用 user 级设置来源,阻止 repo 本地 .claude 项目/本地设置/hooks/plugins 在非交互式会话中静默执行
claude ... --setting-sources user
即使在自定义后端 arg 覆盖(如 --claude-code-args)下,也强制 bypassPermissions 模式。
Doctor 健康检查
新增专用 Claude CLI 健康检查:
$ openclaw doctor
# 可在线上安装缺失或认证破损前发现问题
原文引用
"清除继承的 Claude Code config-root 和 plugin-root env 覆盖(如
CLAUCE_CONFIG_DIR和CLAUDE_CODE_PLUGIN_*),使 OpenClaw 启动的 Claude CLI 运行不能被静默指向具有不同 hooks、插件或 auth 上下文的备用 Claude config/plugin 树。感谢 @vincentkoc。" —— v2026.4.5 Changelog
亮点五:Cron 稳定性全面改进
痛点回顾
此前 Cron 任务在 gateway 重启后容易丢失或延迟,尤其循环作业需要两次重启才能恢复,失败通知也可能无法送达。
两项关键修复
修复 1:首次重启即重放中断的循环作业
# 原来:中断的循环作业需要两次 gateway 重启才重放
# 现在:首次重启立即重放
$ openclaw cron status
{
"enabled": true,
"jobs": 15,
"nextWakeAtMs": 1775574000741 # 正常调度中
}
修复 2:失败通知路由到主投递渠道
当未配置显式 failureDestination 时,失败通知现在通过与成功投递相同的会话上下文发送到作业的主要投递渠道,而非丢失或发送至错误位置。
# 验证:查看任务执行历史
openclaw cron runs <job-name>
其他稳定性改进
- Gateway 启动时将
gateway.mode默认为local,并检测锁文件中的 PID 回收,使健康重启不再被陈旧锁阻塞 - macOS LaunchAgent 重启行为全面修复,
KeepAlive再次拥有进程内 gateway 重启能力 - Windows 计划任务重启更准确,不再在 60 秒后假装超时
原文引用
"在首次 gateway 重启时重放中断的循环作业而非等待第二次重启。修复 #60583。感谢 @joelnishanth。" —— v2026.4.5 Changelog
"当未配置显式
failureDestination时,通过与成功投递相同的会话上下文将失败通知发送到作业的主要投递渠道。修复 #60622。感谢 @artwalker。" —— v2026.4.5 Changelog
其他值得关注的更新
控制面板多语言
新增 12 种语言支持:简体中文、繁体中文、巴西葡萄牙语、德语、西班牙语、日语、韩语、法语、土耳其语、印尼语、波兰语和乌克兰语。
Prompt 缓存稳定性
跨传输回退的提示前缀复用、MCP 工具确定性排序、嵌入式图片历史等全面优化,openclaw status --verbose 新增缓存诊断输出,使后续轮次更可靠地命中缓存。
Telegram 修复集合
- 模型选择器当前模型检查
- HTML 格式非默认
/model确认 - 主题回复持久化
- DM 语音笔记预检转录恢复
- Reasoning 预览通道仅在
reasoning:stream时创建
ACPX 运行时嵌入
ACP 运行时直接嵌入 acpx 插件,移除外部 ACP CLI 调用,强化实时 ACP 会话绑定和复用,新增通用 reply_dispatch hook。
升级建议
# 检查当前版本
openclaw status | grep "Update"
# 升级到最新版本
npm install -g openclaw@latest
# 运行健康检查(升级后推荐)
openclaw doctor
# 检查配置兼容性
openclaw doctor --fix # 自动修复旧配置路径
Breaking Changes 注意
本次版本移除了以下旧版配置路径,现有配置在加载时仍保持兼容,但建议运行 openclaw doctor --fix 进行迁移:
talk.voiceId/talk.apiKeyagents.*.sandbox.perSessionbrowser.ssrfPolicy.allowPrivateNetworkhooks.internal.handlers- channel/group/room 的
allow开关
结语
v2026.4.5 是 OpenClaw 走向成熟的重要节点,而非简单的功能堆积。几个信号值得关注:
- Memory 梦境系统从手动整理进化为三阶段自动调度,是记忆管理范式的根本改变
- 音视频生成内置工具化降低了使用门槛,预示着 OpenClaw 在内容创作场景的布局
- 多 Provider 集成扩展到 Qwen/Fireworks AI/StepFun/MiniMax,生态更开放
- Claude CLI 安全加固清除后门风险,是企业级部署的必要基础
- Cron 稳定性全面改进,gateway 重启不再丢失任务
如果你是 OpenClaw 的现有用户,建议尽快升级并运行 openclaw doctor --fix。如果你是 AI 工具爱好者,OpenClaw 正在从一个实验性框架成长为真正可用的生产级 Agent 开发平台。