Todoist Gestore Attività
Dai al tuo agente piena visibilità sulle attività a lunga esecuzione sincronizzando ragionamento, log di progresso e aggiornamenti di stato direttamente in Todoist — il tutto automatizzato via OpenClaw Ultra.
Panoramica del Sistema
Questo sistema trasforma Todoist in una dashboard di trasparenza per il tuo agente. Ogni attività complessa ottiene un elemento Todoist con il piano completo, commenti sui sotto-passaggi in tempo reale e transizioni automatiche di stato. Sai sempre cosa fa il tuo agente e dove si blocca.
| Livello del Sistema | Funzione Principale | Risultato |
|---|---|---|
| Livello Creazione Attività | Auto-creare attività Todoist con il piano di ragionamento completo dell'agente | Attività tracciata nel progetto/sezione corretto |
| Livello Streaming Progresso | Completamento sotto-passaggi in tempo reale registrato come commenti | Log di esecuzione cronologico |
| Livello Gestione Stato | Spostare automaticamente le attività tra le sezioni In Progress / Waiting / Done | Stato visivo del pipeline |
| Livello Monitoraggio Salute | Verifica periodica heartbeat per attività bloccate o fallite | Alert tempestivo su attività bloccate |
| Livello Reportistica | Riepilogo giornaliero delle attività completate con metriche di esecuzione | Report di produttività a fine giornata |
Prerequisiti
| Elemento | Requisito |
|---|---|
| OpenClaw Ultra | Installato e in esecuzione |
| Account Todoist | Piano Free o Pro con accesso API |
| Token API Todoist | Ottenere da Impostazioni Todoist > Integrazioni |
| Project ID | Creare un progetto (es. "OpenClaw Tasks") e copiare il suo ID |
Passo 0 — Ottenere le Credenziali API Todoist
Prima che l'agente possa sincronizzare le attività, hai bisogno dell'accesso API.
Passi Operativi
- Vai su Impostazioni Todoist > Integrazioni
- Copia il tuo Token API
- Crea un nuovo progetto chiamato "OpenClaw Tasks"
- Crea 3 sezioni al suo interno: 🟡 In Progress, 🟠 Waiting, 🟢 Done
- Annota il Project ID e i Section IDs (visibili nell'URL cliccando su ciascuna sezione)
Passo 1 — Lasciare che l'Agente Costruisca gli Script di Sincronizzazione
Invece di installare uno skill, chiedi a OpenClaw di creare gli script di integrazione da solo.
Prompt Pronto all'Uso
Voglio che tu costruisca un sistema di visibilità delle attività basato su Todoist per le tue esecuzioni.
Prima, crea tre script bash in una cartella 'scripts/':
1. todoist_api.sh — un wrapper curl per la REST API di Todoist
2. sync_task.sh — creare o aggiornare attività con section_ids per In Progress, Waiting, Done
3. add_comment.sh — pubblicare log di progresso come commenti su un'attività
Usa queste credenziali:
- Token: [il tuo token API Todoist]
- Project ID: [il tuo ID progetto]
- Section IDs: In Progress [id], Waiting [id], Done [id]
Una volta creati, verifica che gli script funzionino creando un'attività di test.Struttura degli Script (Auto-generata)
L'agente genererà script che chiamano la REST API di Todoist:
- todoist_api.sh — wrapper generico GET/POST
- sync_task.sh — crea attività nella sezione corretta con il piano nella descrizione
- add_comment.sh — aggiunge log di esecuzione come commenti
INFO
Nessuna programmazione manuale necessaria. L'agente gestisce la creazione degli script — incolla semplicemente il prompt sopra con le tue credenziali.
Passo 2 — Attivare la Modalità Visibilità Attività
Indica all'agente di usare Todoist per ogni attività complessa d'ora in poi.
Prompt
Da ora in poi, per ogni attività complessa che ti do:
1. Prima di iniziare, crea un'attività Todoist in "🟡 In Progress"
- Nome attività: breve riassunto dell'obiettivo
- Descrizione: il tuo PIANO di esecuzione completo (passo per passo)
2. Per ogni sotto-passaggio completato, chiama add_comment.sh con:
- cosa è stato fatto
- risultati o decisioni chiave
- eventuali blocchi incontrati
3. Quando l'attività è completa, spostala in "🟢 Done"
4. Se bloccata e in attesa di me, spostala in "🟠 Waiting" e spiega perché
Inizia elaborando questa attività: [la tua prima attività complessa]Passo 3 — Sincronizzazione Attività Singola (Modalità Manuale)
Per attività ad-hoc rapide che necessitano comunque di tracciamento.
Prompt
Traccia questa attività in Todoist:
Task: [descrizione]
Plan: [passi brevi]
Priority: [high/medium/low]
Creala in "🟡 In Progress" e aggiornala man mano che ti do ulteriori istruzioni.Passo 4 — Abilitare il Monitoraggio Heartbeat
Prevenire fallimenti silenziosi verificando il progresso delle attività periodicamente.
Prompt
Configura una routine di monitoraggio heartbeat:
Ogni 30 minuti, verifica tutte le attività Todoist in "🟡 In Progress":
- Per ogni attività, verifica che l'ultimo commento sia entro gli ultimi 25 minuti
- Se un'attività non ha nuovi commenti per 30+ minuti, segnalala come bloccata
- Notificami via [Telegram / email] con: nome attività, tempo dall'ultimo aggiornamento, possibile causa
Esegui anche un controllo quotidiano alle 18:
- Riepiloga tutte le attività spostate in "🟢 Done" oggi
- Elenca le attività ancora in "🟠 Waiting" con la loro età
- Riporta il numero medio di commenti per attività completataPasso 5 — Auto-riconciliare le Attività Bloccate
Lasciare che l'agente recuperi o escaletti quando le attività diventano silenziose.
Prompt
Quando un'attività è segnalata come bloccata (nessun aggiornamento per 30+ min):
1. Verifica se il piano originale dell'attività può essere ripreso
2. Se sì, pubblica un commento di recupero e continua
3. Se no, sposta in "🟠 Waiting" e spiega cosa serve
4. Se bloccata per 2+ ore, escaletta con un messaggio diretto a meLogica Finale del Workflow
Dai un'attività → L'agente crea attività Todoist con piano →
I commenti dei sotto-passaggi vengono trasmessi in tempo reale → Lo stato si aggiorna automaticamente →
L'heartbeat monitora la salute → Controlli Todoist in qualsiasi momento per piena visibilitàConsigli Pratici d'Uso
- Usa nomi attività descrittivi così la lista Todoist è consultabile a colpo d'occhio
- Controlla prima la sezione "🟠 Waiting" quando apri Todoist — è dove l'agente ha bisogno di te
- Abbina con il workflow Note Riunione Automatizzate per creare automaticamente attività di follow-up
- Archivia la sezione "🟢 Done" settimanalmente per mantenere la board pulita