Skip to content

Todoist Gestor de Tareas

Da a tu agente visibilidad total sobre tareas de larga duración sincronizando razonamiento, registros de progreso y actualizaciones de estado directamente a Todoist — todo automatizado vía OpenClaw Ultra.

Vista General del Sistema

Este sistema convierte Todoist en un panel de transparencia para tu agente. Cada tarea compleja obtiene un elemento en Todoist con el plan completo, comentarios de subpasos en tiempo real y transiciones automáticas de estado. Siempre sabes qué hace tu agente y dónde se atasca.

Capa del SistemaFunción PrincipalResultado
Capa de Creación de TareasAuto-crear tareas Todoist con el plan de razonamiento completo del agenteTarea rastreada en el proyecto/sección correcta
Capa de Streaming de ProgresoCompletación de subpasos en tiempo real registrada como comentariosRegistro de ejecución cronológico
Capa de Gestión de EstadoMover tareas automáticamente entre secciones In Progress / Waiting / DoneEstado visual del pipeline
Capa de Monitoreo de SaludVerificación periódica de heartbeat para tareas estancadas o fallidasAlerta oportuna sobre tareas bloqueadas
Capa de ReportesResumen diario de tareas completadas con métricas de ejecuciónReporte de productividad al final del día

Prerrequisitos

ElementoRequisito
OpenClaw UltraInstalado y en ejecución
Cuenta TodoistPlan Free o Pro con acceso a API
Token API de TodoistObtener de Configuración de Todoist > Integraciones
Project IDCrear un proyecto (ej. "OpenClaw Tasks") y copiar su ID

Paso 0 — Obtener Credenciales API de Todoist

Antes de que el agente pueda sincronizar tareas, necesitas acceso a la API.

Pasos de Operación

  1. Ve a Configuración de Todoist > Integraciones
  2. Copia tu Token API
  3. Crea un nuevo proyecto llamado "OpenClaw Tasks"
  4. Crea 3 secciones dentro: 🟡 In Progress, 🟠 Waiting, 🟢 Done
  5. Anota el Project ID y los Section IDs (visibles en la URL al hacer clic en cada sección)

Paso 1 — Dejar que el Agente Construya los Scripts de Sincronización

En lugar de instalar un skill, pide a OpenClaw que cree los scripts de integración por sí mismo.

Prompt Listo para Usar

Quiero que construyas un sistema de visibilidad de tareas basado en Todoist para tus propias ejecuciones.

Primero, crea tres scripts bash en una carpeta 'scripts/':

1. todoist_api.sh — un wrapper curl para la REST API de Todoist
2. sync_task.sh — crear o actualizar tareas con section_ids para In Progress, Waiting, Done
3. add_comment.sh — publicar registros de progreso como comentarios en una tarea

Usa estas credenciales:
- Token: [tu token API de Todoist]
- Project ID: [tu ID de proyecto]
- Section IDs: In Progress [id], Waiting [id], Done [id]

Una vez creados, verifica que los scripts funcionen creando una tarea de prueba.

Estructura de Scripts (Auto-generada)

El agente generará scripts que llaman a la REST API de Todoist:

  • todoist_api.sh — wrapper genérico GET/POST
  • sync_task.sh — crea tareas en la sección correcta con el plan en la descripción
  • add_comment.sh — agrega registros de ejecución como comentarios

INFO

No se necesita código manual. El agente maneja la creación de scripts, solo pega el prompt anterior con tus credenciales.

Paso 2 — Activar el Modo de Visibilidad de Tareas

Indica al agente que use Todoist para cada tarea compleja en adelante.

Prompt

De ahora en adelante, para cada tarea compleja que te dé:

1. Antes de empezar, crea una tarea Todoist en "🟡 In Progress"
   - Nombre de tarea: breve resumen del objetivo
   - Descripción: tu PLAN de ejecución completo (paso a paso)

2. Por cada subpaso completado, llama a add_comment.sh con:
   - lo que se hizo
   - resultados o decisiones clave
   - cualquier bloqueante encontrado

3. Cuando la tarea esté completa, muévela a "🟢 Done"
4. Si está bloqueada y esperándome, muévela a "🟠 Waiting" y explica por qué

Empieza procesando esta tarea: [tu primera tarea compleja]

Paso 3 — Sincronización de Tarea Única (Modo Manual)

Para tareas rápidas ad-hoc que aún necesitan seguimiento.

Prompt

Rastrea esta tarea en Todoist:
Task: [descripción]
Plan: [pasos breves]
Priority: [high/medium/low]

Créala en "🟡 In Progress" y actualízala conforme te dé más instrucciones.

Paso 4 — Habilitar Monitoreo Heartbeat

Prevenir fallos silenciosos verificando el progreso de tareas periódicamente.

Prompt

Configura una rutina de monitoreo heartbeat:

Cada 30 minutos, verifica todas las tareas Todoist en "🟡 In Progress":
- Para cada tarea, verifica que el último comentario sea de los últimos 25 minutos
- Si alguna tarea no tiene nuevos comentarios por 30+ minutos, márcala como estancada
- Notifícame vía [Telegram / correo] con: nombre de tarea, tiempo desde última actualización, posible causa

También ejecuta una verificación diaria a las 6 PM:
- Resume todas las tareas movidas a "🟢 Done" hoy
- Lista tareas aún en "🟠 Waiting" con su antigüedad
- Reporta el promedio de comentarios por tarea completada

Paso 5 — Auto-reconciliar Tareas Estancadas

Dejar que el agente recupere o escale cuando las tareas quedan en silencio.

Prompt

Cuando una tarea se marca como estancada (sin actualización por 30+ min):

1. Verifica si el plan original de la tarea puede reanudarse
2. Si sí, publica un comentario de recuperación y continúa
3. Si no, muévela a "🟠 Waiting" y explica qué se necesita
4. Si lleva estancada 2+ horas, escala con un mensaje directo a mí

Lógica Final del Workflow

Das una tarea → El agente crea tarea Todoist con plan →
Comentarios de subpasos se transmiten en tiempo real → Estado se actualiza automáticamente →
Heartbeat monitorea la salud → Revisas Todoist en cualquier momento para visibilidad total

Consejos Prácticos de Uso

  1. Usa nombres descriptivos para que la lista de Todoist sea escaneable de un vistazo
  2. Revisa la sección "🟠 Waiting" primero al abrir Todoist — ahí es donde el agente te necesita
  3. Combina con el workflow de Notas de Reunión Automatizadas para crear tareas de seguimiento automáticas
  4. Archiva la sección "🟢 Done" semanalmente para mantener el tablero limpio