11.1 为什么是 Obsidian?
前面十章,你学会了用 OpenClaw 在各种渠道里帮你做事——飞书群、钉钉群、QQ 群,甚至浏览器自动化。
但有一个问题:OpenClaw 每天都在记东西,你却看不到。
想象一下这个场景:
你问 OpenClaw:"上次客户张三说项目延期到什么时候来着?"
OpenClaw 回复:"根据记忆,张三的项目延期到 3 月底。"
你想确认一下这条记忆的原文,于是:
bashcat ~/.openclaw/workspace/MEMORY.md | grep 张三终端显示一堆文字,你眯着眼睛一行行找...
想看看张三和其他客户的关系?没有图谱。
想快速修改记忆?用 vim 还是 nano?
想看本周记了多少东西?得写个脚本统计...
这就是"黑盒 AI"的痛点——AI 记住了,但你无法直观地查看、编辑、关联这些记忆。
场景:同一个知识库,人机共用
再想象一个更好的场景:
你打开 Obsidian,左边是文件列表,右边是
MEMORY.md的内容。AI 记录的"客户张三偏好简洁格式",你看到
[[客户张三]]是蓝色的链接。点击跳转,看到张三的所有沟通历史、项目关联、偏好标签。
打开图谱视图,看到张三、李四、王五三个客户节点,以及他们关联的项目。
发现 AI 记错了?直接编辑,Ctrl+S 保存。
回到 OpenClaw 聊天,AI 立刻用上了你修改的内容。
这就是 Obsidian + OpenClaw 的价值——把 AI 的"黑盒记忆"变成"透明知识库"。
这一节,我们用 10 分钟,了解为什么 Obsidian 是 OpenClaw 的最佳搭档。
OpenClaw 的记忆文件长什么样
OpenClaw 的工作区(~/.openclaw/workspace)里全是 Markdown 文件:
~/.openclaw/workspace
├── AGENTS.md # AI 的工作准则
├── SOUL.md # AI 的性格设定
├── USER.md # 你的个人偏好
├── MEMORY.md # 长期记忆(档案柜)
├── HEARTBEAT.md # 定时任务清单
├── TOOLS.md # 工具配置
├── IDENTITY.md # 身份定义
└── memory/ # 每日日志(日记本)
├── 2026-03-08.md
├── 2026-03-09.md
└── 2026-03-10.md这些文件的特点:
| 特点 | 说明 |
|---|---|
| 纯文本 | Markdown 格式,任何编辑器都能打开 |
| 结构化 | 有标题、列表、标签,便于解析 |
| 双向链接 | [[客户张三]] 这种语法,AI 和人都能理解 |
| 实时读写 | OpenClaw 边聊边写,你边看边改 |
问题是: 用终端 cat 或 vim 看 Markdown,就像用记事本看网页——能看到内容,但看不到结构。
为什么不是其他工具
| 工具 | 问题 |
|---|---|
| Notion | 云端存储,敏感记忆不放心;API 复杂,AI 读写困难 |
| 飞书文档 | 格式复杂,不是纯 Markdown;AI 写入可能破坏格式 |
| 印象笔记 | 不支持双向链接;知识无法关联 |
| Typora | 单文件编辑器,无知识图谱;没有反向链接面板 |
| VS Code | 是编辑器不是知识库;缺少图谱和标签系统 |
| Logseq | 大纲式思维,与 OpenClaw 的文件结构不完全兼容 |
Obsidian 的独特优势:
| 优势 | 说明 |
|---|---|
| 本地优先 | 你的记忆文件本来就在本地,零迁移成本 |
| 纯 Markdown | AI 能读能写,无格式兼容问题 |
| 双向链接 | [[ ]] 语法,知识网络化 |
| 反向链接 | 自动显示"谁引用了我" |
| 知识图谱 | 可视化查看知识关联 |
| 插件生态 | 3500+ 插件,可无限扩展 |
| 免费 | 个人使用完全免费 |
核心公式
OpenClaw(AI 大脑)+ Obsidian(可视化窗口)= 可管理的 AI 知识库| 你能做的事 | 之前(终端) | 现在(Obsidian) |
|---|---|---|
| 查看 AI 记了什么 | cat ~/.openclaw/workspace/MEMORY.md | 点击打开,Markdown 渲染 |
| 查看知识关联 | 看不到 | 图谱可视化 |
| 编辑记忆 | vim/nano 手动改 | 直接双击编辑 |
| 搜索记忆 | grep -r "关键词" . | Ctrl+Shift+F 全文搜索 |
| 创建关联 | 手动写 [[链接]] | 输入 [[ 自动补全 |
| 分类管理 | 靠文件夹 | 标签 + Dataview 动态查询 |
准备工作
开始前,确认你有:
- OpenClaw 已安装并运行过(工作区已存在)
- 约 10 分钟时间
试一试:下载并打开 Obsidian
下载 Obsidian
访问 https://obsidian.md 下载对应平台的版本:
| 平台 | 下载方式 |
|---|---|
| macOS | 直接下载 .dmg 或用 brew install --cask obsidian |
| Windows | 下载 .exe 安装包 |
| Linux | 下载 .AppImage 或通过 Snap/Flatpak |
打开工作区
1。 启动 Obsidian 2。 点击 "打开本地仓库"(或"Open folder as vault") 3。 导航到 ~/.openclaw/workspace
- macOS:
Cmd + Shift + G输入~/.openclaw/workspace - Windows:地址栏输入
%USERPROFILE%\.openclaw\workspace4。 给仓库起个名字,比如"OpenClaw 大脑"
你会看到:
左侧文件列表显示所有记忆文件,点击任意一个,右侧显示渲染后的 Markdown 内容。
这里的"坑"
找不到 ~/.openclaw 目录
macOS/Linux:~ 表示用户主目录,等价于 /Users/你的用户名/ 或 /home/你的用户名/
Windows:等价于 C:\Users\你的用户名\
Obsidian 提示"不是空目录"
这是正常的。Obsidian 会询问是否在现有目录创建配置文件,选择"信任此目录"即可。
中文显示乱码
确保系统编码为 UTF-8。macOS/Linux 默认支持,Windows 用户检查终端编码设置。
这一节,你了解了
| 要点 | 核心理解 |
|---|---|
| 问题本质 | AI 记忆是"黑盒",你看不到、改不了、关联不上 |
| Obsidian 定位 | 本地优先的 Markdown 知识库,天然兼容 OpenClaw |
| 核心优势 | 零配置打开工作区,双向链接,知识图谱 |
| 组合价值 | OpenClaw 负责记,Obsidian 负责看和管理 |
下一节
Obsidian 打开了,但怎么高效管理 OpenClaw 的工作区?
下一节,我们实战:用 Obsidian 管理 OpenClaw 工作区——从基础操作到高级技巧。