Obsidian知识库管理

技能简介

该技能将Obsidian笔记库作为结构化知识库进行读写操作，支持模糊/语音搜索、自动文件夹归类、YAML前置元数据管理，以及WikiLinks双向链接维护。

业务背景

该技能将分散的Obsidian笔记转化为可编程调用的知识库，支持语音/模糊搜索快速定位信息，自动归类与元数据管理减少人工整理成本。适合研究、咨询等依赖大量文档沉淀的团队，让历史笔记真正被复用而非沉睡。

落地案例：咨询顾问接到新项目时，口述关键词

能做什么

• 跨所有笔记执行模糊搜索与语音匹配（支持俄英转写）
• 自动检测内容所属文件夹并创建新笔记
• 读取、追加、前置或替换笔记内容与指定章节
• 管理标签体系与笔记间的双向链接关系
• 根据内容智能推荐存储位置

使用说明

环境准备

export OBSIDIAN_VAULT=/your/vault/path
cd /home/ruslan/.openclaw/workspace/skills/obsidian/scripts

常用命令

1. 搜索笔记（ripgrep加速，返回路径、标题、匹配上下文）

python3 obsidian_search.py "$OBSIDIAN_VAULT" "关键词" --limit 10 --json

2. 创建笔记（自动识别文件夹）

python3 obsidian_cli.py --json create "标题" -c "正文内容" --auto-folder -t 标签1 标签2

3. 编辑笔记（追加/前置/替换/替换章节）

python3 obsidian_cli.py --json edit "笔记名" append -c "追加文本"
python3 obsidian_cli.py --json edit "笔记名" replace-section -s "章节名" -c "新内容"

4. 列出与读取

python3 obsidian_cli.py --json list "项目"    # 指定文件夹
python3 obsidian_cli.py --json read "笔记名"   # 读取完整内容
python3 obsidian_cli.py --json links "笔记名"  # 查看入链/出链

全局标志：--vault、--json 必须置于子命令之前。

输入与输出

见下方输入与输出表格。

风险提示

• 直接修改原始Markdown文件，操作前建议备份Vault
• replace 模式会覆盖全文，误操作可能导致数据丢失
• 依赖本地Python环境与ripgrep，未安装则搜索功能失效
• 多用户并发写入同一Vault可能产生冲突
• 前置元数据格式错误会影响Obsidian原生解析

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ruslanlanket/obisdian-direct/SKILL.md
来源类型：GitHub仓库