Todoist Natural Language

核心用法

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），导致任务漏查或重复

核心用法

Todoist Skill for OpenClaw 是一款面向OpenClaw AI助手的任务管理技能，允许用户通过自然语言或CLI命令直接操作Todoist任务列表。

主要功能模块：
1. 任务查询：支持按日期（today/tomorrow/overdue）、优先级（p1-p4）、项目、标签等多维度过滤
2. 任务创建：自然语言解析到期时间，支持重复任务设置（如"every Friday"）
3. 任务完成：通过关键词匹配快速标记任务完成
4. 项目管理：列出所有Todoist项目

使用方式：

• 自然语言（推荐）：直接向OpenClaw发出指令，如"Show me my tasks for today"、"Add 'call dentist' to my todo list for tomorrow"
• CLI命令：直接运行Python脚本，支持标准参数化操作

显著优点

• 零代码执行风险：纯Markdown文档型技能，不含可执行脚本，依赖AI解释执行
• 官方API直连：仅调用Todoist官方API（api.todoist.com），TLS加密传输
• 安全凭证管理：API密钥通过环境变量TODOIST_API_KEY获取，无硬编码风险
• 智能时区处理：支持TZ环境变量，确保"today"过滤符合本地实际日期
• 过滤语法完整：支持Todoist完整的过滤器语法，包括布尔运算（&、|）
• 透明度高：功能声明与实际行为完全一致，无隐藏功能

潜在缺点与局限性

• 纯文档依赖：scripts/todoist.py实际不存在，完全依赖AI正确解析和执行意图，可能出现理解偏差
• 无离线能力：完全依赖Todoist云服务，网络中断时不可用
• API限流约束：Todoist免费版有每15分钟450请求限制，高频操作可能触发
• T3来源等级：个人开发者维护，无企业级SLA保障，长期维护存不确定性
• 无原生错误处理：作为文档型技能，复杂错误场景需依赖AI自身的处理能力

适合人群

• OpenClaw用户：已部署OpenClaw AI助手，希望扩展任务管理能力的用户
• Todoist重度用户：习惯使用Todoist管理任务，追求语音/自然语言交互效率的人群
• 隐私敏感用户：重视API密钥安全存储，不愿授权第三方完整账户权限的用户
• 技术爱好者：愿意通过环境变量配置、CLI命令灵活使用的进阶用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码执行风险 | 极低 | 纯文档型，无eval/exec/system等危险函数 |

| 数据泄露风险 | 低 | 仅HTTPS传输至官方API，无第三方中转 |

| 凭证泄露风险 | 低 | 环境变量管理，但用户需自行保护本地环境 |

| AI误操作风险 | 中 | 自然语言理解偏差可能导致错误任务操作 |

| 服务可用性风险 | 中 | 依赖Todoist服务稳定性及API政策变化 |