文章

OpenClaw梦境系统使用介绍

OpenClaw梦境系统使用介绍

OpenClaw梦境系统使用介绍

本文整理 OpenClaw 2.x / 2.5 路线上围绕 Dream Engine(梦境 / 记忆抽象系统) 的能力划分、工作流、指令与场景示例。安装方式、子命令与频道行为会随版本迭代变化,以当前环境 openclaw --help 官方文档为准


一、2.x 新功能概览

功能模块关键改进使用上的直接收益
① Dream Engine(记忆 / 梦境系统)引入 Dream 概念:对原始 Memory 片段做 向量化 → 聚类 → 抽象,得到可搜索的「概念节点」;支持 Dream-Share(跨 Agent 共享)与 Dream-Generate(按目标触发生成)。记忆从静态长文本,变为 可检索、可复用、可跨会话共享 的结构化层;多 Agent 可基于同一组 Dream 协同。
② Agent-to-Agent 通信 v2Dream-Relaydream_id 在 Agent 间传递 Dream;session-relay 可做一次 Dream 的即时同步。少手动复制大段上下文,利于 多角色编排(如市场 → 策划 → 执行)。
③ Skill Hub 2.0/skill install <keyword> 一键装技能;Skill-TemplateSkill-Scoring 推荐;社区技能(如 ClawHub)可声明式拉取。技能安装与更新成本更低,便于按任务挑选合适 Skill。
④ 多渠道统一交互channel: unified 可统一 Telegram / Slack / 飞书 / Discord 等侧指令语义;部分版本提供 auto-reply 等风格策略。指令与习惯在一处维护,多通道体验一致。
⑤ 可视化 DashboardWeb 侧展示 资源、Memory 统计、Dream 进度、费用与配额 等;支持 Dream-Snapshot 的导入与导出。便于运维、审计与成本可见性。
⑥ 安全与权限按 Agent 的 沙箱目录、敏感操作的 确认 / 审计、凭证轮换与日志等能力(以实际版本说明为准)。降低误删、误用密钥与越权访问风险。

二、Dream 系统工作流

Dream 将「碎片化的 Memory」提升为可管理的概念单元,典型流水线如下。

1
2
3
4
5
6
7
Memory(原始片段)
  → 向量化(embedding)
  → 写入向量库(如 Milvus,具体以部署为准)
  → 周期聚类(如每 24h)→ 生成 Dream-node
  → Dream-Generator(LLM)输出抽象概念与标题
  → 持久化为 dream_id + 描述
  → 可 share 给其他 Agent / Session

要点简要:Dream 是 Memory 之上的抽象层检索与共享 往往围绕 dream_id 与概念文本进行。部署形态(是否自带向量库、聚类周期)以官方与自建配置为准。

2.1 关键指令(会话内 /dream 示例)

指令说明示例
/dream list列出当前 Session 下已挂接的 Dream ID 与标题/dream list
/dream show <id>查看指定 Dream 的摘要、来源片段、关联对象/dream show d12
/dream propose <goal>按目标在已有 Dream / Memory 中检索并给出可执行建议/dream propose 整理本周 Obsidian 学习笔记
/dream generate <title>手动触发一次 Dream 构建(多为主持人或管理策略允许时)/dream generate 知识库-「Docker 实践」主题归纳
/dream share <id> <target>将 Dream 同步到目标 Agent 或 Session 标识/dream share d12 session-writing

若使用 CLI 而对话里使用 / 指令,可对照为同一语义下的子命令(例如 openclaw dream listopenclaw dream show <id>),以 openclaw dream --help 输出为准。

2.2 工作区、config get 与 Memory 日文件落点

