（7879期）Todoist Api Rest – 官方 API 直连，轻量任务管理

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