OpenClaw + Obsidian,手把手搭 AI 知识库-夜雨聆风

OpenClaw + Obsidian,手把手搭 AI 知识库

TUTORIAL · 本地知识库2026.07

收藏＝学会？

收藏的东西再也不

找不到

OpenClaw ＋ Obsidian · 本地知识库 · 新手详解

智驭视界

OpenClawObsidian

📦 11 Parts + Conclusion

👉 滑动

PART 01

它们是什么

认识两位主角

PART 02

能干什么

核心能力

PART 03

能做成啥

实战场景

PART 04

什么效果

四大收益

PART 05

准备环境

Obsidian+Node

PART 06

装 OpenClaw

三种方式

PART 07

联网验证

跑通向导

PART 08

库的结构

文件夹规划

PART 09

打通两者

核心一步

PART 10

装小帮手

自动写库

PART 11

日常用法

一句指令

PART ///

写在最后

避坑＋清单

先说句大实话

收藏夹吃灰、笔记越记越乱，不是你定力差，是工具没帮你干活

你是不是也这样——网上看到好文章，顺手点个收藏，转头就忘；想记点东西，打开笔记软件却不知道往哪放；好不容易记下来，半年后还是一团乱麻，要用时根本找不到。

今天这篇，教你用一套开源免费的组合，搭一个真正属于你自己的知识库：AI 帮你抓、帮你整理、帮你写，所有笔记都存在你电脑本地，不依赖任何云盘，不用交订阅费。

主角有两个：OpenClaw 和 Obsidian。下面先搞懂它们是什么，再动手搭。

PART

它们到底是什么

WHAT ARE THEY · 认识两位主角

一句话概括——OpenClaw 当作会干活的 AI 助手，Obsidian 当作你的本地笔记本。一个负责动脑动手，一个负责存放记忆。

Obsidian：你的本地笔记本

Obsidian 是一个本地笔记软件。你写的所有笔记，都是电脑里一个个普通的 .md 纯文本文件——用记事本、Word 都能打开，永远不会被某个软件锁死。

它有三个新手最该知道的本事：双链（用 [[ ]] 把两篇笔记连起来，织成知识网）、图谱（自动画出笔记之间的关系图）、全文搜索（输入关键词，秒找）。

OpenClaw：会干活的 AI 助手

OpenClaw 是一个自托管的 AI Agent 网关（开源、MIT 许可，完全免费）。它能连上 Telegram、飞书、微信等聊天软件——你发一句话，它就帮你记东西、查东西、整理东西。

简单说，它就是那个你说一句、它去干活的指挥官。

还有两个小搭档

角色	是什么	在你的知识库里干啥
Obsidian	本地 Markdown 笔记软件	知识库的仓库，笔记以 .md 存在你磁盘上
OpenClaw	自托管 AI Agent 网关	连聊天软件，一句话让 AI 记、查、整理
obsidian-cli	命令行工具（Go 写）	安全重命名／移动笔记，自动更新双链、全文检索
obsidian skill	OpenClaw 技能插件	教 AI 规范写笔记（元数据、双链、目录）

为什么它俩是天作之合？因为 Obsidian 存的是纯文本，OpenClaw 读写的也是纯文本——不需要任何专有接口，没有云依赖，没有厂商锁定。传统知识库三大痛点（记不下来／记了乱／找不到），AI 正好能补上。

PART

它们能帮你干什么

WHAT THEY CAN DO · 核心能力

把两位主角连起来后，AI 就获得了操作你笔记本的权限。具体来说，它能做这四件事：

抓取

把网页、链接、文章的正文抓下来，自动存成笔记，不用你复制粘贴。

整理

自动分类、打标签、填好元数据，笔记不会再乱堆成一锅粥。

记录

你说一句记一下周五交报告，它立刻写进待办清单。

检索

不是死板按标题搜，而是理解意思的语义搜索，问想法也能找出来。

PART

搭好之后，你能做成哪些事

USE CASES · 实战场景

光说能力太虚，看几个你每天都会遇到的真实场景：

CASE 01

收藏即归档

你说把这篇链接存进知识库、归类到 reference，AI 抓正文、写进指定文件夹、自动打标签。

CASE 02

一句话记待办

你说记一下周五前交 OpenClaw 部署报告，它立刻写入 inbox 待办清单。

CASE 03

自动写日报

你说帮我总结今天和 AI 相关的笔记，AI 读一遍 Vault，生成日报到 daily 文件夹。

CASE 04

语义找旧想法

你说找找我之前关于双链笔记的想法，它按意思搜，不只是按标题硬匹配。

CASE 05

辅助写作

