什么是 obsidian-task？

obsidian-task 技能是一个专为希望将个人知识管理与终端环境相结合的用户设计的高性能实用程序。作为 Openclaw Skills 生态系统的一部分，它利用官方的 Obsidian CLI 提供对基于 Markdown 的任务列表的直接访问。该技能允许您在不中断开发流程的情况下与库进行交互，使其成为依赖 Obsidian 进行项目跟踪和日常日志记录的人士的必备工具。

通过使用此技能，开发人员和高级用户可以以编程方式与他们的笔记进行交互。它提供了一种结构化的方式来查看待处理项目并立即更新其状态。无论您是在管理复杂的项目还是简单的每日清单，此工具都能确保您的 Openclaw Skills 设置始终是生产力工作流的中心枢纽。

下载入口:https://github.com/openclaw/skills/tree/main/skills/boyd4y/obsidian-task

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

obsidian-task 应用场景

• 列出特定 Markdown 文件中的所有待处理任务，并附带行号以便参考。
• 在不打开 Obsidian 桌面应用程序的情况下切换任务的完成状态。
• 从命令行快速将新的待办事项追加到项目文件中。
• 使用 Openclaw Skills 将任务更新集成到自动化脚本或开发人员工作流中。

1. 该技能通过注册的 obsidian CLI 命令与本地安装的 Obsidian 通信。
2. 发布命令时，它使用基于路径的别名（slug）定位特定的库文件。
3. 对于任务更新，该技能识别正确的行号并应用请求的状态更改（切换、完成或待办）。
4. 对于任务创建，它将格式化的 Markdown 字符串追加到指定文件的末尾。
5. 更改会立即反映在运行中的 Obsidian 应用程序中。

obsidian-task 配置指南

要在您的 Openclaw Skills 环境中使用此功能，请确保满足以下要求：

1. 确保您拥有 Obsidian 1.12+ 和 Catalyst 许可证。
2. 导航至 设置 → 常规 → 命令行界面 并选择 启用。
3. 按照系统提示注册 obsidian 命令。
4. 重启终端或加载配置文件（例如 macOS 上的 source ~/.zprofile）。
5. 通过运行以下命令验证安装：

obsidian version

6. 确保在通过此技能执行命令时 Obsidian 正在运行。

obsidian-task 数据架构与分类体系

obsidian-task 技能使用以下参数在您的库的 Markdown 结构上运行：

name: obsidian-task
description: Manage Obsidian tasks via obsidian-cli. List, toggle, create, and update tasks from the terminal.
compatibility: darwin,linux
metadata:
  version: 1.0.1
  requires:
    bins:
      - obsidian

Obsidian Task

Manage tasks in your Obsidian vault using the official Obsidian CLI.

Dependencies

Check Dependencies

# Check obsidian CLI availability
obsidian version

Prerequisites

• Obsidian 1.12+ and Catalyst license required
• Settings → General → Command line interface → Enable
• Follow prompt to register the obsidian command
• Restart terminal or source ~/.zprofile (macOS)
• Note: Obsidian must be running for CLI to work

Test setup: obsidian version

Usage

/obsidian-task [command] [options]

Commands

Options

Examples

# List tasks
/obsidian-task tasks file=projects/myproject/todo verbose

# Toggle task on line 2
/obsidian-task task file=projects/myproject/todo line=2 toggle

# Mark task as done
/obsidian-task task file=projects/myproject/todo line=2 done

# Mark task as todo (undo completion)
/obsidian-task task file=projects/myproject/todo line=2 todo

# Create new task
/obsidian-task append file=projects/myproject/todo content="- [ ] task name"

Raw CLI Commands

# List tasks (shows line numbers and status)
obsidian tasks file=/todo verbose

# Sample output:
# projects//TODO.md
# 2	- [ ] 未完成的任务
# 3	- [x] 已完成的任务

# Update tasks
obsidian task file=/todo line=2 toggle
obsidian task file=/todo line=2 done
obsidian task file=/todo line=2 todo

# Create new task (via append)
obsidian append file=/todo content="- [ ] task name"