核心用法
Todoist Skill 是 OpenClaw 平台的第三方任务管理扩展，通过调用 Todoist REST API v1 实现任务生命周期管理。用户可通过两种模式交互：
自然语言模式（OpenClaw 集成）：支持口语化指令，如"今天有什么任务""明天下午三点提醒我买牛奶"，系统解析意图后调用对应 API。
CLI 模式：直接执行 python3 todoist.py 配合子命令（list/add/complete/projects）及参数，支持标准 Todoist 过滤语法（如 today & p1 查询今日高优先级任务）。
显著优点
- 时区感知：通过
TZ环境变量实现本地化"今天"计算，避免云端时区与用户本地错位 - 过滤语法完整继承：支持官方全部过滤器（优先级、项目、标签、日期范围、布尔组合）
- 双模式兼容：既可嵌入 OpenClaw 语音工作流，也可作为独立脚本集成至现有自动化体系（如 cron、Alfred、Raycast）
- 零持久化：仅通过环境变量读取凭据，不本地存储用户数据
潜在缺点与局限性
- 依赖外部 API：Todoist 服务中断或速率限制时完全不可用；免费账户有 API 调用限额（约 50 次/分钟）
- Token 管理负担：需手动从网页端获取并配置环境变量，无 OAuth 流程，对非技术用户门槛较高
- 功能边界：不支持子任务展开、评论管理、附件上传等进阶功能；任务完成仅支持按关键词模糊匹配，存在误操作风险
- 平台锁定：深度绑定 OpenClaw 生态，脱离后需自行处理参数解析层
适合人群
- 已有 Todoist 账户且习惯命令行/语音交互的效率工具用户
- 希望将任务管理集成至自定义 AI 工作流（OpenClaw）的开发者
- 需要快速脚本化批量操作（如每日日报生成、逾期任务清理）的自动化爱好者
常规风险
- 凭据泄露：
TODOIST_API_KEY为长期有效令牌，若写入 shell 历史记录或明文提交至版本控制，可导致账户数据被完全访问 - 误删除/误完成：自然语言解析可能存在歧义（如"完成关于会议的任务"匹配多个结果），CLI 模式无二次确认机制
- 时区配置遗漏：未设置
TZ时，"today" 可能基于系统默认时区（常见为 UTC），导致任务漏查或重复