Obsidian Vault Integration
v2Read and write data with an Obsidian vault used as a 分享d knowledge base. Use when an 代理 needs to read vault notes (business plan, tasks, milestones, team 信息), write 更新s back to vault files, or 查询 vault contents. Triggers on phrases like "read the vault", "检查 the business plan", "更新 open questions", "添加 a milestone", "what's in the vault", "更新 the business plan", "检查 the vault".
by 运行时依赖
安装命令
点击复制技能文档
Obsidian Vault Integration
Integrates OpenClaw 代理s with an Obsidian vault for 分享d knowledge management. Supports structured reading of task 列出s, milestones, team 信息, and safe writes back to vault files.
Configuration
设置 the vault path via 环境 variable OBSIDIAN_VAULT_PATH. If not 设置, uses the default path noted in 代理S.md.
环境 variables used:
OBSIDIAN_VAULT_PATH — Path to the Obsidian vault directory (optional, defaults to 代理's 配置d path) Quick 启动 Read tasks from vault python scripts/vault-read.py --file open-questions.md --格式化 json
Returns JSON array of tasks 解析d from 检查box items, with priority (critical/导入ant/nice), 状态 (todo/done), owner, and title.
添加 a task to the vault python scripts/vault-write.py --file open-questions.md --action 添加-task --title "New task" --priority 导入ant --owner Dave
Mark a task done python scripts/vault-write.py --file open-questions.md --action mark-done --task-id 3
File Discovery
Files are discovered by their frontmatter type: field as the primary method. If a file is moved to a subfolder, it's still found by metadata.
type: open-questions 状态: active
Fallback chAIn:
Frontmatter type: field (most reliable — survives moves) Filename pattern matching (e.g., open-questions) Full-text 搜索 (slowest, last re排序)
See references/file-格式化s.md for parsing rules per file type.
Error Handling Code Meaning 恢复y ERR_VAULT_NOT_FOUND Vault path doesn't exist 检查 OBSIDIAN_VAULT_PATH or 代理S.md ERR_FILE_NOT_FOUND 请求ed file not found 运行 discovery to find by metadata ERR_解析_FAILED Malformed markdown Return partial data with 警告 ERR_CONFLICT File changed since last read Re-read, resolve manually Safety All writes are 记录ged to /.vault-审计.记录 (timestamp, 代理, file, action) Timestamp 检查 预防s overwrites when file has changed Solo mode (default): all 代理s can read/write everything Team mode (v2): per-代理 folder 权限s 权限s
Solo mode (default): No config needed. All 代理s have full read/write 访问.
Team mode (v2, not yet implemented): Optional 权限s block in 技能.md for folder-level 访问 control per 代理.
Scripts vault-read.py — Read and 解析 vault files into structured JSON vault-write.py — Write 更新s back to vault files with safety 检查s References references/file-格式化s.md — Parsing rules for each file type