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,116 @@
+# Memory Wiki 参考文档
+
+> 来源：OpenClaw 官方文档
+> - https://docs.openclaw.ai/plugins/memory-wiki
+
+## 概述
+
+Memory Wiki 将持久记忆编译为结构化知识库，不替代 active memory plugin。
+
+## Vault 模式
+
+| 模式 | 说明 |
+|------|------|
+| `isolated` | 独立 vault，不依赖 memory-core |
+| `bridge` | 从 memory-core 读取公开 artifact |
+| `unsafe-local` | 本地文件系统直接访问（实验性） |
+
+## Vault 目录结构
+
+```text
+<vault>/
+  AGENTS.md
+  WIKI.md
+  index.md
+  inbox.md
+  entities/      # 实体（人、系统、项目）
+  concepts/      # 概念、模式、策略
+  syntheses/     # 编译摘要
+  sources/       # 导入的原始材料
+  reports/       # 仪表板报告
+  _attachments/
+  _views/
+  .openclaw-wiki/
+```
+
+## 配置（isolated 模式）
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "memory-wiki": {
+        "enabled": true,
+        "config": {
+          "vaultMode": "isolated",
+          "vault": {
+            "path": "~/.openclaw/wiki/main",
+            "renderMode": "obsidian"
+          },
+          "bridge": {
+            "enabled": false
+          },
+          "search": {
+            "backend": "shared",
+            "corpus": "all"
+          },
+          "render": {
+            "preserveHumanBlocks": true,
+            "createBacklinks": true,
+            "createDashboards": true
+          },
+          "ingest": {
+            "autoCompile": true,
+            "maxConcurrentJobs": 1
+          },
+          "obsidian": {
+            "enabled": true
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## 关键配置项
+
+| 配置项 | 说明 |
+|--------|------|
+| `vaultMode` | `isolated` / `bridge` / `unsafe-local` |
+| `vault.renderMode` | `native` 或 `obsidian` |
+| `search.backend` | `shared`（共享记忆搜索）或 `local` |
+| `search.corpus` | `wiki` / `memory` / `all` |
+| `render.createBacklinks` | 生成相关链接 |
+| `render.createDashboards` | 生成仪表板页面 |
+| `ingest.autoCompile` | 自动编译 |
+
+## Agent 工具
+
+| 工具 | 说明 |
+|------|------|
+| `wiki_status` | vault 模式、健康状态 |
+| `wiki_search` | 搜索 wiki 页面 |
+| `wiki_get` | 读取 wiki 页面 |
+| `wiki_apply` | 窄范围修改（synthesis/metadata） |
+| `wiki_lint` | 结构检查、provenance、矛盾、问题 |
+
+## CLI 命令
+
+```bash
+openclaw wiki status      # 状态
+openclaw wiki doctor      # 诊断
+openclaw wiki init        # 初始化
+openclaw wiki ingest <path>  # 导入内容
+openclaw wiki compile     # 编译
+openclaw wiki lint        # 检查
+openclaw wiki search "query"  # 搜索
+```
+
+## Bridge 模式可索引的内容
+
+- exported memory artifacts
+- dream reports
+- daily notes
+- memory root files
+- memory event logs