Telegram Todo List
Scanned@hengbo12345
npx machina-cli add skill @hengbo12345/telegram-todolist --openclawTelegram Todo List
Manage a Todo List stored in TODO.md through Telegram bot commands.
Commands
1. 查询 (query)
Usage: /todo query
Description: Display current todo list with status
Behavior:
- Read TODO.md file
- Parse tasks (both completed [x] and pending [ ])
- Format and display in clean table/list
- Show statistics (total tasks, completed, pending)
Example Output:
📋 待办事项列表
今日任务 (2026-02-12)
- [ ] 学习并掌握 skill-creator 技能介绍
- 理解技能创建的核心原则
待办总数：6 项未完成
已完成：1 项
2. 整理 (organize)
Usage: /todo organize
Description: Update, optimize, or restructure the todo list
Behavior Options:
- Add new task: User specifies task content
- Delete task: User specifies task number to remove
- Move task: Change task priority/order
- Edit task: Modify task content or check/uncheck status
- Batch operations: Add multiple tasks at once
Input Format: ``/todo organize <action> <details>
**Actions**:
- `add`: Add new task(s)
- `delete`: Remove task by number
- `move`: Move task to different position
- `edit`: Modify task content
- `check`: Mark task as completed
- `uncheck`: Mark task as uncompleted
**Example**:
``/todo organize add 学习Markdown语法
/todo organize delete 3
/todo organize move 1 to top
3. 执行 (execute)
Description: Complete a specific task
Behavior:
- Mark task as completed [x]
- Update timestamp
- Remove from active list
- Move to completed section
- Show confirmation
Input Format: ``/todo execute <task_number>
**Example**:
``/todo execute 1
File Structure
Storage: TODO.md in workspace root
/root/.openclaw/workspace/TODO.md
File Format:
# TODO List
## 今日任务 (2026-02-12)
- [ ] **Task 1**
- Subtask 1
- Subtask 2
- [ ] **Task 2**
---
## 待完成任务
### Category
- [ ] **Task 3**
---
## 已完成任务
- [x] **Completed Task**
- 记录时间：2026-02-12 07:55 UTC
- 内容：Task description
Implementation Details
Parsing Tasks
Regular Expression:
- \[([ x])\]\s*\*\*(.+?)\*\*.*?$ # Main task
- (.+)$ # Subtasks
Status:
[x]= completed[ ]= pending
Display Format
Clean Table:
📋 待办事项
今日任务 (2026-02-12)
1. [ ] Task 1
2. [ ] Task 2
待办总数：2 项未完成
已完成：0 项
Error Handling
Task Not Found:
- "未找到任务 #N"
- Ask user to verify task number
Invalid Format:
- "格式错误，请使用正确的命令格式"
- Show usage example
File Read Error:
- "无法读取 TODO.md，请检查文件权限"
- Try to recreate default template
User Experience
Confirmation Messages:
- Task completed: "✅ 已完成任务 #N"
- Task deleted: "🗑️ 已删除任务 #N"
- Task added: "➕ 已添加任务"
Progress Indicators:
- Show real-time count updates
- Calculate completion percentage
- Highlight pending vs completed
Tips
- Task Numbers: Always reference task by number in organize/execute commands
- Indentation: Keep consistent spacing for subtasks
- Comments: Lines starting with
#are ignored - Status Updates: Execute updates both visual status and file content
Examples
User: /todo query
Bot shows full todo list
User: /todo organize add 学习CSS
Bot adds task and shows confirmation
User: /todo execute 2
Bot marks task #2 as completed and updates list
User: /todo organize delete 5
Bot removes task #5 from list
Overview
This Telegram bot lets you manage a TODO.md task file from chat. It supports querying, organizing (add/edit/delete/move/check/uncheck), and executing (complete) tasks, with built-in progress stats and a clean display. Tasks are organized into 今日任务, 待完成任务, and 已完成任务 sections inside TODO.md.
How This Skill Works
The bot reads TODO.md from the workspace root and parses tasks using a regex that detects [ ] (pending) and [x] (completed). It then displays a formatted list or applies changes for organize or execute actions, updating the file content accordingly and showing confirmations or error messages.
When to Use It
- You want a quick view of today's tasks and progress via /todo query.
- You need to add, edit, delete, or move tasks directly from Telegram using /todo organize.
- You want to mark tasks as completed with /todo execute and see updated status.
- You need to reorder priorities to reflect changing workloads (move).
- You want to batch add multiple tasks or recover from formatting issues using the organize action formats.
Quick Start
- Step 1: Start the Telegram Todo List bot in Telegram and ensure TODO.md is accessible at /root/.openclaw/workspace/TODO.md.
- Step 2: Run /todo query to view the current list and progress.
- Step 3: Use /todo organize or /todo execute with a valid task number to manage tasks.
Best Practices
- Always reference task numbers when using organize/execute to target the correct item.
- Use the predefined actions (add, delete, move, edit, check, uncheck) for predictable results.
- After changes, run /todo query to verify the updated list and statistics.
- Keep task content concise and consistent, especially for subtasks and bolded titles.
- If the file cannot be read, use the default template recovery steps and retry the operation.
Example Use Cases
- User runs /todo query to display today’s tasks with status and counts.
- User runs /todo organize add Learn CSS to create a new task.
- User runs /todo execute 2 to complete task #2.
- User runs /todo organize delete 5 to remove a task.
- User runs /todo organize move 1 to top to reorder priorities.