openclaw config get agents.defaults.workspace 若提示 Config path not found: agents.defaults.workspace

  • 一般不必惊慌:多表示主配置里还没有显式写 agents.defaults.workspace 这一键,CLI 在「读文件」时找不到对应路径;运行时仍采用程序内置默认,通常为 %USERPROFILE%\.openclaw\workspace(类 Unix 上为 ~/.openclaw/workspace)。
  • 每日记忆文件在磁盘上的位置由「工作区根目录 + 固定子目录」决定,与 OpenClaw Memory 概念 一致:
    • 日更:{workspace}/memory/YYYY-MM-DD.md(多为追加写入,会话侧会读「今、昨」等)
    • 可选长记忆:{workspace}/MEMORY.md
  • 希望 config get 能打印出值、或要固定到指定目录时,在 %USERPROFILE%\.openclaw\openclaw.json手动加入 agents.defaults.workspace 即可,无需视为「没配就坏了」。示例(JSON5,路径按本机改;Windows 下可用正斜杠或转义反斜杠):
1
2
3
4
5
6
7
{
  agents: {
    defaults: {
      workspace: "C:/Users/你的用户名/.openclaw/workspace"
    }
  }
}

保存后可再执行 openclaw config get agents.defaults.workspace 核对;是否需重启 / 重载网关以生效,以官方配置说明与当前版本为准。配置文件真实路径还可用 openclaw config file 查看。


三、使用场景与案例(本地 Obsidian 知识库)

场景目标步骤思路预期效果
① Inbox 与碎片笔记「升维」Inbox、速记里零散段落变成可复用的主题相关片段进入 Memory 后,用 propose 让 Dream 在「待整理论述」中聚类、命名 → 得到 dream_id 与概念摘要。减少「只堆不改」;后续写 MOC专题页时有统一入口。
② 周期性回顾(周 / 月报)回顾一段时间内在库里写了什么、主线是什么结合周期任务或手动:propose 本周/本月 Obsidian 学习主线show 查看 Dream 中的主题列表 → 再让 Agent 在库中生成或更新回顾型笔记(路径落在上述根目录下约定文件夹)。与日历笔记、Periodic Notes 等习惯互补,多一层概念层总览。
③ 专题深耕(如「K8s」「读书」类目录)同一父文件夹下多文合并成一条「学习曲线」对该目录有写入权的 Memory 聚类后 generate 指定专题标题的 Dream,或从 propose 选中的 Dream 继续对话。子主题自动浮现,写长文或做 Dataview/索引 前先有高层结构。
④ 读—写 双会话协同一个会话做检索与摘要,另一个会话成稿阅读 / 整理 Session 里生成 Dream → share <id> writing-session写作 Session 只引用 Dream,避免两窗互相污染上下文。与「剪藏进库再输出」工作流一致,Dream 作中间接力
⑤ 去重与边界澄清多篇文章反复写相近观点聚类后 Dream 会标出同一概念下的多条来源片段;你在 Obsidian 里合并页面或加 canonical 链接 时更有据可依。知识库更干净,双向链接负担减轻。

四、场景示例:命令行、知识库路径与多会话协作

知识库根目录与上节相同;子路径(如 00-InboxMOC)请按你 Vault 里真实文件夹改下述示例中的落盘位置。

4.1 从「本周笔记」到一份 Dream,再回写库(CLI 示意)

Windows 终端(PowerShell 或你常用环境)中,子命令名称以 openclaw dream --help 为准:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 0. 知识库根:C:\Users\hands\Documents\Obsidian Vault\
#    (Obsidian 中打开该文件夹作为 Vault;OpenClaw 侧 Memory 来源以你的 Skill/集成为准。)

# 1. 根据目标,从已索引的笔记类 Memory 与既有 Dream 中提出「本周学习/工作主线」
openclaw dream propose 本周 Obsidian 笔记主题归纳

# 2. 查看生成的 Dream(假设 ID 为 d-obs-01)
openclaw dream show d-obs-01
# 输出示例(示意):
# Title: 本周:Docker 网络与卷管理交叉笔记
# Summary: 来自 Daily/2026-04-10 与 专题/Docker-实践.md 的片段在「持久化与网络」上汇聚……

# 3. 将同一 Dream 交给「写作」侧会话,避免在整理会话里越写越长
openclaw dream share d-obs-01 session-obs-writing

# 4. 在 writing 会话中,让 Agent 结合 /dream show d-obs-01
#    在 Vault 中新建或更新一篇 MOC,例如:
#    C:\Users\hands\Documents\Obsidian Vault\MOC\Docker-周回顾-2026-W15.md