你说把 projects／openclaw 的笔记整理成一篇综述，AI 基于你的知识库帮你起草。

PART

最终能达到什么效果

THE PAYOFF · 四大收益

坚持用一段时间，你会感受到从之前到之后的明显变化：

之前（没有它）	之后（搭好知识库）
收藏夹吃灰	AI 自动归档、打标签，随时可检索
笔记越记越乱	固定结构 + 双链，自动织成知识网
想找的东西找不到	语义搜索，按意思秒找
怕数据被锁、被泄露	纯文本本地存，不依赖任何云厂商

一句话：隐私优先、纯文本可迁移、越用越聪明

PART

准备环境：装 Obsidian 和 Node.js

SETUP ENV · 打地基

STEP 01

装 Obsidian

去官网 obsidian.md 下载桌面版，Windows 一路下一步即可。首次打开点 Create new vault，选一个普通文件夹当仓库根目录。

建议路径 C:\Users\你的用户名\Documents\Obsidian-Vault，命名随意。Vault 本质就是个普通文件夹，里面的 .md 文件随便用记事本都能开。

STEP 02

装 Node.js（OpenClaw 的运行环境）

OpenClaw 需要 Node.js。官方推荐 Node 24.15+，兼容 Node 22 LTS（22.22.3+）。先检查当前版本：

node –version

npm –version

去 nodejs.org 下载 Windows 安装包（.msi）双击安装，装完打开新的 PowerShell 验证版本，能看到号就成功。

PART

安装 OpenClaw

INSTALL · 三种方式任选

OpenClaw 在 Windows 上有三种装法，新手任选其一，功能一样：

方式一 WSL2

官方推荐，后台最稳，功能最全

方式二 Hub

官方桌面应用，下载即用

方式三 PS

一行命令装，纯 Windows

方式一 WSL2（推荐，功能最完整）

提供完整 Linux 环境，后台守护进程稳定。先以管理员身份打开 PowerShell 启用 WSL2：

wsl –install

wsl –list –verbose

重启后若显示 Ubuntu Running 2 即成功。接着在 Ubuntu 终端里装 Node 24 与 OpenClaw：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

source ~/.bashrc

nvm install 24

nvm use 24

npm install -g openclaw@latest

openclaw –version

浏览器访问 http://127.0.0.1:18789/ 通常直接连；连不上做 WSL2 端口转发（见文末避坑）。

方式二 Windows Hub（最省心）

去 openclaw.ai 下载 Windows 安装包，装完即用，自带 Gateway，带托盘和聊天界面。

方式三 PowerShell（纯 Windows）

iwr -useb https://openclaw.ai/install.ps1 | iex

npm install -g openclaw@latest

PART

初始化联网，验证跑通

ONBOARD · 跑通向导

装好后运行引导向导，它会带你选模型供应商、填 API Key、配 Gateway。WSL2／npm 方式执行：

openclaw onboard –install-daemon

向导会问几项，提前准备：网关模式选本地网关；认证选 API Key；AI 提供商新手可选 DeepSeek／Kimi／GLM-4（无需翻墙、便宜）；聊天平台先选 None；端口默认 18789 直接回车。

没有 API Key 可先跳过，但之后 AI 没法回答。新手建议去 DeepSeek 开放平台免费领一个 Key 练手。

验证 Gateway 与 Dashboard

openclaw gateway status

openclaw dashboard

浏览器打开 http://127.0.0.1:18789/ ，能聊天、发消息有 AI 回复，说明跑通了。

PART

设计你的知识库结构

VAULT · 文件夹规划

在 Obsidian 仓库根目录，建一套最小可行结构（别一上来太复杂）：

Obsidian-Vault/

├─ daily/ 每日复盘 / 工作日志

├─ projects/ 项目 / 专题研究

│ ├─ openclaw/

│ └─ ai-agents/

├─ inbox/ 临时材料（AI 初稿、零散想法）

├─ reference/ 长期参考资料

└─ templates/ 模板（复盘、会议纪要）

命名用 01-新闻、02-读书笔记这种数字编号让文件夹有序；每个文件夹职责单一，方便 AI 自动分类。

PART

打通 OpenClaw 与 Obsidian

CONNECT · 核心一步

这一步让 AI 能读写你的笔记库。新手推荐方案 A（单设备简化版），直接写主库子文件夹，省掉同步层。

方案 A：单设备简化版（新手推荐）

思路：在 OpenClaw 工作目录里建一个软链接，指向你的 Obsidian Vault，让 AI 直接读写。PowerShell 里执行：

$openclawDir = “$env:USERPROFILE\.openclaw\workspace”

$obsidianDir = “C:\Users\你的用户名\Documents\Obsidian-Vault”

