核心用法
本 Skill 提供对 Todoist 官方 REST API 的直接调用能力，绕过官方 CLI 工具，适用于 CLI 不可用或故障的场景。支持完整的任务生命周期管理：
- 任务操作：列出现有任务、创建新任务（支持自然语言日期如 "today"）、标记完成（close）
- 项目管理：列出项目、查询项目下的分区（sections）
- 历史查询：按日期范围获取已完成任务（v1 端点）
所有请求通过 curl 发送，jq 用于 JSON 格式化输出。认证依赖 TODOIST_API_TOKEN 环境变量，支持从 ~/.openclaw/.secrets/todoist_token.json 自动读取。
显著优点
1. 双端点冗余设计：同时提供 REST v2（当前标准）和 API v1（遗留）端点，当 v2 返回 410 Gone 时可无缝降级
2. 零依赖：仅需系统常备工具 curl 和 jq，无需安装 Python/Node 等运行时
3. 官方 API 直连：直接调用 Todoist 官方端点，无第三方中间层，数据流转透明
4. 轻量快速：适合脚本化、自动化场景，响应即原生的 HTTP 响应
潜在缺点与局限
- 无高级功能：不支持实时同步、WebSocket 推送、复杂过滤查询（如按标签筛选需客户端处理）
- 手动 ID 管理：任务 ID、项目 ID 需用户自行提取和传递，无交互式选择
- 分页未封装：API 返回的分页结果需手动处理
next_cursor - 错误处理简陋：依赖 curl 的退出码和 HTTP 状态码，无结构化错误解析
- v1 端点风险：API v1 为遗留接口，未来可能被弃用
适合人群
- 需要快速脚本化管理 Todoist 的开发者/高级用户
- 官方 CLI 安装失败或环境受限的场景
- 追求最小依赖栈的自动化工作流
- 需要批量操作或与其他 shell 工具链集成的场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| **Token 泄露** | `TODOIST_API_TOKEN` 以环境变量或文件形式存储，需确保 `~/.openclaw/.secrets/` 目录权限正确（建议 700） |
| **误操作** | `close` 操作不可逆，批量脚本需加确认机制 |
| **API 限制** | 受 Todoist 官方速率限制（约 450 req/15min），高频脚本需自行限流 |
| **端点漂移** | v1 端点随时可能下线，依赖 v1 的功能需关注官方公告 |
总体评价
这是一个务实的应急/自动化工具，而非日常交互式管理方案。适合写入 crontab、CI/CD 流水线或与 fzf 等工具组合使用。对于普通用户，官方 CLI 或网页版体验更佳；对于需要"刚好够用"的自动化场景，此 Skill 是可靠选择。