成稿落盘、具体文件名与是否调用 Obsidian 相关 Skill 以你的配置与确认为准。

4.2 三阶工作流:入库 → Dream → 回链

  1. 收集:在 Obsidian 中照常记录(日课、Inbox、剪藏转 MD),并保证这些内容能进入 OpenClaw Memory(见上文集成文)。
  2. 聚类与抽象:定期或按需执行 propose / 等待周期 Dream-job,得到带 dream_id概念节点与摘要。
  3. 回写与链接:在对应 Session 中根据 Dream C:\Users\hands\Documents\Obsidian Vault\ 维护 MOC、专题页,并在原文档中加「已被某某 Dream 覆盖」的说明(手动作业或 Agent 代写,视权限而定)。

这样,库目录仍是唯一事实源,Dream 提供跨片段的导航与总览层,与 Dataview 等插件不冲突、互为补充。


五、梦境扫描时间与计划调整

梦境 / Dreaming(控制面板里常标为浅睡、深睡、REM)是后台的记忆巩固任务。界面里若显示 「下次扫描 3:00」 且三格时间一致,多表示按本地时区、每日固定一轮(很多版本默认在凌晨 3:00 左右;以你本机 Dashboard 与 openclaw 行为为准)。调整方式分 界面、配置文件、命令行 三路径。

5.1 方式一:修改面板定时任务配置

  • 进入 控制面板 → 记忆 / 梦境(「场景」页可看到正在归档零散思绪、DREAMING 运行中等状态)。
  • 点底部 浅睡 / 深睡 / REM 旁的时间(或带状态圆点的一行);若该版本支持,会弹出时间选择或分阶段设置。
  • 打开 「高级」 标签,检查是否有全局时区、统一执行时刻、或各阶段是否合并为同一套夜间计划等选项。
  • 修改后看 「下次扫描」 是否更新;无变化时重启或重载一次 Gateway 并刷新页面。

说明:若三个时间始终联动为同一钟点,多数实现里表示同一轮梦境里依次跑三个阶段,改其一即整轮的时刻;分档独立的界面则会允许浅睡/深睡/REM 各不同。以你点按后的实际效果为准。

5.2 方式二:修改openclaw.json配置文件

不同发行版的键名会演进,但常见落点在 plugins.entries 下与 memory 相关的插件(如 memory-core)的 configdreaming 一带,可能包含:

  • 类 cron 的调度(例如将「每天 3:00」改为其他时刻时,注意 5 段 cron 与系统时区;若文档里出现 0 3 * * * 类写法,改分钟与小时即可,并确认解释的是本地还是 UTC)。
  • 分阶段 interval(如 30m2h)表示间隔重复,语义可能与界面上的「指到几点的 3:00」不是同一种——务必对照官方 Memory / Dreaming 说明当前版配置 schema

操作建议:先备份 openclaw.json;改后执行本机若存在的校验(如 openclaw config validate),再重载/重启网关,回到 Dashboard 核对 「下次扫描」

5.3 memory命令使用

openclaw memory --help 为准,可尝试(子命令因版本可能略有不同):

1
2
3
openclaw memory dream status
openclaw memory dream recent
openclaw doctor memory

用于查看梦境任务是否已注册、最近运行与计划等;若无对应子命令,以安装的 CLI 帮助为准


六、openclaw wiki简介

openclaw wiki 是 CLI 的子命令族openclaw wiki …),由捆绑插件 memory-wiki 提供能力:把长期记忆整理成可维护的「维基层」(有固定版式页面、claims(主张)+ 证据、来源、开放问题、矛盾 等元数据,而不只是一堆散 Markdown)。它不替代 memory-core召回、索引、梦境、升格;两者并列:前者管「堆文件」,后者管「可检索、可推理、有谱系的编译知识」。

官方说明:Memory Wiki 插件 · CLI: wiki

6.1 wiki配置开启

  1. ~/.openclaw/openclaw.jsonplugins.entries 中启用插件(JSON5 示例,可和现有 memory-core 并列):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
