OpenClaw + Todoist: visibilité en temps réel pour les longues exécutions

Les workflows agentiques qui durent longtemps sont incroyablement puissants, mais ils ressemblent souvent à une boîte noire. Vous demandez à OpenClaw de coder, de rechercher, de refactorer ou d’écrire, puis vous attendez. Si vous revenez une heure plus tard, il faut relire tout l’historique de chat pour comprendre ce qui s’est passé.

Ce guide explique comment transformer Todoist en console de suivi pour vos “runs” OpenClaw: l’agent crée une tâche pour chaque mission, écrit son plan dans la description, puis diffuse l’avancement étape par étape via des commentaires. Vous gagnez en transparence, en traçabilité et en confort, même quand l’agent travaille en arrière-plan.

Liens internes utiles:

• /blog/openclaw-cas-usage
• /blog/openclaw-guide-competences

Ce que vous allez construire

Un système minimal de visibilité qui:

• Crée une tâche Todoist pour chaque run OpenClaw “complexe” (recherche, build, migration, batch de contenu)
• Déplace la tâche entre des sections du type En cours, En attente, Terminé
• Écrit le plan de l’agent, ses hypothèses et ses critères de réussite dans la description
• Ajoute des commentaires comme journal d’exécution (ce qui a été fait, ce qui suit, et les blocages)
• Peut, en option, détecter les tâches “stagnantes” et vous prévenir

Le but est volontairement simple. On ne remplace pas un outil de gestion de projet. On ajoute une couche de transparence.

Pourquoi Todoist est un bon support de visibilité

Todoist a trois avantages très pratiques:

1. C’est rapide à consulter sur mobile, donc vous pouvez vérifier l’état sans ouvrir un laptop.
2. Les commentaires font un journal naturel, ce qui permet de reconstruire l’historique.
3. Les sections jouent le rôle d’état, ce qui permet de scanner en un coup d’œil ce qui tourne et ce qui est bloqué.

Compétences et prérequis

Côté OpenClaw, il vous faut:

• Un agent OpenClaw déployé (ClawRapid est idéal pour la disponibilité et la simplicité de déploiement)
• La capacité pour l’agent de créer et exécuter de petits scripts (localement ou dans votre environnement)
• Un accès API Todoist (token personnel)

Vous n’avez pas besoin d’un “skill Todoist” dédié pour commencer. L’approche ci-dessous s’appuie sur trois scripts bash qui appellent l’API REST Todoist.

Si vous débutez avec les skills: /blog/openclaw-guide-competences

Architecture de haut niveau

• Vous créez un projet Todoist “OpenClaw Workspace”.
• Vous y créez des sections représentant les états.
• OpenClaw utilise le token Todoist pour:
  • Créer ou mettre à jour une tâche
  • La déplacer en définissant section_id
  • Ajouter des commentaires au fil de l’eau

C’est un design portable. Si vous quittez Todoist, vous remplacez simplement le wrapper API.

Setup pas-à-pas

Étape 1: créer un projet Todoist et des sections

Dans Todoist:

1. Créez un nouveau projet: “OpenClaw Workspace”.
2. Ajoutez trois sections:
   • 🟡 In Progress (En cours)
   • 🟠 Waiting (En attente)
   • 🟢 Done (Terminé)

Astuce: si vous avez déjà un projet “Ops” ou “Automations”, vous pouvez réutiliser. L’important est d’avoir des sections pour l’état.

Étape 2: générer un token API Todoist

Dans Todoist, allez dans les paramètres et récupérez votre token API (token personnel).

Sécurité: traitez ce token comme un mot de passe. Ne le committez jamais.

Étape 3: récupérer le Project ID et les Section IDs

Vous avez besoin de:

• l’ID du projet “OpenClaw Workspace”
• les IDs des sections

Le plus simple est de demander à OpenClaw de lister les projets et sections une fois que vous avez fourni le token.

Prompt:

Je veux mettre en place un système de visibilité Todoist pour tes longues exécutions.

Utilise mon token Todoist (je le collerai ensuite).

1) Liste mes projets Todoist et trouve celui qui s’appelle "OpenClaw Workspace".
2) Liste les sections de ce projet et renvoie les section IDs pour:
- 🟡 In Progress
- 🟠 Waiting
- 🟢 Done

Retourne un seul objet JSON avec project_id et les 3 section_ids.

Étape 4: créer les scripts minimaux

Demandez à OpenClaw de créer trois scripts dans scripts/:

1. todoist_api.sh: wrapper curl
2. sync_task.sh: créer ou mettre à jour une tâche et la déplacer
3. add_comment.sh: ajouter une ligne de log

Référence (à adapter selon votre gestion des secrets):

#!/bin/bash
# scripts/todoist_api.sh
# Usage: ./todoist_api.sh <endpoint> <method> [data_json]
ENDPOINT=$1
METHOD=$2
DATA=$3
TOKEN="$TODOIST_API_TOKEN"

