據 AlphaMoat 統計,截至 2026-10,Obsidian Official CLI 累計下載 18,631 次、獲 10 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 1,510 位,在「知識管理」分類(745 個)中排名第 98 位。
列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。
| 平台 | 累計下載 | 星標 | 評論 |
|---|---|---|---|
| ClawHub ↗ | 5903 | 8 | - |
| SkillHub ↗ | 1.9萬 | 10 | — |
各平台的計數口徑不同,統計時間不一致。
主文列出搜尋、筆記、任務、標籤、屬性和連結等命令,並要求 Obsidian 正在執行且啟用 CLI。CLI 可操作使用者資料庫;明確指定 vault 和檔案範圍,寫入、刪除、恢復、釋出或外掛管理前必須確認。
資料釋出於 2026-10-27
以下是根據技能文件生成的示例,不代表實際執行結果。
2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。
| 月份 | 累計下載 | 環比 | 星標 |
|---|---|---|---|
| 2026-10 | 1.9萬 | — | 10 |
| 2026-09 | 8767 | — | 10 |
| 2026-08 | 5847 | +9.7% | 10 |
| 2026-07 | 5329 | +9.5% | 10 |
| 2026-06 | 4865 | +8.3% | 10 |
| 2026-05 | 4491 | — | 9 |
以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。
---
name: obsidian-cli-official
description: |
Official Obsidian CLI (v1.12+). Complete command-line interface for
Obsidian notes, tasks, search, tags, properties, links, and more.
homepage: https://help.obsidian.md/cli
metadata:
openclaw:
emoji: "💎"
requires: bins: ["obsidian"]
platform: ["macos", "windows", "linux"]
---
# Obsidian Official CLI
Official command-line interface for Obsidian (v1.12+). 115 commands.
## Prerequisites
- **Obsidian 1.12+** (free, public release since v1.12)
- **Obsidian must be running** (CLI connects via IPC)
- **Enable CLI**: Settings → General → Enable CLI
## Setup
Add Obsidian to PATH:
**macOS:**
```bash
export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"
```
**Windows:**
```powershell
$env:PATH += ";$env:LOCALAPPDATA\Obsidian"
```
**Linux:**
- Snap: Already in PATH
- Flatpak: `alias obsidian='flatpak run md.obsidian.Obsidian'`
- AppImage: Move to `~/.local/bin` and `chmod +x`
**Test:** `obsidian version`
## Syntax
- **Parameters**: `name=value` or `name="value with spaces"`
- **Flags**: just the name, e.g. `open`, `overwrite`
- **Newlines**: use `\n` in content strings
- **Target vault**: `obsidian vault="My Vault" <command>` (must be first)
- **Target file**: `file=<name>` (wikilink-style) or `path=<folder/file.md>` (exact)
- **Copy output**: append `--copy` to any command
## Common Commands (with examples)
### Daily Notes
```bash
obsidian daily # Open today
obsidian daily:append content="- [ ] Buy milk" # Add to today
obsidian daily:prepend content="# Important" # Add to top
obsidian daily:read # Read today's content
obsidian daily:path # Get daily note path
```
### Files
```bash
obsidian create name="Note" content="# Hello" # Create note
obsidian create name="Note" template=Meeting # Create from template
obsidian read file="Note" # Read note
obsidian append file="Note" content="More text" # Append to note
obsidian prepend file="Note" content="Top text" # Prepend to note
obsidian move file="Note" to="Archive/Note.md" # Move note
obsidian rename file="Note" name="New Name" # Rename note
obsidian delete file="Note" # Delete note
obsidian open file="Note" # Open note
```
### Search
```bash
obsidian search query="meeting notes" # Search vault
obsidian search:context query="TODO" # Search with context
obsidian search:open query="project" # Open search view
```
### Tasks
```bash
obsidian tasks daily todo # Incomplete tasks in daily
obsidian tasks todo # All incomplete tasks
obsidian task daily line=3 toggle # Toggle task at line 3
```
### Tags & Properties
```bash
obsidian tags counts # List all tags
obsidian tags counts sort=count # Sort by frequency
obsidian property:set name="status" value="done" file="Note"
obsidian property:read name="status" file="Note"
obsidian property:remove name="status" file="Note"
obsidian properties file="Note" # List all properties
```
### Links
```bash
obsidian backlinks file="Note" # Incoming links
obsidian links file="Note" # Outgoing links
obsidian orphans # No incoming links
obsidian deadends # No outgoing links
obsidian unresolved # Broken links
```
### Developer
```bash
obsidian devtools # Open dev tools
obsidian eval code="app.vault.getFiles().length" # Run JavaScript
obsidian dev:screenshot path=screenshot.png # Screenshot
obsidian plugin:reload id=my-plugin # Reload plugin
```
## All Commands (115 total)
### General (4)
- `help` - Show help / help for specific command
- `version` - Show Obsidian version
- `reload` - Reload the app window
- `restart` - Restart the app
### Daily Notes (5)
- `daily` - Open daily note
- `daily:path` - Get daily note path
- `daily:read` - Read daily note contents
- `daily:append` - Append content to daily note
- `daily:prepend` - Prepend content to daily note
### Files & Folders (12)
- `file` - Show file info
- `files` - List files in vault
- `folder` - Show folder info
- `folders` - List folders in vault
- `open` - Open a file
- `create` - Create a new file
- `read` - Read file contents
- `append` - Append content to a file
- `prepend` - Prepend content to a file
- `move` - Move or rename a file
- `rename` - Rename a file
- `delete` - Delete a file
### Search (3)
- `search` - Search vault for text
- `search:context` - Search with matching line context
- `search:open` - Open search view
### Tasks (2)
- `tasks` - List tasks in the vault
- `task` - Show or update a task
### Tags (2)
- `tags` - List tags in the vault
- `tag` - Get tag info
### Properties (4)
- `properties` - List properties in the vault
- `property:set` - Set a property on a file
- `property:remove` - Remove a property from a file
- `property:read` - Read a property value
### Aliases (1)
- `aliases` - List aliases in the vault
### Links (5)
- `backlinks` - List backlinks to a file
- `links` - List outgoing links from a file
- `unresolved` - List unresolved links
- `orphans` - Files with no incoming links
- `deadends` - Files with no outgoing links
### Outline (1)
- `outline` - Show headings for a file
### Bookmarks (2)
- `bookmarks` - List bookmarks
- `bookmark` - Add a bookmark
### Bases / Database (4)
- `bases` - List all base files
- `base:views` - List views in a base
- `base:create` - Create a new item in a base
- `base:query` - Query a base and return results
### Templates (3)
- `templates` - List templates
- `template:read` - Read template content
- `template:insert` - Insert template into active file
### Commands & Hotkeys (4)
- `commands` - List available command IDs
- `command` - Execute an Obsidian command
- `hotkeys` - List hotkeys
- `hotkey` - Get hotkey for a command
### Tabs & Workspaces (7)
- `tabs` - List open tabs
- `tab:open` - Open a new tab
- `workspace` - Show workspace tree
- `workspaces` - List saved workspaces
- `workspace:load` - Load a saved workspace
- `workspace:save` - Save current layout
- `workspace:delete` - Delete a saved workspace
### File History & Diff (6)
- `diff` - List or diff local/sync versions
- `history` - List file history versions
- `history:list` - List files with history
- `history:read` - Read a file history version
- `history:restore` - Restore a file history version
- `history:open` - Open file recovery
### Sync (7)
- `sync` - Pause or resume sync (on/off)
- `sync:status` - Show sync status
- `sync:history` - List sync version history
- `sync:read` - Read a sync version
- `sync:restore` - Restore a sync version
- `sync:open` - Open sync history
- `sync:deleted` - List deleted files in sync
### Publish (6)
- `publish:site` - Show publish site info
- `publish:list` - List published files
- `publish:status` - Show publish status
- `publish:add` - Publish files
- `publish:remove` - Unpublish files
- `publish:open` - Open published site
### Themes & Snippets (9)
- `themes` - List installed themes
- `theme` - Show active theme or get info
- `theme:set` - Set active theme
- `theme:install` - Install a community theme
- `theme:uninstall` - Uninstall a theme
- `snippets` - List installed CSS snippets
- `snippets:enabled` - List enabled CSS snippets
- `snippet:enable` - Enable a CSS snippet
- `snippet:disable` - Disable a CSS snippet
### Plugins (9)
- `plugins` - List installed plugins
- `plugins:enabled` - List enabled plugins
- `plugins:restrict` - Toggle restricted mode
- `plugin` - Get plugin info
- `plugin:enable` - Enable a plugin
- `plugin:disable` - Disable a plugin
- `plugin:install` - Install a community plugin
- `plugin:uninstall` - Uninstall a community plugin
- `plugin:reload` - Reload a plugin
### Vault (3)
- `vault` - Show vault info
- `vaults` - List known vaults
- `vault:open` - Open a vault (TUI only)
### Random Notes (2)
- `random` - Open a random note
- `random:read` - Read a random note
### Unique Notes (1)
- `unique` - Create unique note
### Web Viewer (1)
- `web` - Open URL in web viewer
### Word Count (1)
- `wordcount` - Count words and characters
### Recently Opened (1)
- `recents` - List recently opened files
### Developer (10)
- `devtools` - Toggle Electron dev tools
- `eval` - Execute JavaScript
- `dev:screenshot` - Take a screenshot
- `dev:console` - Show captured console messages
- `dev:errors` - Show captured errors
- `dev:css` - Inspect CSS with source locations
- `dev:dom` - Query DOM elements
- `dev:cdp` - Run Chrome DevTools Protocol command
- `dev:debug` - Attach/detach CDP debugger
- `dev:mobile` - Toggle mobile emulation
## Troubleshooting
**"Cannot connect to Obsidian"**
- Ensure Obsidian is running
- Enable CLI in Settings → General → Enable CLI
**"Command not found: obsidian"**
- Add Obsidian to PATH (see Setup above)
**"File not found"**
- `file=Name` resolves like wikilinks (no path, no .md)
- `path=folder/file.md` for exact paths
## 中文说明
### 前置条件
- Obsidian 1.12+(免费公开版本)
- Obsidian 必须运行中
- 启用 CLI:设置 → 通用 → 启用 CLI
### 常用命令
```bash
obsidian daily # 打开今日日记
obsidian create name="笔记" # 创建笔记
obsidian search query="关键词" # 搜索
obsidian tasks daily todo # 列出未完成任务
obsidian tags counts # 列出标签
```
透過公開搜尋URL在16個搜尋引擎(7個國內直連+9個國際)中做跨引擎檢索、結果去重與多源交叉驗證,無需API Key,內建零依賴Python指令碼。Use when 使用者要求“搜一下/查資料/多找幾個來源/核實訊息/找公眾號文章/排查報錯/找論文或開源專案”時。輸入自然語言查詢詞,輸出帶來源連結與可信度標註的結構化結果。不適用於私有資料檢索、批次抓取、需要登入後可見的內容。
透過 IMA OpenAPI 管理筆記與知識庫內容。
把長文字、文件與網頁內容壓縮成要點和關鍵詞的摘要工具。
透過“查一下、搜一下、搜尋、找一下”等自然語言檢索公開網頁,整理來源並交付橫版 PDF、Markdown 與標題連結表。支援使用者主動開啟、檢視和取消技能收藏,保留原報告取回。
規定如何為網頁請求選擇合適工具的必讀指引。
AI HOT(aihot.virxact.com)中文 AI 資訊查詢 Skill,幫助使用者獲取今日 AI 圈動態、AI 日報、AI 熱點、最新 AI 資訊以及 OpenAI、Anthropic、Google 等公司的最新發布資訊。
全球12億文獻知識庫(8千萬中文期刊可下載)——透過 SmartLib 開放平台 API 提供中外文學術文獻檢索與下載能力,覆蓋 8000 萬篇授權中文期刊全文 + 12.28 億條全球文獻後設資料(期刊 7.19 億 / 專利 2.15 億 / 會議 7155 萬 / 學位論文 2473 萬 / 標準 268 萬)。 能力:中英文關鍵詞檢索、文獻詳情、中文期刊 PDF 全文下載、外文 OA 文獻十級渠道免費下載(不消耗配額)、智慧關鍵詞擴充套件、核心期刊優先排序、相關性重排、引文追溯、分類號檢索。 配額:首次使用自動註冊,免費 100 次檢索 + 10 次下載 / 月;耗盡自動彈出方案(體驗卡 / 個人版月 / 專業版月 / 單篇下載 / 下載包),可說「升級 / 充值」喚起;企業 / 機構定製聯絡 [email protected]。 觸發:使用者表達"查論文""找文獻""檢索學術""搜期刊""查專利""找標準""下論文""寫文獻綜述""找參考文獻""查 SCI/EI"等意圖時啟用;也適用"幫我找關於 XX 的論文""寫文獻綜述""找幾篇引用支撐論點"。英文:"find papers" "search literature" "write literature review" "find supporting citations"。 呼叫前必須先用 /consume 獲取 consume_token,再憑 token 調 /search(每次計費介面呼叫都需一次 /consume)。
用 uvx 直接呼叫 markitdown,把各類檔案轉成 Markdown。
資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。