SKILL.md - Obsidian知识库 API#

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

基本信息#

• API地址: http://192.168.18.15:5000
• 健康检查: http://192.168.18.15:5000/health
• 嵌入模型: qwen3-embedding:8b (通过Ollama)
• 笔记库路径: /mnt/share2win/openclaw_datas/obsidian_db/

使用前提#

1. 确认API服务运行中： curl -s http://192.168.18.15:5000/health
2. 如果服务未启动，需要韩老板手动启动（需要sudo）

API接口#

健康检查#

bash

curl -s http://192.168.18.15:5000/health

创建笔记#

bash

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

搜索笔记（语义搜索）#

bash

curl -s -X POST http://192.168.18.15:5000/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "搜索内容"}'

获取单个笔记#

bash

curl -s "http://192.168.18.15:5000/api/note?file=笔记文件名.md"

列出所有笔记#

bash

curl -s http://192.168.18.15:5000/api/notes

统计信息#

bash

curl -s http://192.168.18.15:5000/api/stats

重建索引#

bash

curl -s -X POST http://192.168.18.15:5000/api/build

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

使用场景#

1. 保存经验：将工作中学到的经验、教训写入知识库
2. 知识检索：搜索历史经验和相关知识
3. 项目文档：创建和管理项目相关文档
4. 跨agent共享：所有agent通过同一个API访问同一份知识库

身份标识规范（2026-03-24）#

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

markdown

---
host: 4090服务器 (192.168.18.15)
agent: pm-agent
created: 2026-03-24
updated: 2026-03-24
---

主机标识#

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

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

知识库目录规范#

text

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

铁律：

• 禁止在根目录创建 md 文件 — 必须放入对应子目录
• 子 agent 创建笔记时必须指定 folder 参数
• 目录命名用英文，笔记标题用中文
• 文件命名： 标题.md（不加点号/空格，用连字符）

注意事项#

• 笔记保存后会自动索引用于语义搜索
• 语义搜索基于向量相似度，相似度>0.5通常表示高度相关
• tags字段可选，建议添加便于分类检索

为小编适配的功能脚本#

创建编剧工作笔记函数#

bash

create_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: application/json" \
        -d "$json_data"
}

搜索知识库函数#

bash

search_obsidian() {
    local query="$1"

    local json_data='{"query": "'"$query"'"}'

    curl -s -X POST http://192.168.18.15:5000/api/search \
        -H "Content-Type: application/json" \
        -d "$json_data"
}

创建编剧工作笔记#

bash

create_script_note() {
    local project_name="$1"
    local note_title="$2"
    local content="$3"

    # 编剧专用目录
    local folder="project_${project_name}/scripts"

    # 添加来源标识
    local content_with_metadata=$(cat <<EOF
---
host: 4090服务器 (192.168.18.15)
agent: 小编 (编剧)
created: $(date +%Y-%m-%d)
updated: $(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: application/json" \
        -d "$json_data"
}

查看编剧相关笔记#

bash

list_script_notes() {
    local project_name="$1"

    curl -s "http://192.168.18.15:5000/api/notes?folder=project_${project_name}/scripts"
}

使用示例#

示例1：保存编剧经验#

bash

create_script_note "project_001" "角色塑造技巧" "
# 角色塑造技巧

## 背景
在现代都市剧中的角色塑造...

## 心得
1. 主角要有明确的目标和动机
2. 配角的性格要符合剧情需求
3. 关系网设计要合理...
"

示例2：搜索相关知识#

bash

search_obsidian "角色塑造经验"

示例3：创建项目文档#

bash

create_obsidian_note "项目文档" "项目规划" "# 项目规划\n\n## 目标\n\n## 进度\n\n## 问题\n" "project_docs" "项目"

示例4：编剧工作日志#

bash

create_script_note "work_log" "$(date +%Y-%m-%d)" "
# $(date +%Y-%m-%d) 工作日志

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

## 明日计划
- 完善角色对话
- 开始第二集大纲设计
"

为小编特别优化的功能#

快速保存创作灵感#

bash

save_idea() {
    local title="$1"
    local idea="$2"

    create_script_note "ideas" "灵感_$title" "
# $title

## 灵感内容
${idea}

## 适用场景
## 发展方向
" "灵感" "创意"
}

记录创作问题#

bash

record_problem() {
    local project="$1"
    local problem="$2"
    local solution="$3"

    create_script_note "problems" "${project}_问题记录" "
# ${project} - 问题记录

## 问题描述
${problem}

## 解决方案
${solution}

## 验证方法
" "问题" "经验"
}