← 返回 Skills 市场

Obsidian笔记CLI

Name: Obsidian笔记CLI
Author: paudyyin

作者 paudyyin · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install obsidian-cli-cn

功能描述

Obsidian笔记命令行工具，支持笔记搜索、批量处理、统计分析、导出转换、标签管理等功能，直接操作本地Obsidian知识库。

使用说明 (SKILL.md)

Obsidian Notesmd CLI 命令行工具

直接操作本地Obsidian知识库（Vault），无需打开Obsidian客户端即可完成批量操作、统计分析、内容搜索等功能。

核心功能

1. 笔记搜索

支持全文搜索、标题搜索、标签搜索、按日期范围筛选：

支持关键词高亮
支持正则表达式搜索
搜索结果按相关度排序

2. 知识库统计

自动生成知识库统计报告：

总笔记数量、总字数、总附件大小
标签数量、标签使用频率排名
近7/30/90天新增笔记数量
文件类型分布统计

3. 批量操作

批量替换所有笔记中的指定文本
批量给符合条件的笔记添加/删除标签
批量导出笔记到指定目录
批量清理空笔记、重复笔记

4. 链接管理

提取所有笔记的双向链接关系
检测孤立笔记（没有任何入链出链的笔记）
检测死链（指向不存在的笔记的链接）
导出链接关系数据用于生成关系图谱

使用方法

基础命令

# 搜索笔记
obsidian-cli search "关键词" --vault "你的知识库路径"

# 生成知识库统计报告
obsidian-cli stats --vault "你的知识库路径"

# 批量替换内容
obsidian-cli replace "旧文本" "新文本" --vault "你的知识库路径"

# 导出所有笔记
obsidian-cli export --output "导出目录路径" --format markdown

# 检测死链
obsidian-cli check-links --vault "你的知识库路径"

常用参数

参数	说明	必填
--vault	Obsidian知识库根目录路径	✅
--output	导出结果保存路径	❌
--format	导出格式：markdown/html/txt/json	默认markdown
--case-sensitive	搜索/替换是否区分大小写	默认不区分
--regex	是否启用正则表达式匹配	默认不启用
--include-attachments	导出时是否包含附件	默认不包含

示例

# 统计我的知识库信息
obsidian-cli stats --vault "D:\我的知识库"

# 搜索所有包含"AI大模型"的笔记
obsidian-cli search "AI大模型" --vault "D:\我的知识库"

# 把所有笔记中的"GPT-4"替换为"GPT-4o"
obsidian-cli replace "GPT-4" "GPT-4o" --vault "D:\我的知识库" --case-sensitive

# 导出所有带"工作"标签的笔记
obsidian-cli export --vault "D:\我的知识库" --tag "工作" --output "D:\导出的工作笔记"

安全使用建议

Review this skill before installation if you may let an agent act on your notes. It appears local-only and purpose-aligned, but back up your Obsidian vault and require explicit approval before using the replace command or any other operation that writes to many notes.

能力评估

ℹ Purpose & Capability

The stated purpose matches the code: it searches, summarizes, exports, checks links, and modifies local Obsidian Markdown files. Users should note that this necessarily reads private vault content.

⚠ Instruction Scope

The replace workflow applies a user-supplied pattern across all Markdown files under the chosen vault and overwrites files in place, with no confirmation, dry-run, backup, or rollback guidance.

✓ Install Mechanism

No install script, dependency download, shell bootstrap, or network-based installation is shown; the reviewed runnable artifact is a single Python file.

ℹ Credentials

Recursive local vault access is proportionate for an Obsidian CLI, but users should choose the vault path carefully because the script processes every .md file below it, excluding hidden directories.

✓ Persistence & Privilege

The artifacts show no credentials, background service, persistence mechanism, privilege escalation, external network calls, or continued operation after a command finishes.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install obsidian-cli-cn
安装完成后，直接呼叫该 Skill 的名称或使用 /obsidian-cli-cn 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Obsidian笔记搜索/批量处理/统计分析/导出转换

元数据

Slug obsidian-cli-cn

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题