Obsidian知识库集成

技能.md - Obsidian知识库 API

与Obsidian知识库交互，支持创建笔记、语义搜索、笔记管理。

基本信息 API地址: http://192.168.18.15:5000 健康检查: http://192.168.18.15:5000/健康 嵌入模型: qwen3-embedding:8b (通过Ollama) 笔记库路径: /mnt/分享2win/OpenClaw_datas/obsidian_db/ 使用前提 确认API服务运行中：curl -s http://192.168.18.15:5000/健康 如果服务未启动，需要韩老板手动启动（需要sudo） API接口 健康检查 curl -s http://192.168.18.15:5000/健康

创建笔记 curl -s -X POST http://192.168.18.15:5000/API/note \ -H "Content-Type: 应用/json" \ -d '{ "title": "笔记标题", "content": "# 内容\n\n正文...", "tags": ["标签1", "标签2"] }'

搜索笔记（语义搜索） curl -s -X POST http://192.168.18.15:5000/API/搜索 \ -H "Content-Type: 应用/json" \ -d '{"查询": "搜索内容"}'

获取单个笔记 curl -s "http://192.168.18.15:5000/API/note?file=笔记文件名.md"

列出所有笔记 curl -s http://192.168.18.15:5000/API/notes

统计信息 curl -s http://192.168.18.15:5000/API/stats

重建索引 curl -s -X POST http://192.168.18.15:5000/API/build

注：创建笔记后通常会自动索引，如搜索不到新笔记可手动重建。

使用场景 保存经验：将工作中学到的经验、教训写入知识库 知识检索：搜索历史经验和相关知识 项目文档：创建和管理项目相关文档 跨代理共享：所有代理通过同一个API访问同一份知识库 身份标识规范（2026-03-24）

每篇笔记必须包含 YAML frontmatter 标注来源主机：

主机标识 称呼 IP 说明 4090服务器/15主机 192.168.18.15 本机，pm-代理所在 其他主机 待补充 韩老板后续添加

知识库完全共享，跨主机查询无限制。

知识库目录规范 obsidian_db/ ├── claw_memory/ ← Claw 长期记忆（决策/铁律/角色设定） ├── claw_dAIly/ ← 每日工作日志（按日期命名） ├── wf_overview/ ← 执行规范总览（EXECUTION_图形界面DE 等） ├── wf_composite/ ← 拼图工作流文档 ├── wf_i2v/ ← I2V 视频生成工作流（LTX/wan2.2） ├── wf_audio/ ← 音频工作流（TTS/MMAudio） ├── OpenClaw_ops/ ← OpenClaw 运维/调度经验 ├── project_lessons/ ← 项目经验教训（按项目名） ├── Templates/ ← Obsidian 笔记模板 └── _系统/ ← 系统文件（API文档/脚本/配置）

铁律：

禁止在根目录创建 md 文件 — 必须放入对应子目录 子 代理 创建笔记时必须指定 folder 参数 目录命名用英文，笔记标题用中文 文件命名：标题.md（不加点号/空格，用连字符） 注意事项 笔记保存后会自动索引用于语义搜索 语义搜索基于向量相似度，相似度>0.5通常表示高度相关 tags字段可选，建议添加便于分类检索 为小编适配的功能脚本 创建编剧工作笔记函数 创建_obsidian_note() { local title="$1" local content="$2" local folder="$3" local tags="$4" local json_data='{ "title": "'"$title"'", "content": "'"$content"'", "folder": "'"$folder"'", "tags": ['"$tags"'] }' curl -s -X POST http://192.168.18.15:5000/API/note \ -H "Content-Type: 应用/json" \ -d "$json_data" }

搜索知识库函数 搜索_obsidian() { local 查询="$1" local json_data='{"查询": "'"$查询"'"}' curl -s -X POST http://192.168.18.15:5000/API/搜索 \ -H "Content-Type: 应用/json" \ -d "$json_data" }

创建编剧工作笔记 创建_script_note() { local project_name="$1" local note_title="$2" local content="$3" # 编剧专用目录 local folder="project_${project_name}/scripts" # 添加来源标识 local content_with_metadata=$(cat < host: 4090服务器 (192.168.18.15) 代理: 小编 (编剧) 创建d: $(date +%Y-%m-%d) 更新d: $(date +%Y-%m-%d)

${content} EOF ) local json_data='{ "title": "'"$note_title"'", "content": "'"$content_with_metadata"'", "folder": "'"$folder"'", "tags": ["编剧", "'"$project_name"'"] }' echo "创建编剧笔记: $note_title" curl -s -X POST http://192.168.18.15:5000/API/note \ -H "Content-Type: 应用/json" \ -d "$json_data" }

查看编剧相关笔记 列出_script_notes() { local project_name="$1" curl -s "http://192.168.18.15:5000/API/notes?folder=project_${project_name}/scripts" }

使用示例 示例1：保存编剧经验 创建_script_note "project_001" "角色塑造技巧" " # 角色塑造技巧

背景

心得

• 主角要有明确的目标和动机
• 配角的性格要符合剧情需求
• 关系网设计要合理...

示例2：搜索相关知识 搜索_obsidian "角色塑造经验"

示例3：创建项目文档 创建_obsidian_note "项目文档" "项目规划" "# 项目规划\n\n## 目标\n\n## 进度\n\n## 问题\n" "project_docs" "项目"

示例4：编剧工作日志 创建_script_note "work_记录" "$(date +%Y-%m-%d)" " # $(date +%Y-%m-%d) 工作日志

今日完成

• 完成了项目001第一集剧本初稿
• 与美术团队讨论场景设计

明日计划

• 完善角色对话
• 开始第二集大纲设计

为小编特别优化的功能 快速保存创作灵感 save_idea() { local title="$1" local idea="$2" 创建_script_note "ideas" "灵感_$title" " # $title

灵感内容

适用场景

发展方向

记录创作问题 record_problem() { local project="$1" local problem="$2" local solution="$3" 创建_script_note "problems" "${project}_问题记录" " # ${project} - 问题记录

问题描述

解决方案

验证方法