"memory-wiki": {
  "enabled": true,
  "config": {
    "vaultMode": "isolated",
    "vault": {
      "path": "~/.openclaw/wiki/main",
      "renderMode": "obsidian"
    },
    "render": {
      "createBacklinks": true,
      "createDashboards": true
    }
  }
}
  • 最小只需 enabled: true;未写 config 时用内置默认,路径与模式以插件文档为准。
  • vaultMode 常用值:
    • isolated:独立 wiki 库,不读 memory-core 内部。
    • bridge:从 memory-core 暴露的桥接物 拉取梦境报告、日笔记、记忆根文件 等,再编进 wiki(需文档中 bridge 各开关版本支持一致)。
  • 修改后保存配置,重启或重载网关,再在浏览器打开控制面板中 Memory Wiki / 梦境日记 相关页。

6.2 wiki命令行使用

在终端中(子命令以 openclaw wiki --help 为准):

1
2
3
4
5
openclaw wiki doctor
openclaw wiki status
openclaw wiki init
openclaw wiki compile
openclaw wiki search "关键词"
  • doctor / status:看 vault 是否就绪、模式与健康。
  • init:首次建目录树(entities/concepts/syntheses/sources/reports/ 等)。
  • compile:把页面编译成机器可读的 digest(供检索与 Agent)。
  • 更高级的 wiki_get / wiki_apply / wiki_lint 多由会话内工具或后续文档使用;详见官方 CLI: wiki

6.3 和梦境界面里「导入洞见 / 记忆宫殿」的对应关系

界面提示含义与配置/操作上的启示
Imported insights 为空多表示尚未完成 带 apply 的 ChatGPT/外部历史导入;需在 Dashboard 里按产品提供的 import 流 操作,不是只改 JSON 就会满。
Memory palace 未填充wiki 中 entities / concepts / syntheses编译页尚少;除 openclaw wiki compile 外,还依赖 wiki_apply 或 Agent 写综合页;若用 bridge 模式并打开 indexDreamReports 等,可加速从 memory-core 梦境产物 侧汇聚材料。

七、小结

  • DreamMemory 从「只读长上下文」补上一层 可 id 化、可共享、可检索 的概念抽象,适合多 Agent 与多会话场景。
  • 本地 Obsidian 库 搭配时,以 C:\Users\hands\Documents\Obsidian Vault\ 为成稿与链接的事实落点,让 Dream 承担 聚类与导航,笔记文件仍由你或 Agent 在明确路径下维护。
  • agents.defaults.workspace 未出现在 config get时,优先理解为「使用默认工作区」;只有在需要固定盘符/目录时,再向 openclaw.json 显式写入该键。
  • Dreaming 扫描时间可在 Dashboard(浅睡/深睡/REM 或「高级」)openclaw.json 的 dreaming 相关配置 中调整,改后核对「下次扫描」并以官方文档确认字段名。
  • openclaw wiki + memory-wiki§六 单独说明;需要可编译、可质证的长期知识层时启用,与 memory-core 分工协作。
  • 实际落地时,优先固定一套指令习惯(对话 /dream 与 CLI 二选一对照),并 以官方文档与当前版本 校准子命令、频道与安全选项。

八、升级、迁移与安全

步骤操作建议
升级到 2.x使用发布说明中的升级入口(如部分发行版提供 openclaw upgrade --from 1.x --target 2.5 等);执行前备份 ~/.openclaw 与项目内 openclaw.json、技能目录。
Dream 与旧记忆若提供 openclaw dream migrate 等工具,将历史 MEMORY 类片段 索引化 / 向量化 为 Dream-Index,迁移完成后再关旧路径(以发布说明为准)。
安全基线定期 openclaw security audit(如支持 --deep 全量审计);生产中开启敏感写操作的二次确认与审计日志留存。
日常启动openclaw start 或按你使用的 Gateway / Docker / systemd 方式拉起;新功能加载依赖配置中的技能与记忆后端已就绪。
本文由作者按照 CC BY 4.0 进行授权