未来已来,只需一句指令,养龙虾专栏导航,持续更新ing…
本文适配2026.4.11+版本
想象一下:你的 AI 助手就像一位朋友,刚认识时彼此陌生,但随着时间推移,他逐渐记住了你的喜好、习惯和重要细节——这正是「梦境」功能的魔力所在。
一、为什么需要「梦境」功能?
1.1 AI 的「健忘症」困境
传统 AI 助手面临一个根本性问题:会话结束后,所有上下文烟消云散。这导致两种极端情况:
| 过度保守 | ||
| 过度囤积 |
梦境(Dreaming) 正是为解决这一痛点而生——它不是简单的存储扩容,而是模拟人类睡眠记忆巩固机制的智能筛选系统。
💡 注:就像人类通过睡眠整理白天学到的知识,重要的记忆被强化,琐碎的细节被过滤,AI 也需要这样一个"休息整理"的过程。
二、梦境的核心原理:三阶段睡眠周期
OpenClaw 的梦境系统借鉴了神经科学的睡眠理论,将记忆整理分为三个严格顺序执行的阶段:

2.1 阶段详解
| Light(浅睡) | |||
| REM(快速眼动) | |||
| Deep(深睡) |
关键机制:只有深睡阶段会实际修改长期记忆。前两个阶段仅生成"强化信号",用于提升候选条目在深睡阶段的评分权重。

2.2 六维评分算法
深睡阶段采用证据驱动的加权评分模型决定记忆去留:
| Relevance(相关性) | |||
| Frequency(频率) | |||
| Query diversity(查询多样性) | |||
| Recency(时效性) | |||
| Consolidation(巩固度) | |||
| Conceptual richness(概念密度) |
评分计算流程:

晋升门槛:候选需同时满足三个硬阈值:
minScore ≥ 0.8(默认,可调整) minRecallCount ≥ 3次 minUniqueQueries ≥ 3个不同查询上下文
⚠️ 重要说明 minScore 可在 0.6~0.85 之间调整,但官方文档明确指出这些阈值是内部实现细节,不暴露为用户配置项。如需调整,只能通过 CLI 命令的命令行参数临时覆盖。
三、开启梦境:配置与命令
3.1 重要修正:默认关闭,需显式开启
实际情况:梦境是实验性功能,默认禁用(
enabled: false),必须手动启用。
3.2 三种开启方式
方式一:配置文件(推荐用于生产环境)
在 openclaw.json 中添加:
{"memory": {"dreaming": {"enabled": true,"frequency": "0 3 * * *","timezone": "Asia/Shanghai"}}}
关键参数说明:
enabled | false | true/false) | |
frequency | "0 3 * * *" | ||
timezone |
⚠️ 注意:
mode(如 core/rem/deep)不是配置项,phase policy 是内部实现细节,不暴露为用户配置。
方式二:聊天命令(适合快速体验)
/dreaming on | ||
/dreaming off | ||
/dreaming status | ||
/dreaming help |
⚠️ 注意:梦境没有"模式"概念,三个阶段是自动顺序执行的内部流程。
方式三:CLI 工具(适合脚本化与预览)
# 🔍 预览哪些候选会被晋升(干运行,不实际写入)openclaw memory promote# ⚠️ 实际应用晋升(谨慎使用)openclaw memory promote --apply# 🔧 限制数量 + 设置临时阈值openclaw memory promote --limit 10 --min-score 0.75# 🧠 解释特定查询的晋升逻辑openclaw memory promote-explain "部署工作流"# 📊 查看详细状态openclaw memory status --deep# 🌙 预览 REM 反思(不写入任何内容)openclaw memory rem-harness# 📋 预览 REM 反思 + JSON 输出openclaw memory rem-harness --json
四、输出产物:梦境日记与长期记忆
4.1 DREAMS.md(人类可读的梦境日记)
每次梦境周期结束后,系统自动生成叙事性总结,例如:
## 🌙 Dream Diary — 2026-04-12 03:00 UTC### 周期概览- 扫描信号:47 条短期记忆- REM 洞察:识别出 3 个重复主题(API 设计、性能优化、团队扩展)- 晋升记忆:5 条进入 MEMORY.md### 关键发现"你近期频繁讨论 GraphQL 与 REST 的权衡,特别是在微服务边界场景下。这看起来是一个持续的技术决策过程,已记录相关偏好。"### 晋升条目摘要1. [技术偏好] 倾向 GraphQL 用于 BFF 层,REST 用于服务间通信2. [项目背景] Q2 重点:支付网关重构(提及 5 次,跨 3 个会话)3. [团队信息] 后端团队计划扩展至 8 人(来自 4 月 10 日对话)
设计意图:DREAMS.md 纯粹是透明度工具,供用户审查 AI 的"思考过程",不参与实际推理。
历史回放(backfill)功能:
# 预览历史文档的 REM 分析结果memory rem-harness --path <file-or-dir> --grounded# 将历史分析写入 DREAMS.md(可逆)memory rem-backfill --path <file-or-dir># 将历史分析暂存到短期记忆池memory rem-backfill --path <file-or-dir> --stage-short-term# 回滚已写入的 REM 分析memory rem-backfill --rollback
4.2 阶段报告文件
除了 DREAMS.md,系统还会在 memory/dreaming/<phase>/YYYY-MM-DD.md 生成每个阶段的详细报告:

4.3 MEMORY.md(机器可用的长期记忆)
晋升后的记忆以结构化格式追加,供后续会话加载:
- **用户技术栈偏好** [晋升分数:0.82, 首次:2026-04-08, 最后:2026-04-12]- 前端:React + TypeScript,偏好函数组件与 Hooks- 后端:Node.js/NestJS,考虑迁移至 Go 微服务- 数据库:PostgreSQL 主库,Redis 缓存层,评估 TiDB 分片方案
五、实操指南:调优与排错
5.1 判断晋升是否过度/不足
5.2 预览与调试流程
推荐的安全测试流程:

Gateway Dreams UI 功能:
显示当前启用状态 展示各阶段计数和受管 Cron 任务 显示短期、已扎根、信号、今日晋升数量 显示下次计划运行时间 可展开的梦境日记阅读器
5.3 与手动记忆管理的对比
适合启用梦境的场景:
✅ 无专职人员维护记忆文件 ✅ 会话频率高,手动整理成本大 ✅ 需要"渐进式了解用户"的伴侣型 Agent
建议禁用梦境的场景:
❌ 已有严格的手动记忆审核流程 ❌ 对记忆准确性要求极高(如医疗、法律) ❌ 需要区分战略决策与战术细节(当前评分模型无法区分)
替代方案:混合模式——启用梦境但延长运行频率(如 0 0 * * 0 每周一次),仅捕获最强信号,人工审核后手动写入 MEMORY.md。
六、架构定位:梦境 vs 其他记忆系统

核心差异:梦境是整合机制而非存储层,它运行在现有架构之上,解决"什么值得记住"的筛选问题。
七、总结与最佳实践
7.1 核心要点回顾

7.2 快速检查清单
已备份现有 MEMORY.md( cp MEMORY.md MEMORY.md.backup)已在配置中设置 enabled: true已运行 openclaw memory status --deep确认状态正常已查看 openclaw doctor memory确认 Cron 任务已注册已运行一次 openclaw memory promote预览效果已检查 DREAMS.md 输出是否符合预期
📌 最后提醒:梦境系统是一个需要耐心调优的功能。建议从小规模测试开始,逐步调整至最适合你工作流的配置。记住,最好的 AI 记忆管理是让你感觉不到它的存在,却能在关键时刻提供恰到好处的上下文支持。
夜雨聆风