ClawHubCN
@airbing11

Memory Lancedb Dreaming

OpenClaw built-in dreaming breaks with LanceDB — output is just meaningless category labels. This plugin restores it with LLM semantic themes + bilingual dream narratives.

下载插件 查看 Git 源码
当前版本
v0.1.10
code-plugin社区source-linked

memory-lancedb-dreaming

让 LanceDB 的记忆真正会做梦。

痛点

从 memory-core 切到 memory-lancedb 后，OpenClaw 自带的 dreaming 就彻底不工作了。 就算勉强跑起来，输出的也只是 fact / other 这种聚类标签，毫无阅读价值。

本插件专为 memory-lancedb(-pro) 重新实现了完整的 dreaming 流程。

能力对比

能力OpenClaw 原生 dreamingmemory-lancedb-dreaming
lancedb 兼容❌✅
语义化主题命名❌✅（REM 可选 LLM 命名）
多语种叙事输出（中/英）❌✅
多级提升链Light→REM→Deep 简化版Light(近期观测)→REM(category 分布分析)→Deep(提升决策)
结构化反思表❌✅ 主题+置信度+证据链
提升阈值自定义❌✅ 可配置 maxPromotions/minScore 等
lookback 时间窗部分支持✅ Light/REM 按 recall 信号过滤
独立输出文件写回 memory 日记DREAMS.md + light/rem/deep 各阶段独立文件

安装

OpenClaw 2026.5.20 若 openclaw plugin install 不可用，请用手动方式：

