A Python-based integration for managing structured tasks and databases within SiYuan Note via its HTTP API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install siyuan-task-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install siyuan-task-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SiYuan Note Task Management?
The SiYuan Note Task Management skill allows users to bridge the gap between automated workflows and their personal knowledge management system. By utilizing this integration from the Openclaw Skills collection, developers can programmatically create, update, and query tasks stored within SiYuan Note (思源笔记). The skill leverages SiYuan's Attribute View (database) features to provide a structured way to track work items while maintaining a rich-text environment for detailed notes.
This tool is designed for users who want to treat their notes as a dynamic database. It automates the tedious parts of task management, such as creating sub-documents for task materials, managing status transitions, and organizing attachments. By using the Openclaw Skills framework, it ensures that your task data remains consistent across the SiYuan interface and your local development environment.
SiYuan Note Task Management Use Cases
- Creating and tracking professional work items directly from a terminal or AI agent.
- Maintaining a centralized task database in SiYuan Note with automated metadata tagging.
- Synchronizing task statuses across different projects and notebooks.
- Programmatically attaching images and assets to specific task documentation sections.
- Automating the generation of templated sub-documents for complex project milestones.
How SiYuan Note Task Management Works
- The skill connects to your local or remote SiYuan Note instance using an API token and URL defined in a configuration file.
- An initialization script sets up a specialized Task List document and an Attribute View database to store task metadata.
- When a task is created, the system generates a database row and a linked sub-document using a predefined Markdown template.
- Users interact with tasks via the Python CLI, which handles the mapping of parameters to SiYuan's internal block and attribute structures.
- Changes to a task, such as renaming or deletion, are automatically synchronized between the database entry and the corresponding sub-document.
SiYuan Note Task Management Setup
First, configure your SiYuan instance credentials in config.env located in the skill root:
SIYUAN_API_URL=http://your-ip:port
SIYUAN_API_TOKEN=your_token
SIYUAN_NOTEBOOK_NAME=work
Initialize the database and schema using the Openclaw Skills task runner:
cd scripts
python3 task_ops.py init
This command automatically creates the task document and database columns required for operation.
SiYuan Note Task Management Data Schema & Taxonomy
Tasks are organized within an Attribute View database with the following structure:
| Column | Type | Values/Notes |
|---|---|---|
| Task Name | block | Primary key linked to sub-document |
| Content | text | Main task description |
| Importance | select | High, Medium, Low |
| Urgency | select | High, Medium, Low |
| Status | select | Not Started, In Progress, Completed, Suspended |
| Time Tracking | date/created | Auto-managed timestamps |
Each task generates a sub-document with standardized headers: # Task Description, # Task Attachments, and # Next Steps.
SiYuan Note Task Management Advanced Features
- Full CRUD support for SiYuan Attribute Views (databases) via Python.
- Automatic lifecycle synchronization between database rows and sub-documents.
- Advanced SQL query capabilities through the low-level API client.
- Support for attaching images to specific document sections using path-based targeting.
- Customizable schema migration tools to update task properties without data loss.
- Programmatic access via the TaskManager class for integration into larger Openclaw Skills automation pipelines.
SKILL.md
Loading
Related Openclaw Skills
AI Drama Prompt Factory
A comprehensive end-to-end pipeline designed to transform novels or original story ideas into structured, production-ready AI prompt packages for video and audio generation.
Quant Trader
A professional-grade quantitative trading system for cryptocurrency that handles everything from backtesting and strategy optimization to live execution.
Public Relations Manager
An AI-powered assistant designed to automate media matching, press release generation, and strategic campaign planning.
Personal CFO
An AI-powered personal finance management system for tracking expenses, managing budgets, and receiving smart financial recommendations.
Claw Drive
An AI-managed personal drive that provides automated categorization, deduplication, and natural language retrieval for your local files.
PPT Generator
An automated tool that converts raw speaker scripts into sleek, Steve Jobs-inspired vertical HTML presentations with a minimalist tech aesthetic.
Featured*
