📦 OpenClaw Obsidian Memory — OpenClaw Obsidian 内存

OpenClaw + Obsidian Vault 永久记忆体系 利用 Obsidian 风格的本地知识库增强 OpenClaw 的记忆能力，实现双通道检索 + 自动归档。 兼容平台：Linux / macOS / Windows（Node.js 跨平台，无需 bash）

架构 用户提问 ↓

• obsidian-search.js（Vault 知识库，评分排序）

↓

• memory_search（本地 memory，近3天热记忆）

↓

• 合并结果，优先 Vault 知识内容

核心原则：Vault 是主要知识源，memory 是会话热记忆补充。

快速搭建

• 创建 Vault 目录结构

VAULT="$HOME/.obsidian-vault" mkdir -p "$VAULT"/{notes/{areas,projects,daily},references/{ai-chats,web-clips,books},templates,scripts} Windows 用户：在 Git Bash / WSL / PowerShell 中执行相同命令即可。

• 部署脚本

将 scripts/ 下的脚本复制到 Vault 的 scripts/ 目录： obsidian-search.js — 智能检索（评分 + 上下文截取） obsidian-links.js — 链接分析（图谱 + 孤立笔记检测） cp scripts/obsidian-search.js "$VAULT/scripts/" cp scripts/obsidian-links.js "$VAULT/scripts/" 跨平台说明：脚本使用 Node.js 编写，Linux / macOS / Windows 均可直接运行，无需 bash。

• 创建初始笔记

在 notes/areas/ 下创建以下永久笔记（参见 references/templates.md）： 笔记 用途 user-preferences.md 用户偏好与工作规则 system-config.md 系统环境配置 installed-skills.md 已安装技能清单 known-issues.md 已知问题跟踪 在 notes/projects/ 下创建 task-index.md 作为任务索引。

• 配置 OpenClaw

4a. 更新 AGENTS.md 在 AGENTS.md 的记忆规则部分，替换为以下完整方案（核心：按需检索 + 双写 + 去重 + Obsidian 笔记规范）：

记忆规则

检索机制（双通道，按需触发）

不是会话开始盲搜，而是根据用户问题按需检索：

• 先检索 Obsidian Vault：提取用户问题中的关键词，执行 exec node ~/.obsidian-vault/scripts/obsidian-search.js <关键词> - 可通过环境变量 OBSIDIAN_VAULT 自定义 Vault 路径
• 再检索本地 memory：memory_search 最近 3 天记忆
• 两步结果合并，优先使用 Vault 中的知识内容

触发时机：

• 用户提出知识性、概念性问题时
• 用户询问历史决策、偏好、配置时
• 任务完成后需要记录结论时
• 每次重要对话结束时（对话存档）

写入机制（双写 + 去重）

任务完成后，同时写入两个位置：

• Obsidian Vault：写入对应分类笔记
• 知识/概念 → notes/areas/<主题>.md
• 项目进展 → notes/projects/<项目>.md
• 每日思考 → notes/daily/YYYY-MM-DD.md
• 本地 memory：写入 memory/YYYY-MM-DD.md，更新 MEMORY.md 索引

写入前必须去重：先用检索检查 Vault 和 memory 是否已有类似记录，有则合并更新，不重复堆积。

笔记规范（Obsidian 风格）

• 双向链接：新建笔记时至少链接到 1 个已有笔记（[[笔记名]]），避免孤立
• 标签：每篇笔记必须有标签（#永久笔记、#项目/xxx、#daily 等）
• 原子化：一个笔记只记录一个主题，不混杂
• 上下文：写结论时不写过程，只写最终答案和关键依据

对话存档

每次重要对话结束时，将摘要存入 references/ai-chats/YYYY-MM-DD-slug.md：

• 提取关键结论、决策、待跟进事项
• 不复制原始对话，只写加工后的摘要
• 加上标签和双向链接

维护规则

• 定期用 node obsidian-links.js --orphans 检查孤立笔记，补充链接
• 每周 cron 自动归纳 7 天笔记，去重合并到永久笔记
• Vault 是主要知识源，memory 是热记忆补充，两者保持同步

4b. 精简 MEMORY.md 将 MEMORY.md 精简为轻量索引，详细内容指向 Vault： # 记忆索引

轻量索引，详细内容见 Obsidian Vault

用户偏好

• 中文优先，技术术语可英文
• 简洁直接，不要废话
• 不确定就直说

系统配置

• Gateway、模型、Chrome 版本等

已知问题

• 当前已知的问题列表

数据存储

• Obsidian Vault: ~/.obsidian-vault/（知识库 + 对话存档）
• 本地 memory: memory/ 目录（近3天热记忆）
• 检索顺序: 先 Vault → 再 memory → 合并结果

⚠️ 重要：MEMORY.md 保持 < 1000 字，避免膨胀。详细内容写入 Vault。

• 配置定时归档（可选）

通过 openclaw cron 添加两个定时任务： 每日归档（每天凌晨 2:00）： openclaw cron add --name "daily-memory-archive" --cron "0 2 " --tz "Asia/Shanghai" --timeout-seconds 120 --session "isolated" --no-deliver --message "每日记忆归档：总结过去24小时会话，写入 Vault/notes/daily/YYYY-MM-DD.md 和 memory/YYYY-MM-DD.md" 每周归纳（每周一凌晨 3:00）： openclaw cron add --name "weekly-memory-summary" --cron "0 3 * 1" --tz "Asia/Shanghai" --timeout-seconds 180 --session "isolated" --no-deliver --message "每周记忆归纳：汇总7天笔记 + task_manage，去重合并写入 Vault/notes/areas/ 永久笔记和 MEMORY.md"

检索使用 基础检索 # 默认 Vault 路径（$HOME/.obsidian-vault） node ~/.obsidian-vault/scripts/obsidian-search.js "关键词" # 自定义 Vault 路径 OBSIDIAN_VAULT=/path/to/my/vault node ~/.obsidian-vault/scripts/obsidian-search.js "关键词" 多关键词（AND 语义） node ~/.obsidian-vault/scripts/obsidian-search.js "openclaw" "记忆" 调整结果数和上下文 node ~/.obsidian-vault/scripts/obsidian-search.js "关键词" --limit 5 --context 3

链接分析 # 查看完整链接图谱 node ~/.obsidian-vault/scripts/obsidian-links.js # 查找某笔记的相关笔记（一跳扩展） node ~/.obsidian-vault/scripts/obsidian-links.js "笔记名" # 发现孤立笔记 node ~/.obsidian-vault/scripts/obsidian-links.js --orphans Windows 用户：在 PowerShell / CMD / Git Bash 中运行 node 命令即可，用法完全相同。

笔记规范 双向链接 笔记之间用 [[笔记名]] 建立链接，形成知识网络：

关联笔记

• [[系统配置]]
• [[用户偏好与工作规则]]

标签 使用 #标签 分类，支持层级： #永久笔记 #系统配置 #openclaw 笔记类型 类型 目录 说明 永久笔记 notes/areas/ 经过加工的核心知识 项目笔记 notes/projects/ 项目相关记录 每日笔记 notes/daily/ 每日思考摘要（非原始对话） 对话存档 references/ai-chats/ AI 对话摘要（只存结论） 文献笔记 references/ 外部资料加工

维护 定期清理：用 --orphans 检查孤立笔记，补充链接或归档 去重合并：写入新知识前先用检索检查是否已有类似记录 链接维护：新建笔记时至少链接到 1 个已有笔记，避免孤立