siyuan-task
Manage tasks in SiYuan Note via its HTTP API. Create, query, update, and organize tasks stored in the 任务清单 document (with a TASK database) and sub-documents for related materials. Use when the user mentions SiYuan, task management, or needs to track work items.
Why use this skill?
Automate task management in SiYuan Note with OpenClaw. Create, track, and organize your work items in structured databases with automated sub-document creation.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/zhhkheaven/siyuan-task-skillWhat This Skill Does
The siyuan-task skill empowers your OpenClaw agent to act as a personal project management assistant directly integrated with your SiYuan Note instance. By leveraging SiYuan's powerful Attribute View (AV) database capabilities, this skill allows for automated task tracking, scheduling, and documentation. It manages a centralized '任务清单' (Task List) document where tasks are stored as structured database rows. Beyond simple data management, it automatically creates linked sub-documents for every task, providing a dedicated space for detailed descriptions, attachments, and 'next steps' planning. It handles the complex API interactions with the SiYuan HTTP server, abstracting away ID management and synchronization logic.
Installation
To get started, install the skill via the command: clawhub install openclaw/skills/skills/zhhkheaven/siyuan-task-skill. Navigate to the skill's root directory and locate the config.env file. Populate it with your specific SIYUAN_API_URL, SIYUAN_API_TOKEN, and SIYUAN_NOTEBOOK_NAME. Once configured, navigate to the scripts/ folder and execute python3 task_ops.py init. This critical initialization step scans your notebook, sets up the necessary task database structure if it does not exist, and populates your environment variables with the necessary block IDs to ensure seamless operations.
Use Cases
This skill is perfect for users who want to treat their notes as a functional workspace. Use it to keep track of engineering tickets, personal goals, or research projects. Because it maintains a 1:1 relationship between database entries and markdown sub-documents, it serves as both a high-level project manager and a deep-dive knowledge base. It is ideal for GTD (Getting Things Done) practitioners who use SiYuan as their primary system of record.
Example Prompts
- 'Create a new task named "Launch Website" in SiYuan with High importance and set the status to In Progress.'
- 'List all my pending tasks from the 任务清单 that are marked as high priority.'
- 'Update the "Next Steps" section for the task "Q4 Financial Report" to include "Review quarterly audit files".'
Tips & Limitations
The tool relies on an active HTTP connection to your SiYuan instance, so ensure your host machine has consistent network access to the API port. Always run the init script whenever you move the task database to a new notebook. While renaming tasks is supported, avoid manually deleting the associated sub-documents directly in the SiYuan GUI to ensure the database link remains intact; always let the agent handle deletions for synchronization reliability.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-zhhkheaven-siyuan-task-skill": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, file-write, external-api, code-execution