40 lines
1.2 KiB
Markdown
40 lines
1.2 KiB
Markdown
---
|
||
title: "Todoist"
|
||
type: entity
|
||
tags: []
|
||
last_updated: 2026-05-02
|
||
---
|
||
|
||
## Overview
|
||
Todoist 是一个流行的 SaaS 任务管理工具，提供 REST API v2，支持任务（Tasks）、评论（Comments）、项目（Projects）、分区（Sections）等对象的 CRUD 操作。
|
||
|
||
## Role in Agent Workflows
|
||
Todoist 常被用作 AI Agent 的外部状态同步层：
|
||
- 创建/更新任务状态（In Progress / Waiting / Done）
|
||
- 外化 Agent 的内部 Plan 到任务描述
|
||
- 追加子步骤日志为评论
|
||
- 接收 Cron Job 的逾期提醒通知
|
||
|
||
## API Capabilities
|
||
- **Tasks API**：创建、更新、移动、关闭任务
|
||
- **Comments API**：在任务下追加评论
|
||
- **Sections API**：创建分区组织任务（如 🟡 In Progress）
|
||
- **Labels API**：为任务添加标签
|
||
- **Projects API**：组织多个项目
|
||
|
||
## Integration Pattern
|
||
典型集成方式（参考 [[TodoistTaskManager]]）：
|
||
```bash
|
||
./todoist_api.sh <endpoint> <method> [data_json]
|
||
./sync_task.sh <content> <status> [task_id] [description] [labels]
|
||
./add_comment.sh <task_id> <comment_text>
|
||
```
|
||
|
||
## Related Entities
|
||
- [[TodoistRestApi]]：官方 REST API
|
||
- [[OpenClawWorkspace]]：Agent 执行环境
|
||
|
||
## Related Concepts
|
||
- [[TaskVisibility]]
|
||
- [[ExternalReasoning]]
|