Auto-sync: 2026-04-16 21:08

openclaw/Agents/TOOLS标准模板.md

@@ -1057,4 +1057,91 @@ openclaw cron add \
   ### ⚠️ 关键规则
 - `--announce --channel telegram` 必须同时指定 `--to "5038825565"`
 - 不带 `--to` 时 Telegram 投递会静默失败（无报错），导致 cron 看起来正常但用户收不到通知
-- 禁止使用 launchd / crontab / systemd 管理定时任务，必须用 OpenClaw cron
+- 禁止使用 launchd / crontab / systemd 管理定时任务，必须用 OpenClaw cron
+## 25. Obsidian CLI (官方) (2026-04-16)
+
+### 概述
+官方 Obsidian CLI，集成在 Obsidian 应用中，支持读取、搜索、创建、修改笔记等操作。**需要 Obsidian 应用在运行状态**。
+
+### 安装信息
+- **路径**: `/Applications/Obsidian.app/Contents/MacOS/obsidian-cli`
+- **版本**: `1.12.7`
+- **命令**: `obsidian`（已软链到 `/opt/homebrew/bin/obsidian`）
+
+### 前置要求
+- Obsidian 应用必须**已在运行**
+- 默认 Vault: `/Users/weishen/Workspace/nexus`
+
+### 核心命令
+
+#### 读取笔记
+```bash
+obsidian read file="笔记名称"           # 按名称（无需扩展名）
+obsidian read path="folder/note.md"     # 按路径
+```
+
+#### 搜索
+```bash
+obsidian search query="关键词" limit=10  # 搜索笔记名称
+obsidian search-content "内容"          # 搜索笔记内容
+```
+
+#### 创建笔记
+```bash
+obsidian create name="Folder/新笔记" content="# 标题\n内容" silent
+# silent: 不在 Obsidian 中打开
+```
+
+#### 追加内容
+```bash
+obsidian append file="笔记名称" content="新段落内容"
+obsidian append file="笔记名称" content="- [ ] 新任务" inline  # 不换行
+```
+
+#### 查看/修改属性 (Frontmatter)
+```bash
+obsidian frontmatter file="笔记名称"           # 查看
+obsidian property:set name="status" value="done" file="笔记名称"  # 设置属性
+```
+
+#### 移动/重命名
+```bash
+obsidian move "旧路径/笔记.md" "新路径/笔记.md"  # 自动更新所有链接
+```
+
+#### 每日日记
+```bash
+obsidian daily:read          # 读取今日日记
+obsidian daily:append content="- [ ] 新任务"  # 追加任务
+```
+
+#### 任务管理
+```bash
+obsidian tasks daily todo    # 查看今日任务
+obsidian tags sort=count     # 按数量排序显示标签
+```
+
+#### 查看 backlinks
+```bash
+obsidian backlinks file="笔记名称"    # 查看谁链接到了这个笔记
+```
+
+### 参数格式说明
+- **参数**: `key=value`，如 `file="My Note"`
+- **标志**: 布尔开关，无值，如 `silent`、`inline`、`total`
+- **路径**: `file=` 按名称解析（像 wikilink），`path=` 精确路径
+
+### Vault 指定
+```bash
+obsidian vault="另一个Vault" search query="关键词"
+```
+
+### 完整帮助
+```bash
+obsidian help
+```
+
+### ⚠️ 注意事项
+- Obsidian 应用必须运行才能使用 CLI
+- 如果 Obsidian 未运行，会报错或无响应
+- 内容中换行用 `\n`，制表符用 `\t`