# 方式 A：从 tarball 解压安装（推荐测试）
mkdir -p ~/.openclaw/plugins/memory-lancedb-dreaming
tar -xzf memory-lancedb-dreaming-0.1.9.tgz -C /tmp
cp -r /tmp/package/* ~/.openclaw/plugins/memory-lancedb-dreaming/
cd ~/.openclaw/plugins/memory-lancedb-dreaming && npm install --omit=dev

禁止 安装到 ~/.openclaw/workspace/。该路径会导致 plugins.load.paths 校验失败、gateway 无法启动。

在 openclaw.json 中配置。必须同时配置以下两项 entry 级字段（不是 config 内字段）：

字段何时必须缺少时的后果
hooks.allowConversationAccess: true始终（启用 dreaming 时）cron 不执行 pipeline，agent 空转 ~120s
subagent.allowModelOverride: true配置了 rem.model 或 narrative.model 时LLM 模型覆盖被拦截，REM 退化为 category 标签
{
  "plugins": {
    "load": {
      "paths": [
        "/root/.openclaw/plugins/memory-lancedb-dreaming"
      ]
    },
    "allow": ["memory-lancedb-dreaming"],
    "entries": {
      "memory-lancedb-dreaming": {
        "enabled": true,
        "hooks": {
          "allowConversationAccess": true
        },
        "subagent": {
          "allowModelOverride": true
        },
        "config": {
          "enabled": true,
          "cron": "0 3 * * *",
          "timezone": "Asia/Shanghai",
          "autoManageCron": true,
          "light": { "enabled": true, "lookbackDays": 2, "limit": 100 },
          "rem": {
            "enabled": true,
            "lookbackDays": 7,
            "limit": 10,
            "minPatternStrength": 0.45,
            "model": "your-model-id"
          },
          "deep": {
            "enabled": true,
            "maxPromotions": 5,
            "minScore": 0.7,
            "minRecallCount": 3,
            "maxAgeDays": 30
          },
          "narrative": {
            "enabled": true,
            "languages": ["zh", "en"]
          }
        }
      }
    }
  }
}

修改 hooks、subagent 或 load.paths 后必须 完整重启 gateway。

⚠️ 禁止依赖 config hot reload：热加载后日志可能仍显示 cronHook=ready，但 hook 不会重新注册。请执行 openclaw gateway stop → openclaw gateway run。

若曾安装到 workspace 路径，需同时清理三处残留：

grep -r "workspace/memory-lancedb-dreaming" ~/.openclaw --include="*.json"
# 清理 openclaw.json、openclaw.json.last-good、plugins/installs.json 中的 stale 路径/记录

启动后日志应出现 cronHook=ready 和 modelOverride=ready（若配置了 rem.model）。若为 blocked 或 ERROR，说明对应 entry 字段未生效。

OpenClaw 2026.5.20 可能自动将插件加入 plugins.allow；显式配置 allow 可确保万无一失。

rem.model 或 rem.execution.model：配置后 REM 阶段会按 category 分组 调用 LLM 生成中英文主题名；必须配合 subagent.allowModelOverride: true，否则回退到 category 标签。

narrative.model 未配置时会自动回退到 rem.model。叙事语言由 narrative.languages 控制（如 ["zh","en"]）。

每次 dreaming 运行时会从 runtime / 磁盘重新读取配置；dreaming_status 的 effectiveConfig 与 hooks.llmModelOverrideReady 可核对实际生效值。

输出文件

  • DREAMS.md — 梦境叙事日记（叙事散文 + 结构化反思概览）
  • memory/dreaming/light/YYYY-MM-DD.md — Light 阶段原始观测
  • memory/dreaming/rem/YYYY-MM-DD.md — REM 阶段主题模式
  • memory/dreaming/deep/YYYY-MM-DD.md — Deep 阶段提升记录
  • memory/dreaming/YYYY-MM-DD-consolidation.md — 完整报告

OpenClaw 测试流程

在 Ubuntu / OpenClaw 2026.5.20 上按顺序执行：

0. 前置检查

openclaw --version
node --version
ls ~/.openclaw/plugins/memory-lancedb-dreaming/dist/index.js
grep -r "workspace/memory-lancedb-dreaming" ~/.openclaw --include="*.json" || echo "no stale workspace path"

1. 安装 v0.1.9 并重启 gateway

# 解压安装（见上方安装节）
openclaw gateway stop 2>/dev/null || true
openclaw gateway run   # 或 systemd / 你的启动方式

确认日志：

grep "memory-lancedb-dreaming" ~/.openclaw/logs/* 2>/dev/null | tail -5
# 期望: registered ... cronHook=ready ... modelOverride=ready
# 禁止: cronHook=blocked 或 allowConversationAccess DISABLED

2. dreaming_status 自检

在 agent 会话中调用 dreaming_status tool，或：

# 若 CLI 支持 tool 调用则用 CLI；否则在 Web UI / agent 里触发

检查 JSON 字段：

字段期望
hooks.cronTriggerReadytrue
hooks.llmModelOverrideReadytrue（若配置了 rem.model）
effectiveConfig.remModel你的 model id
effectiveConfig.narrativeLanguages["zh","en"]
llm.subagentAvailable 或 llm.llmCompleteAvailable至少一个 true（REM/叙事需要）
memoryCount> 0（否则 REM/Deep 可能无内容）

3. 手动 trigger（不依赖 cron hook 路径）

调用 dreaming_trigger，phase=all。

期望：

  • 返回 ok: true
  • workspace 下生成 memory/dreaming/light|rem|deep/ 当日 md
  • 若 narrative 启用且 LLM 可用：DREAMS.md 有新段落
WORKSPACE=$(jq -r '.agents.defaults.workspace // empty' ~/.openclaw/openclaw.json)
DATE=$(date +%F)
ls -la "$WORKSPACE/memory/dreaming/light/$DATE.md" 2>/dev/null
ls -la "$WORKSPACE/memory/dreaming/rem/$DATE.md" 2>/dev/null
ls -la "$WORKSPACE/DREAMS.md" 2>/dev/null
grep -E "Theme:|主题" "$WORKSPACE/memory/dreaming/rem/$DATE.md" | head

REM 成功标志：主题行含 LLM 生成的中英文名称，而非仅 fact 1.00 / other 0.94 分类标签。

4. cron 触发测试

openclaw cron list
# 应看到 memory-lancedb-dreaming 管理的 job，不应再报 plugin not found

openclaw cron run <dreaming-job-id>

期望 gateway 日志（约数秒内完成，不应再跑满 120s LLM）：

memory-lancedb-dreaming: dreaming trigger received, running phases...
memory-lancedb-dreaming: dreaming phases completed (light=..., rem=..., promoted=..., narrative=...)

5. 互斥锁（可选）

连续两次快速 dreaming_trigger 或 cron run：第二次应返回 pipeline busy / 日志 pipeline already running。

6. 验收清单

#测试项通过标准
1插件注册日志 registered, cronHook=ready
2dreaming_statushooks.cronTriggerReady=true
3dreaming_trigger产出 light/rem/deep 文件
4REM 语义主题rem 文件含 LLM 主题名
5中文叙事DREAMS.md 含 zh + en 段落
6cron 触发日志 trigger received + phases completed
7Deep promotedAt仅实际 append 的条目带 promotedAt
8并发互斥第二次 trigger 被 skip

自定义

所有阈值参数和语言设置均可通过 openclaw.json 中的 config 自定义：

"deep": { "maxPromotions": 3, "minScore": 0.8 },
"narrative": { "languages": ["zh"] }

开发

npm run build
npm test
npm pack

Credits

  • Project Owner & Tester: airbing11
  • Developer: Cursor IDE (AI-assisted development)
  • QA & Documentation: 小泡 (AI assistant)

许可证

MIT © 2026 airbing11

发布渠道

  • Clawhub 主站
  • Clawhub 镜像站（skillhub 等）
  • GitHub Release + Discussions

源码与版本

源码仓库

airbing11/memory-lancedb-dreaming

打开仓库

源码提交

v0.1.10

查看提交

安装命令

openclaw plugins install clawhub:memory-lancedb-dreaming

元数据

  • 包名: memory-lancedb-dreaming
  • 创建时间: 2026/05/24
  • 更新时间: 2026/05/24
  • 执行代码: 是
  • 源码标签: v0.1.10

兼容性

  • 构建于 OpenClaw: 2026.5.20
  • 插件 API 范围: >=2026.5.18
  • 标签: dreaming, lancedb, latest, memory, narrative
  • 文件数: 109