docs: 添加 memory-search/dreaming/memory-wiki 官方参考文档

2026-04-21 13:44:35 +08:00
parent 147846c665
commit b7e1a5d34f
4 changed files with 321 additions and 0 deletions
@@ -0,0 +1,79 @@
+# Dreaming 参考文档
+
+> 来源：OpenClaw 官方文档
+> - https://docs.openclaw.ai/concepts/dreaming
+
+## 概述
+
+Dreaming 是后台记忆整理系统，将短期信号整理为持久记忆。**默认禁用，需手动开启。**
+
+## 三个阶段
+
+| 阶段 | 目的 | 持久写入 |
+|------|------|---------|
+| **Light** | 排序和暂存短期材料 | 否 |
+| **Deep** | 评分并提升到长期记忆 | ✅ 写入 MEMORY.md |
+| **REM** | 反思主题和重复模式 | 否 |
+
+## 配置
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "memory-core": {
+        "enabled": true,
+        "config": {
+          "dreaming": {
+            "enabled": true,
+            "frequency": "0 3 * * *",
+            "timezone": "Asia/Shanghai"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `enabled` | false | 是否启用 |
+| `frequency` | `0 3 * * *` | 执行频率（cron 表达式） |
+| `timezone` | 系统时区 | 时区 |
+
+## 输出文件
+
+- `DREAMS.md`（或 `dreams.md`）：人类可读的梦境日记
+- `memory/dreaming/<phase>/YYYY-MM-DD.md`：阶段报告
+- `memory/.dreams/`：机器状态（recall store、信号、检查点）
+
+## Deep 排序信号（6个权重）
+
+| 信号 | 权重 | 说明 |
+|------|------|------|
+| Frequency | 0.24 | 短期信号累计次数 |
+| Relevance | 0.30 | 平均检索质量 |
+| Query diversity | 0.15 | 不同查询/天上下文 |
+| Recency | 0.15 | 时间衰减新鲜度 |
+| Consolidation | 0.10 | 跨天重复强度 |
+| Conceptual richness | 0.06 | 概念标签密度 |
+
+## CLI 命令
+
+```bash
+/dreaming status    # 查看状态
+/dreaming on        # 启用
+/dreaming off       # 禁用
+
+openclaw memory promote          # 预览待提升项
+openclaw memory promote --apply  # 执行提升
+openclaw memory promote-explain "关键词"  # 解释某候选
+openclaw memory rem-harness      # 预览 REM 反思
+```
+
+## 关键点
+
+- Deep 阶段需要 `minScore`、`minRecallCount`、`minUniqueQueries` 都通过才提升
+- 提升前会从原始文件重新验证片段，已删除的跳过
+- Dreaming 生成的日记条目不参与短期提升