Sub-Agents OpenClaw : Orchestrer Workflows Complexes

18 mars 2026, 8h00

🌅 Hello ! Cette semaine, plusieurs d'entre vous m'ont demandé comment gérer les workflows multi-agents dans OpenClaw. Spoiler : c'est exactement pour ça que les sub-agents existent. Aujourd'hui, on explore comment orchestrer plusieurs agents pour multiplier votre productivité. 🦞🤖

🎓 Deep Dive : Sub-Agents — Déléguer Comme un Pro

Qu'est-ce qu'un Sub-Agent ?

Un sub-agent, c'est un agent temporaire spawné par votre agent principal pour exécuter une tâche spécifique en parallèle.

Analogie :

Vous êtes un manager. Au lieu de tout faire vous-même, vous déléguez :

• Recherche web → Agent Veille
• Code review → Agent Code
• Rédaction rapport → Agent Rédaction

Chaque sub-agent tourne en session isolée, fait son taf, retourne le résultat, puis disparaît.

Workflow Sub-Agent

┌──────────────────┐
│  Agent Principal │
│  (vous)          │
└────────┬─────────┘
         │
         │ sessions_spawn(task="Fix bug #123")
         ▼
┌──────────────────┐
│  Sub-Agent 1     │
│  (Codex)         │  ← Session isolée
└────────┬─────────┘
         │
         │ Résultat
         ▼
┌──────────────────┐
│  Agent Principal │
│  *intègre résultat*
└──────────────────┘

Quand Utiliser un Sub-Agent ?

✅ Tâches longues : Vous ne voulez pas bloquer votre session principale
✅ Tâches spécialisées : Coding, recherche, analyse (besoin d'un agent expert)
✅ Parallélisation : Lancer 3 sub-agents simultanément (veille, code, doc)
✅ Isolation : La tâche ne doit PAS polluer votre contexte principal

❌ Pas pour :

• Questions simples (overhead inutile)
• Tâches nécessitant le contexte principal (historique conversation)

Types de Sub-Agents

1. Sub-Agent OpenClaw (runtime="subagent")

Agent OpenClaw standard en session isolée.

sessions_spawn({
  runtime: "subagent",
  task: "Fais une recherche Tavily sur OpenClaw releases",
  mode: "run",  // One-shot
  cleanup: "delete"  // Supprime la session après
})

Use case : Tâches simples nécessitant tools OpenClaw (file, web, message).

2. ACP Agent (runtime="acp")

Agent Codex, Claude Code, ou autre harness ACP.

sessions_spawn({
  runtime: "acp",
  agentId: "codex",
  task: "Fix le bug dans src/auth.ts ligne 42",
  mode: "session",  // Persistant
  thread: true  // Crée un thread Discord
})

Use case : Coding, refactoring, debug complexe.

Best Practices Sub-Agents

✅ DO:

• Spécifiez la tâche clairement : "Cherche X", pas "Aide-moi"
• Utilisez mode: "run" pour one-shots (auto-cleanup)
• Utilisez thread: true pour ACP (suivi Discord)
• Limitez le timeout : runTimeoutSeconds: 300 (évite zombies)
• Monitorer : subagents list pour voir l'état

❌ DON'T:

• Ne spawnez pas 50 sub-agents simultanément (rate limits API)
• N'oubliez pas le cleanup (sessions orphelines)
• Ne spawnez pas pour des tâches <1 min (overhead)
• Ne comptez pas sur le contexte principal (isolé !)

Orchestration Avancée : Workflow Parallèle

Exemple concret : Veille multi-sources.

// Spawn 3 sub-agents en parallèle
const tasks = [
  sessions_spawn({ task: "Cherche actus GitHub openclaw/openclaw" }),
  sessions_spawn({ task: "Cherche actus Reddit r/LocalLLM" }),
  sessions_spawn({ task: "Cherche actus Hacker News OpenClaw" })
];

// Attendre tous les résultats
sessions_yield();  // Pause, attend les résultats

// Résultats arrivent dans la prochaine turn
// Agrégation + rédaction

Bénéfice : 3 recherches en parallèle = 3x plus rapide qu'en séquentiel.

Debugging Sub-Agents

# Lister les sub-agents actifs
openclaw subagents list

# Voir les logs d'un sub-agent
openclaw sessions history <sessionKey>

# Killer un sub-agent bloqué
openclaw subagents kill <target>

# Steerer (envoyer instruction)
openclaw subagents steer <target> --message "Arrête la recherche, retourne ce que tu as"

Pro Tip : Sub-Agent Templates

Créez des templates pour vos workflows récurrents :

# Template veille quotidienne
~/.openclaw/workspace/templates/veille-workflow.json

{
  "tasks": [
    { "agent": "tavily-search", "query": "OpenClaw releases" },
    { "agent": "tavily-search", "query": "AI agents news" },
    { "agent": "content-curator", "input": "results" }
  ]
}

Puis :

exec("bash scripts/run-template.sh veille-workflow.json")

Automatise les workflows complexes. (Oui, c'est meta : un agent qui spawne des agents depuis un template. Bienvenue en 2026. 🦞)

📰 Actus du Jour

🦞 OpenClaw Skills Marketplace — ClaHub v2

ClaHub (marketplace de skills) passe en v2

La plateforme ClaHub (clawhub.com) se refait une beauté :

Nouveautés :

• Catégorisation améliorée (Coding, Veille, Automation, etc.)
• Ratings communautaires
• Installation one-click depuis OpenClaw CLI
• 150+ skills disponibles

Trending skills :

1. openclaw-security-audit (audit automatique config)
2. github-pr-reviewer (review IA de PRs)
3. daily-standup-generator (génère standup depuis activité Git)

🔗 ClaHub v2

🤖 OpenAI GPT-5.4 — Multimodal Native

GPT-5.4 sort en beta privée

OpenAI annonce GPT-5.4 avec multimodal natif : texte + images + audio traités ensemble.

Exemple :

Input: [image] + "Explique ce graphique"
Output: *analyse visuelle + raisonnement textuel*

Impact OpenClaw : Support prévu dans la prochaine release (3.13). Config multi-model étendue.

🔗 OpenAI Blog

🚀 Replit Agent — Coding from Prompt to Deploy

Replit lance "Agent" : de l'idée au déploiement en 1 prompt

Replit annonce un agent qui :

1. Prend votre idée (prompt)
2. Génère le code
3. Déploie l'app (cloud Replit)

Exemple :

User: "Crée-moi un todo app avec auth"
Agent: *génère Next.js + Supabase + déploie*
Result: https://mytodoapp.replit.app (live en 2 min)

Réaction : Impressionnant pour les MVPs rapides. Mais vendor lock-in total. Avec OpenClaw + ACP (Codex), vous gardez le contrôle du code.

🔗 Replit Agent

Pour aller plus loin :

• Sessions OpenClaw : Main, Isolated, Thread-Bound — Les fondations de l'isolation des sub-agents
• Cron + ContextEngine : Automatise ta veille — Spawner des sub-agents automatiquement

À demain pour le prochain Deep Dive ! 🦞