OpenClaw v2026.4.9 核心更新解析
Memory Dreaming/Provider Auth Aliases/Security Fixes
三大新能力 + 33 项问题修复,一文看懂最新版本变化
我是atyou, 今天教大家OpenClaw v2026.4.9 的 Memory Dreaming、Provider Auth、33项安全修复。
OpenClaw v2026.4.9 版本于2026年4月9日发布,这是自突破10万星以来的又一次重要更新。本次更新带来了 Memory Dreaming 重大改进、Provider Auth Aliases 新特性,以及33项问题修复。
今天我将深入解析这次更新的核心变化,特别是 Memory 系统的历史回填能力和新的认证机制,帮助你了解这些变化对实际使用的影响。
文章最后会总结升级注意事项和常见问题,帮助你平滑过渡到新版本。
— — — — — — — — — —
一、版本概览
v2026.4.9 是 OpenClaw 的重要里程碑版本,带来三大核心变化和33项修复。
Step 1更新规模
本次更新包含 5 项新功能(Changes)和 33 项问题修复(Fixes),是近几个月来修复最多的一次版本。
Step 2核心主题
本次更新的核心主题:
• Memory Dreaming 重大升级 — 历史记忆回填
• Provider Auth Aliases — 多实例共享认证
• 安全加固 — 33 项修复覆盖全模块
Step 3发布信息
版本信息:
发布版本: v2026.4.9
发布日期: 2026-04-09
下载量: DMG 346次 / ZIP 664次
发布者: steipete (Peter Steinberger)
💡为什么关注下载量 DMG(macOS)和 ZIP(Windows/Linux)的下载比例反映了用户群体分布。本次 ZIP 下载量接近 DMG 的 2 倍,说明有大量用户运行在服务器或容器环境中。 |
— — — — — — — — — —
二、Memory Dreaming 重大升级
Memory 系统是 OpenClaw 的核心能力之一。v2026.4.9 带来了历史记忆回填功能,让旧的 daily notes 可以「复活」到 Dreams 中。
Step 1问题背景
在之前的版本中,Memory 系统存在「遗忘」问题:旧的 daily notes 无法自动进入 Dreams 和 durable memory,需要重新手动记录。
Step 2Grounded REM Backfill
新增的 grounded REM backfill 能力,通过历史 rem-harness 路径实现自动回填:
# 使用 rem-harness 进行历史回填
openclaw memory dream --path ~/.openclaw/diary/2025-12/
# 查看回填状态
openclaw memory status
📝踩坑记录 #1:回填路径问题 回填目标路径必须是符号链接或真实目录,不能是缺失的路径。解决方案:先创建目标目录或使用绝对路径。 |
Step 3Diary Commit/Reset Flows
新增的 diary commit 和 reset 流程,让你可以管理记忆生命周期:
# 提交当天记忆到 durable memory
openclaw diary commit
# 重置当天记忆(谨慎使用)
openclaw diary reset --force
⚠️警告 diary reset 会清除当天所有未提交的 Memory,这个操作不可逆,请在确认后果后使用。 |
Step 4Durable Fact Extraction
改进了 durable fact extraction 逻辑,从日记中提取更准确的事实:
💡提取逻辑改进 新版本使用更智能的实体识别和关系抽取,能从「今天和张三讨论了Q2计划」这样的句子中提取出「人物: 张三」和「主题: Q2计划」。 |
Step 5Live Short-term Promotion
集成了 live short-term promotion,让短期记忆可以无缝升级为长期记忆:
— — — — — — — — — —
三、Control UI 日记视图升级
Control UI 新增了结构化的日记视图,让你可以直观地管理 Memory Dreaming。
Step 1Timeline 导航
新增的时间轴导航功能,支持按日期快速跳转到历史记录:
Step 2Backfill/Reset 控制
在 UI 中直接控制记忆回填和重置操作:
# UI 操作路径
Control UI → Dreams → Timeline → [Backfill] / [Reset]
Step 3Traceable Dreaming Summaries
每个 Dream 现在都有可追溯的摘要,便于理解记忆来源:
💡追踪价值 可追溯摘要让你知道某段记忆来自哪个原始日记条目,便于验证和修正。 |
Step 4Grounded Scene Lane
新增的 grounded Scene lane,提供 promotion hints:
📝踩坑记录 #2:Scene Lane 可见性 Grounded Scene Lane 默认不显示,需要在设置中启用「Show Scene Lane」才能看到。 |
Step 5Safe Clear-grounded
新增的安全清除 grounded 功能,支持分阶段回填信号:
— — — — — — — — — —
四、Provider Auth Aliases 新特性
Provider Auth Aliases 允许 provider manifests 声明别名,让不同 provider 变体可以共享认证配置。
Step 1解决的问题
之前的痛点:不同 provider 变体(如 openrouter/anthropic 和 anthropic-claude)需要独立配置认证,导致:
• 重复的 API Key 配置
• 不一致的认证状态
• 维护成本高
Step 2实现方式
通过在 provider manifest 中声明 providerAuthAliases:
{
"provider":"anthropic",
"providerAuthAliases":["claude", "anthropic-api"],
"auth":{
"type":"api-key",
"envVar":"ANTHROPIC_API_KEY"
}
}
Step 3共享内容
别名化后可以共享的配置:
• 环境变量 (env vars)
• 认证 profiles
• 配置后认证
• API Key 引导
Step 4使用场景
典型使用场景:
• OpenRouter 多个模型实例共享同一认证
• 本地 Ollama 和云端 Ollama 共享配置
• 同一 API 的不同端点变体
— — — — — — — — — —
五、QA Lab 评估报告升级
QA 模块新增了 character-vibes 评估报告功能,让 Live QA 可以更快地比较候选行为。
Step 1模型选择
支持选择不同的模型进行评估对比:
# 选择评估模型
openclaw qa lab --model claude-sonnet-4
# 对比两个模型
openclaw qa lab --compare claude-sonnet-4 --vs claude-opus-4
Step 2并行运行
支持并行运行多个评估任务:
# 并行运行 3 个评估
openclaw qa lab --run-parallel --count 3
Step 3评估维度
vibes 评估关注的核心维度:
• 响应风格一致性
• 角色扮演准确性
• 交互流畅度
• 上下文保持能力
— — — — — — — — — —
六、33 项安全与问题修复
本次更新修复了33项问题,其中安全相关修复占比最高。
Step 1Browser/Security 修复
修复了交互驱动的主帧导航后的安全检查漏洞:
问题: 点击、evaluate、hook-triggered click 和 batched action flows
可能绕过SSRF 隔离到达禁止的 URL
解决: 在交互后重新运行 blocked-destination 安全检查
⚠️安全重要性 SSRF(服务器端请求伪造)是最严重的 Web 漏洞之一,此修复堵住了可能导致数据泄露的路径。 |
Step 2Security/Dotenv 修复
阻止不安全的运行时控制环境变量:
• 阻止 browser-control override 环境变量
• 跳过 server 环境变量
• 拒绝 unsafe URL 风格的浏览器控制覆盖
Step 3Gateway/Node Exec 修复
标记远程 node 事件为不可信,防止注入:
• exec.started / exec.finished / exec.denied 标记为 untrusted
• 清理 node 提供的 command/output/reason 文本
防止远程输出注入 System: 内容
Step 4依赖安全更新
强制升级了以下依赖:
• basic-ftp → 5.2.1 (CRLF 命令注入修复)
• Hono → 生产路径更新
@hono/node-server → 生产路径更新
📝踩坑记录 #3:FTP 依赖 basic-ftp 的 CRLF 注入漏洞(CVE 相关)可能导致目录遍历攻击。建议所有用户尽快升级。 |
Step 5其他重要修复
值得注意的其他修复:
• Android/pairing: 修复扫描配对可靠性
• Matrix/gateway: 改进 sync 稳定性
• Slack/media: 保留 bearer auth 跨同源重定向
• Gateway/chat: 修复 ANNOUNCE_SKIP 泄露问题
• Providers/Ollama: 支持 thinking 输出显示
— — — — — — — — — —
七、iOS 版本管理改进
iOS 版本管理现在使用显式 CalVer(日历版本),并提供了版本固定工作流。
Step 1CalVer 版本
版本号现在存储在 apps/ios/version.json:
{
"version":"2026.4.9",
"build":"20260409",
"gateway":"2026.4"
}
Step 2版本固定工作流
新增的发布工作流:
# 从 gateway 版本固定 iOS 版本
pnpm ios:version:pin -- --from-gateway
💡为什么要固定 TestFlight 迭代应该在同一短版本上保持多次构建,直到维护者主动推进下一个 gateway 版本。这样可以让测试更聚焦。 |
— — — — — — — — — —
八、升级指南与注意事项
升级到 v2026.4.9 需要注意以下几点。
Step 1前置条件
升级前检查:
• Node.js 版本 ≥ 22
• 至少 2GB 可用磁盘空间
• 建议备份现有配置
Step 2升级命令
标准升级流程:
# 停止网关
openclaw gateway stop
# 升级 OpenClaw
openclaw update
# 重启网关
openclaw gateway start
Step 3回滚方案
如果遇到问题,回滚到上一版本:
# 查看可用版本
openclaw releases
# 回滚到上一版本
openclaw update --to v2026.4.8
Step 4配置迁移
大部分配置自动迁移,以下情况需要手动处理:
• 自定义 provider 配置需要检查 authAliases 兼容性
• Matrix 旧配置会自动迁移 (channels.matrix.dm.policy)
• Android 配对需要重新扫描 QR code
📝踩坑记录 #4:Matrix 配置迁移 旧配置 channels.matrix.dm.policy: "trusted" 会被迁移为 allowlist: allowFrom,迁移后请检查是否与预期一致。 |
— — — — — — — — — —
十二、常见问题与排错
1. Memory Dreaming 回填会影响性能吗?
回填操作在后台异步执行,不会阻塞正常对话。建议在低峰期进行大批量回填。
2. Provider Auth Aliases 支持多少个别名?
理论上无限制,但建议控制在 5 个以内以保持配置可读性。
3. basic-ftp 升级会影响现有 FTP 功能吗?
不会。5.2.1 版本修复了安全漏洞但保持 API 兼容性,现有功能不受影响。
4. Ollama 的 thinking 输出在哪里显示?
需要在配置中设置 /think 为非 off 级别,如 /think: medium。输出会显示在响应之前。
5. 如何检查当前版本?
运行 openclaw version 或访问 Control UI 的 About 页面。
6. 升级后需要重启所有节点吗?
是的,建议重启所有连接的节点(iOS、Android)以确保协议兼容性。
7. Matrix 迁移失败的常见原因是什么?
通常是旧配置格式不完整或 DM policy 设置为不兼容的值。运行 openclaw doctor --fix 可自动修复。
8. Slack media 认证问题是否完全修复?
已修复同源重定向问题。跨域 CDN 仍会正确剥离认证,这是安全设计。
— — — — — — — — — —
十三、安全建议
•始终使用强 API Key,定期轮换
•不要在 .env 文件中存储运行时控制变量
•定期运行 openclaw doctor 检查安全配置
•关注安全公告,及时升级依赖
•生产环境使用 provider allowlist 限制可用模型
⚠️重要提醒 本文中出现的所有 Token 均为示例或已脱敏处理。请务必使用你自己的 Token,并妥善保管。切勿将敏感凭证提交到 Git 仓库。 |
— — — — — — — — — —
总结
v2026.4.9 是 OpenClaw 的重要更新,引入了 Memory Dreaming 历史回填、Provider Auth Aliases、33项修复等关键改进。
关键要点回顾:
•Memory Dreaming新增 grounded REM backfill,支持历史记忆回填
•Diary 流程新增 commit/reset 流程,管理记忆生命周期
•Provider Auth支持别名化,简化多实例认证配置
•QA Lab新增 character-vibes 评估报告
•iOS 版本使用 CalVer,版本固定工作流
•安全修复33 项修复,包括 SSRF、dotenv、node exec 等
— — — — — — — — — —
我是atyou, 您有什么感兴趣的主题,可以给我留言。让我们一起拥抱AI, 共同进步,享受美好生活。
参考文档:
•OpenClaw GitHub 仓库
•v2026.4.9 Release Notes
•OpenClaw 官方文档
•Memory Dreaming 详解
•Provider Auth 配置指南
夜雨聆风