New-Item -Path $openclawDir -ItemType Directory -Force

New-Item -Path “$openclawDir\obsidian-vault” -ItemType SymbolicLink -Value $obsidianDir

！踩坑提示 🕳

Windows 建软链接可能要开发人员模式或管理员权限。开启：设置→系统→开发者选项→打开开发人员模式；仍失败就用管理员 PowerShell。

然后告诉 OpenClaw 库在哪：

openclaw config set obsidian.vault_path “$env:USERPROFILE\.openclaw\workspace\obsidian-vault”

openclaw config set obsidian.default_folder “inbox”

openclaw config set obsidian.daily_notes_folder “daily”

openclaw config set obsidian.daily_notes_format “YYYY-MM-DD”

openclaw config set obsidian.tag_style “yaml”

方案 B：隔离 Vault ＋ SyncThing（隐私优先）

进阶做法：单独建一个隔离 Vault 只给 AI 写，再用开源同步工具 SyncThing 把内容并入主库。AI 从不直接碰你的主库，爆炸半径可控。多设备或重视隐私时再用。

PART

装两个小帮手，让 AI 自动写库

SKILLS · 自动化

装 obsidian skill（让 AI 懂笔记规范）

在 OpenClaw 聊天里直接说：

PROMPT帮我安装 obsidian skill，我需要让 Agent 把产出同步到 Obsidian。

装完后，AI 会学会用 frontmatter 管理元数据、用 [[双链]] 互相关联、按你设计的结构落笔记。

装 obsidian-cli（链接维护＋全文检索）

移动／重命名笔记时，需要它自动更新整个库的 [[wikilinks]]，否则双链会断；它还能做全文检索。Windows 装（通过 Scoop）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

irm get.scoop.sh | iex

scoop bucket add scoop-yakitrak https://github.com/yakitrak/scoop-yakitrak.git

scoop install obsidian-cli

obsidian-cli set-default “Obsidian-Vault”

让 AI 自动写库（几个现成技能）

你可以让 AI 把一类操作固化成技能。最简单的方式——直接在聊天里用大白话让 Agent 帮你建，比如：

PROMPT每天把 X 存到 inbox

PROMPT从 Telegram 收到带 #task 的消息，自动记成待办

不用记命令，说人话就行。不同版本参数略有差异，自然语言最稳。

PART

日常怎么用

DAILY USE · 一句指令

跑通后，你只要在聊天里（Dashboard／Telegram／飞书）说一句：

把这篇链接存进知识库，归类到 reference

记一下：周五前交 OpenClaw 部署报告

帮我总结今天和 AI 相关的笔记

找找我之前关于双链笔记的想法

把 projects／openclaw 的笔记整理成一篇综述

你只管说，整理的事交给 AI

///

LAST

写在最后

CONCLUSION · 避坑＋清单

新手避坑清单

常见坑	对策
Node 版本太旧	先 node -v，要求 22.22.3+ 或 24.15+
WSL2 打不开 Dashboard	查端口转发，或在 WSL2 内 curl 验证
软链接建不了	开开发人员模式，或用管理员 PowerShell
AI 乱动主库	只让它写 inbox／子文件夹，进阶再隔离 Vault
双链断了	重命名用 obsidian-cli move，别用普通拖拽
两套同步打架	SyncThing 与 OneDrive／iCloud 别同时用

术语表（新手必看）

词	含义
Vault	Obsidian 的仓库，就是一个普通文件夹
Markdown	纯文本笔记格式，用 # 标题、[[ ]] 双链
双链	用 [[笔记名]] 把两篇笔记连起来，织成知识网
frontmatter	笔记开头的元数据块，存标签、日期、来源
Gateway	OpenClaw 核心进程，负责连聊天软件和 AI
Skill	OpenClaw 里固化的一类能力／自动化
软链接	快捷方式式文件夹，让 AI 工作区指向真实 Vault
SyncThing	开源本地多点同步工具，替代云盘

一键检查清单

装好 Obsidian，建了 Obsidian-Vault

node -v 显示 22.22.3+（推荐 24.15+）

openclaw –version 有输出

onboard 跑完，填了 API Key

gateway status 显示监听 18789

dashboard 能聊天

建好 daily／inbox／projects／reference／templates 结构

建好软链接，OpenClaw 能访问 Vault

装好 obsidian skill ＋ obsidian-cli，设好默认 Vault

✓

试一条：把这句话存进知识库 inbox

我是青灯墨染，一个用 AI 帮你驾驭信息的实践号。如果今天这篇帮你少踩几个坑，就是它最大的价值。

既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。

在看

THANKS FOR READING