if [ -z "$DATA" ]; then
  curl -s -X "$METHOD" "https://api.todoist.com/rest/v2/$ENDPOINT" \
    -H "Authorization: Bearer $TOKEN"
else
  curl -s -X "$METHOD" "https://api.todoist.com/rest/v2/$ENDPOINT" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d "$DATA"
fi

#!/bin/bash
# scripts/sync_task.sh
# Usage: ./sync_task.sh <task_content> <status> [task_id] [description] [labels_json_array]
CONTENT=$1
STATUS=$2
TASK_ID=$3
DESCRIPTION=$4
LABELS=$5
PROJECT_ID="$TODOIST_PROJECT_ID"

case $STATUS in
  "In Progress") SECTION_ID="$TODOIST_SECTION_PROGRESS" ;;
  "Waiting")     SECTION_ID="$TODOIST_SECTION_WAITING"  ;;
  "Done")        SECTION_ID="$TODOIST_SECTION_DONE"     ;;
  *)              SECTION_ID=""                          ;;
esac

PAYLOAD="{\"content\": \"$CONTENT\""
[ -n "$SECTION_ID" ] && PAYLOAD="$PAYLOAD, \"section_id\": \"$SECTION_ID\""
[ -n "$PROJECT_ID" ] && [ -z "$TASK_ID" ] && PAYLOAD="$PAYLOAD, \"project_id\": \"$PROJECT_ID\""

if [ -n "$DESCRIPTION" ]; then
  ESC_DESC=$(echo "$DESCRIPTION" | sed ':a;N;$!ba;s/\n/\\n/g' | sed 's/"/\\"/g')
  PAYLOAD="$PAYLOAD, \"description\": \"$ESC_DESC\""
fi

[ -n "$LABELS" ] && PAYLOAD="$PAYLOAD, \"labels\": $LABELS"
PAYLOAD="$PAYLOAD}"

if [ -n "$TASK_ID" ]; then
  ./scripts/todoist_api.sh "tasks/$TASK_ID" POST "$PAYLOAD"
else
  ./scripts/todoist_api.sh "tasks" POST "$PAYLOAD"
fi

#!/bin/bash
# scripts/add_comment.sh
# Usage: ./add_comment.sh <task_id> <comment_text>
TASK_ID=$1
TEXT=$2
ESC_TEXT=$(echo "$TEXT" | sed ':a;N;$!ba;s/\n/\\n/g' | sed 's/"/\\"/g')
PAYLOAD="{\"task_id\": \"$TASK_ID\", \"content\": \"$ESC_TEXT\"}"
./scripts/todoist_api.sh "comments" POST "$PAYLOAD"

Important: ne hardcodez pas le token dans un repo. Préférez les variables d’environnement.

Étape 5: stocker la configuration dans des variables d’environnement

Variables recommandées:

• TODOIST_API_TOKEN
• TODOIST_PROJECT_ID
• TODOIST_SECTION_PROGRESS
• TODOIST_SECTION_WAITING
• TODOIST_SECTION_DONE

Si vous exécutez OpenClaw via ClawRapid, stockez-les côté environnement de déploiement.

Étape 6: définir des règles d’exécution claires

La clé est la cohérence. Ajoutez un “contrat” sous forme d’instructions persistantes.

Prompt à copier-coller:

Pour toute tâche qui risque de durer plus de 10 minutes:

1) Crée une tâche Todoist dans la section "🟡 In Progress".
- Titre: nom court orienté résultat
- Description: ton PLAN (étapes), tes hypothèses, et la définition de "terminé"

2) À chaque jalon, ajoute un commentaire Todoist avec:
- un timestamp
- ce que tu as fait
- ce qui suit
- tout risque ou blocage

3) Si tu es bloqué en attendant une réponse de ma part, déplace la tâche en "🟠 Waiting" et commente ce dont tu as besoin.

4) Quand c’est fini, déplace la tâche en "🟢 Done" et ajoute un résumé final avec les chemins vers les livrables.

Exemples de workflows et prompts

Prompt: suivre un refactor

Refactor l’authentification.

Utilise la visibilité Todoist:
- Crée une tâche En cours avec ton plan.
- Log chaque jalon en commentaire.
- Si tu as besoin de décisions, passe en En attente.

Contraintes:
- Ne change pas les routes API externes.
- Fais des petits commits.

Prompt: suivre une recherche profonde

Analyse les 10 meilleurs concurrents (landing pages) des assistants type OpenClaw.

Utilise la visibilité Todoist. Dans le plan, inclue:
- les sources
- la grille d’évaluation
- le format de sortie (un rapport markdown)

Ajoute des commentaires au fil de l’eau.

Prompt: batch de contenu

Rédige 5 articles de blog sur des use cases OpenClaw.

Utilise la visibilité Todoist.
Dans le plan, indique:
- les slugs
- le nombre de mots cible par article
- les liens internes à inclure

Log chaque article terminé avec les chemins des fichiers.

Modèle de tâche recommandé

