---
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]]