Memory Lancedb Dreaming

Dreaming plugin for memory-lancedb — Light/REM/Deep sleep phases with LanceDB vector memory, narrative generation, and memory promotion.

Install

openclaw plugins install clawhub:memory-lancedb-dreaming

memory-lancedb-dreaming

让 LanceDB 的记忆真正会做梦。

痛点

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

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

能力对比

能力	OpenClaw 原生 dreaming	memory-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 仍不可用（Unknown command: openclaw plugin）。请用手动安装。

推荐生产版本：OpenClaw 2026.5.20。2026.5.22 存在 event loop 回归（#86201/#86194），可能导致 3–8s 响应延迟。

方式 A：安装脚本（推荐）

bash scripts/install.sh memory-lancedb-dreaming-0.1.12.tgz

方式 B：手动解压

mkdir -p ~/.openclaw/plugins/memory-lancedb-dreaming
tar -xzf memory-lancedb-dreaming-0.1.12.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 或 CONFIG BLOCKED ERROR，说明对应 entry 字段未生效。

插件启用时会自动清理遗留冲突 cron（如 dreaming-plugin-healthcheck），避免与自管理 dreaming cron 冲突。

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、lastRun.lastRunAt 可核对实际生效值。

输出文件

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.12 并重启 gateway

bash scripts/install.sh memory-lancedb-dreaming-0.1.12.tgz
openclaw gateway stop 2>/dev/null || true
openclaw gateway run

确认日志：

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

2. dreaming_status 自检

字段	期望
`hooks.cronTriggerReady`	`true`
`hooks.llmModelOverrideReady`	`true`（若配置了 rem.model）
`lastRun.lastRunAt`	触发后有 ISO 时间戳
`effectiveConfig.remModel`	你的 model id
`memoryCount`	> 0

3. 手动 trigger

调用 dreaming_trigger，phase=all。期望产出 light/rem/deep 文件及 DREAMS.md 更新。

4. cron 触发

openclaw cron list
openclaw cron run <dreaming-job-id>

期望数秒内完成，日志含 dreaming trigger received 与 dreaming phases completed。

5. 验收清单

#	测试项	通过标准
1	插件注册	`cronHook=ready`, `modelOverride=ready`
2	dreaming_status	`hooks.cronTriggerReady=true`
3	dreaming_trigger	产出 light/rem/deep 文件
4	REM 语义主题	rem 文件含 LLM 主题名
5	中文叙事	DREAMS.md 含 zh + en
6	cron 触发	trigger received + phases completed
7	冲突 cron 清理	无 `dreaming-plugin-healthcheck`
8	并发互斥	第二次 trigger 被 skip

自定义

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

开发

npm run build
npm test
npm pack