| name | telegram-todolist |
| description | Telegram bot Todo List manager. Three commands: /todo query (show tasks), /todo organize (add/delete/edit tasks), /todo execute (complete tasks). Uses TODO.md file. Perfect for task tracking in Telegram. Supports statistics, progress tracking, and organized task management. |
Telegram 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
**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
