Todoist Skill
为 OpenClaw 提供统一的待办管理能力,支持多 Agent 身份识别。
身份系统
每个 OpenClaw 实例有唯一 ID,每个 Agent 有独立标签:
实例 ID: 8259c9d1 (自动生成)
Agent 标签: agent-8259c9d1-main
命令
| 命令 | 说明 |
|---|---|
list [filter] |
列出任务 (today/personal/agent/overdue) |
add <内容> [type] [日期] |
添加任务 |
subtask <父任务> <内容> |
添加子任务 |
show <关键词> |
查看任务详情 |
update <任务> <字段> <值> |
更新任务 |
claim <任务> |
认领任务 |
complete <任务> |
完成任务 |
delete <任务> |
删除任务 |
projects |
列出项目 |
labels |
列出标签 |
配置
| 命令 | 说明 |
|---|---|
show |
显示配置 |
set-time HH:MM |
设置每日提醒时间 |
set-interval N |
设置心跳检查间隔(小时) |
set-agent <name> |
切换当前 Agent |
add-agent <name> |
添加新 Agent |
🔄 自动同步任务到 TASK.md
心跳时会自动同步 Todoist 任务到 ~/.openclaw/workspace/TASK.md:
~/.openclaw/workspace/skills/openclaw-todoist/scripts/sync-to-task.sh
生成的 TASK.md 格式:
# 当前任务
_自动同步自 Todoist (2026-03-16 10:00)_
## ⚠️ 逾期任务
- [ ] 任务名 (逾期: 2026-03-15)
## 📅 今日任务
- [ ] 任务名
## 📌 待办(无日期)
- [ ] 任务名
心跳配置
在 HEARTBEAT.md 中添加:
# 心跳任务
## 每次心跳自动执行
1. **同步 Todoist 任务到 TASK.md**
```bash
~/.openclaw/workspace/skills/openclaw-todoist/scripts/sync-to-task.sh
静默条件
- 无任务时回复 HEARTBEAT_OK
- 有逾期任务时主动提醒
### 一键配置
```bash
~/.openclaw/workspace/skills/openclaw-todoist/scripts/setup-heartbeat.sh
提醒逻辑
- ✅ 自动同步所有任务到 TASK.md
- ⚠️ 仅逾期任务时主动提醒用户
- 无任务或无逾期 → 静默(HEARTBEAT_OK)
发布内容
skills/todoist/
├── SKILL.md
└── todoist.sh
scripts/
├── agent-config.sh
└── heartbeat-tasks.sh
用户配置文件(不包含在发布中)
~/.openclaw/workspace/
├── .todoist-token # 用户 API token
└── .agent-identity.json # 用户身份配置