---
title: "Todoist Task Manager"
type: entity
tags: [AI Agent, Todoist, 任务管理, 可观测性]
---

## Aliases
- Todoist Task Manager
- todoist-task-manager

## Definition

Todoist Task Manager 是一个 AI Agent 任务可视化系统，通过 Todoist REST API 将 Agent 的内部推理和进度日志同步到 Todoist 任务看板，实现长时间运行任务的状态追踪和透明度提升。

## Core Components

### Bash Scripts

| Script | 职责 |
|--------|------|
| `scripts/todoist_api.sh` | Todoist REST API 的 curl 封装，支持 GET/POST/PUT/DELETE |
| `scripts/sync_task.sh` | 创建/更新任务，按 Section（In Progress/Waiting/Done）分类 |
| `scripts/add_comment.sh` | 向任务追加评论，记录子步骤完成日志 |

### Todoist Section Structure

- `🟡 In Progress` — 正在执行的任务
- `🟠 Waiting` — 等待中的任务
- `🟢 Done` — 已完成的任务

## Workflow

1. Agent 接收到复杂任务 → 在 `In Progress` 创建任务，将 Plan 写入任务描述
2. 每完成一个子步骤 → 调用 `add_comment.sh` 追加进度日志
3. 任务完成 → 将任务移至 `Done` Section
4. Heartbeat 脚本监控停滞任务并通知用户

## Integration

- **API**: Todoist REST API v2
- **Agent**: OpenClaw（Agent 可自行创建和管理这些脚本）
- **Visibility**: 外部化内部推理，提升用户对 Agent 行为的可观测性

## Related Concepts

- [[Agent-Task-Visibility]]
- [[Task-Automation]]
- [[工作流自动化]]
- [[Todoist]]

## Related Entities

- [[OpenClaw]]
- [[Todoist]]

## Source

- [[sources/todoist-task-manager-agent-task-visibility]]