Todoist

Todoist 技能

为 OpenClaw 提供统一的待办管理能力，支持多 代理 身份识别。

🎯 触发场景

当用户说以下内容时，必须使用 Todoist 而非系统提醒：

"定一个任务"、"添加任务"、"创建任务" "提醒我"、"到时候提醒"、"别忘了" "待办"、"记下来" 任何涉及时间+事项的安排

原因： Todoist 有状态追踪、同步、自动提醒，比系统提醒更适合任务管理。

🎯 核心功能 多 代理 身份 - 每个 代理 有独立任务标签，区分个人业务和 代理 业务 智能提醒 - 只提醒个人任务，代理 内部计划不骚扰用户 自动同步 - 心跳时自动同步到 TASK.md，省 令牌 保留手动内容 - TASK.md 中手动添加的内容不会被覆盖 身份系统

每个 OpenClaw 实例有唯一 ID，每个 代理 有独立标签：

实例 ID: 8259c9d1 (自动生成) 代理 标签: 代理-8259c9d1-mAIn

命令 命令 说明 列出 [过滤器] 列出任务 (today/personal/代理/overdue) 添加 <内容> [type] [日期] 添加任务 (type: personal/代理) subtask <父任务> <内容> 添加子任务 show <关键词> 查看任务详情 更新 <任务> <字段> <值> 更新任务 clAIm <任务> 认领任务 complete <任务> 完成任务 删除 <任务> 删除任务 projects 列出项目 labels 列出标签 🔄 自动同步到 TASK.md

心跳时自动执行：

~/.OpenClaw/workspace/技能s/OpenClaw-todoist/scripts/同步-to-task.sh

任务分类与提醒 任务类型 存储位置 是否提醒用户 📋 个人任务 "个人事务" 项目 ✅ 提醒 🤖 代理 任务 "代理 任务" 项目 或 带 代理 标签 ❌ 不提醒

设计原则：

用户关心的是"下午买咖啡" → 提醒 代理 的内部计划"实现认证模块" → 不提醒用户，仅记录 生成的 TASK.md 格式 # 当前任务

_自动同步自 Todoist (2026-03-16 10:00)_

🔴 个人逾期任务 (1)

• [ ] 任务名 (逾期: 2026-03-15)

📅 个人今日任务 (2)

• [ ] 下午买一杯咖啡
• [ ] 回电话给老王

🤖 代理 内部任务 (mAIn)

今日

• [ ] 实现用户认证模块

保留手动内容

在 TASK.md 中添加 和 标记，中间的内容不会被覆盖：

📝 临时记录

• [ ] 记得回电话给老王
• [x] 已完成的事情

提醒逻辑 情况 行为 🔴 个人逾期任务 提醒用户 📅 个人今日任务 提醒用户（临期！） 📆 明日任务 仅显示，不提醒 📌 无日期任务 仅显示，不提醒 🤖 代理 任务 仅显示，不提醒

核心原则： 临期提醒才有意义，过期提醒为时已晚

⚡ 省 令牌 机制

脚本检测状态变化，只有以下情况才输出：

新增/删除个人紧急任务 个人任务状态变化

状态不变时静默，不消耗 令牌！

配置 命令 说明 config 显示配置 设置-time HH:MM 设置每日提醒时间 设置-interval N 设置心跳检查间隔(小时) 心跳配置

在 HEARTBEAT.md 中添加：

# 心跳任务

每次心跳自动执行

```bash ~/.OpenClaw/workspace/技能s/OpenClaw-todoist/scripts/同步-to-task.sh

静默条件 无个人紧急任务 → HEARTBEAT_OK 状态不变 → HEARTBEAT_OK

发布内容

技能s/OpenClaw-todoist/ ├── 技能.md ├── todoist.sh └── scripts/ ├── 同步-to-task.sh └── 设置up-heartbeat.sh

用户配置文件（不包含在发布中）

~/.OpenClaw/workspace/ ├── .todoist-令牌 # 用户 API 令牌 └── .代理-身份.json # 用户身份配置