Gardez une convention de titres pour scanner plus vite:

• [Build] Déployer une intégration n8n via webhook
• [Research] Analyse pricing des concurrents
• [Content] Draft 5 use cases OpenClaw

Dans la description, structurez ainsi:

• Objectif
• Plan
• Inputs nécessaires
• Emplacement de sortie
• Définition de terminé

Dépannage et leçons utiles

“La tâche se crée mais ne bouge jamais de section”

• Vérifiez que vous passez le bon section_id.
• Assurez-vous que la tâche est bien dans le bon projet avant de la déplacer.

“Les commentaires n’apparaissent pas”

• Vérifiez l’appel à /comments avec task_id.
• Vérifiez l’échappement JSON (guillemets et retours à la ligne).

“Trop de commentaires, c’est du bruit”

Définissez une politique de log:

• Log uniquement aux jalons, pas à chaque micro-action.
• Regroupez les micro-étapes.
• Ajoutez une section “prochaines actions” à chaque commentaire.

“Sécurité: je ne veux pas de token dans les logs”

• Stockez le token en variables d’environnement.
• Évitez d’afficher les commandes curl.
• Si vous partagez des logs, masquez l’en-tête Authorization.

FAQ

Q: Faut-il un projet Todoist dédié ? A: Ce n’est pas obligatoire, mais c’est recommandé. Ça évite de polluer vos tâches personnelles.

Q: Labels au lieu de sections, possible ? A: Oui. Les sections sont plus simples pour l’état. Les labels sont utiles pour catégoriser (Research, Build, Content). Beaucoup utilisent sections pour l’état et labels pour le type.

Q: Comment lier une tâche Todoist à plusieurs livrables ? A: Mettez les liens de sortie “canoniques” dans le commentaire final, et ajoutez une mini-liste “Livrables” dans la description.

Q: OpenClaw peut-il détecter automatiquement une tâche bloquée ? A: Oui. Un heartbeat peut vérifier le timestamp du dernier commentaire et vous notifier après X heures. Restez conservateur pour éviter les fausses alertes.

Q: Plan versus commentaires, qu’est-ce qu’on met où ? A: Le plan contient l’intention stable (étapes, critères). Les commentaires contiennent l’exécution et l’évolution.

Q: Est-ce que ça remplace un vrai suivi projet ? A: Non. C’est une couche de visibilité pour rendre le travail de l’agent auditable et moins stressant. Pour des projets complets, combinez avec un suivi “event-driven” (voir /blog/openclaw-cas-usage).

Exemple: à quoi ressemble un bon run dans Todoist

Pour que ce système “fasse sens”, l’objectif est qu’une tâche Todoist raconte une histoire complète.

Une bonne tâche de run contient:

• Un titre orienté résultat (et pas une activité)
• Une description qui inclut le plan et la définition de terminé
• 3 à 8 commentaires de jalons, pas 40 logs de micro-actions
• Un commentaire final avec les livrables et comment vérifier

Exemples de commentaires (version condensée):

1. 09:12 Démarrage. Branche feature/auth-refactor créée. 3 modules identifiés. Next: refactor validation token.
2. 09:45 Validation token refactorée. 4 tests ajoutés (edge cases). Next: câblage middleware.
3. 10:20 Middleware câblé, tests lancés. 1 test d’intégration en échec. Next: corriger le fixture.
4. 10:42 Test corrigé via mise à jour des mocks. Suite OK en local. Next: push + PR.
5. 11:05 PR ouverte (#123). Résumé + steps de rollout ajoutés. En attente de review.

Vous remarquerez ce qui n’est pas présent: pas de stack traces, pas de copier-coller de terminal, pas de logs verbeux. Le but est la visibilité, pas la télémétrie.

Si vous voulez une règle simple: “checkpoint à chaque changement d’étape” (ex: analyse, implémentation, tests, livraison). Cela suffit pour que vous puissiez reprendre le fil sans relire 200 messages.

Astuce supplémentaire: si votre équipe (ou vous) a tendance à se perdre dans les détails, imposez une structure minimale pour chaque commentaire de jalon:

• Ce qui est fait
• Ce qui est next
• Ce qui bloque (si applicable)

En pratique, trois lignes bien écrites valent mieux qu’un paragraphe. Et si vous relisez la tâche une semaine plus tard, vous comprendrez immédiatement l’état et la trajectoire.

Prochaines étapes

Une fois la transparence en place, vous pouvez améliorer:

• Ajouter une section “Waiting on external”
• Attacher automatiquement les chemins de fichiers et les liens de PR
• Créer un commentaire quotidien de synthèse (“progress du jour”)
• Combiner avec un morning brief qui remonte les 3 runs en cours (voir openclaw-morning-brief)

Vous voulez déployer OpenClaw et utiliser ce workflow aujourd’hui ? Utilisez le formulaire en haut de l’article, puis gardez /blog/openclaw-cas-usage en favori pour d’autres configurations éprouvées.