OpenClaw : orchestration multi-agents (guide 2026)
Un seul assistant IA suffit pour des questions rapides. Le travail de production — code, alertes ops, chat familial, recherche — exige plusieurs personas sans sessions, identifiants ni permissions d'outils partagés. L'orchestration multi-agents OpenClaw répond avec un Gateway et de nombreux agents isolés (workspace, auth, sessions).
OpenClaw est un assistant personnel local-first (375k+ étoiles GitHub en 2026). Le routage multi-agents officiel envoie chaque message entrant via une table de bindings vers le bon agentId, sans cross-talk.
Ce guide couvre :
- Ce qu'est un agent OpenClaw sur disque
- Le routage par bindings (peer, account, channel)
- Ajouter un second agent en 7 étapes
- L'orchestration au-delà du routage
- Gateway natif vs orchestrateurs externes
Vous utilisez déjà Obra Superpowers ou Understand Anything ? OpenClaw est une autre couche : assistant always-on + routage de canaux. Voir aussi les meilleurs plugins Claude Code 2026.
Introduction
En production, la séparation des personas est essentielle. Détails ci-dessous.
Ce qu'inclut un agent OpenClaw
~/.openclaw/agents/<agentId>/.| Composant | Chemin | Rôle |
|---|---|---|
| Workspace | ~/.openclaw/workspace-<name> | cwd ; SOUL.md, skills |
| Agent dir | ~/.openclaw/agents/<agentId>/agent | auth, modèles, config |
| Sessions | ~/.openclaw/agents/<agentId>/sessions | historique, état routage |
| Config | ~/.openclaw/openclaw.json | Gateway, agents.list, bindings |
Règle : ne jamais réutiliser le même agentDir pour deux agents.
Source : docs multi-agent OpenClaw.
agentId · accountId · binding
| Concept | Signification |
|---|---|
agentId | Un cerveau (workspace + sessions + auth) |
accountId | Un login canal (ex. WhatsApp personal/biz) |
binding | Règle de match → agentId |
Le routage est déterministe : la règle la plus spécifique gagne.
Architecture Gateway
Message entrant → Gateway → bindings → agentId → workspace + session → LLM + outils (allowlist par agent).
Le Gateway est le routeur et gestionnaire de sessions. tools.agentToAgent est désactivé par défaut.
Configuration : ajouter un second agent
Étape 1 — Installer / mettre à jour
Installateur officiel, puis openclaw --version.
Étape 2 — Créer l'agent
openclaw agents add coding
Étape 3 — Lister
openclaw agents list --bindings
Étape 4 — Connexion canal
openclaw channels login --channel whatsapp --account work
Étape 5 — Éditer bindings
Règles peer au-dessus de accountId: "*".
Étape 6 — Redémarrer et sonder
openclaw gateway restart · openclaw channels status --probe
Étape 7 (option) — Modèle par canal
Définir model: par agent indépendamment.
Patterns d'orchestration
Routage : quel agent ? Orchestration : comment coopèrent plusieurs agents ?
Pattern A — Routage natif seul (recommandé d'abord)
| Scénario | Binding |
|---|---|
| WhatsApp pro / perso | accountId → agentId |
| DM modèle profond | peer.kind: "direct" + E.164 |
| Salon Discord code | guildId + channel |
| Groupe famille | agent dédié + mentions |
Pattern B — Délégation inter-agents
tools.agentToAgent avec allowlist explicite.
Pattern C — Orchestrateurs externes
| Projet | Style | Pour |
|---|---|---|
| openclaw-orchestrator | Planner LLM | objectifs ouverts |
| orchestrateur visuel | graphe, approbations | conformité |
| open-claw-code | agents code hiérarchiques | multi-dépôts |
- Identités de canal séparées → Pattern A
- Projets multi-étapes → B ou C
- TDD IDE → Obra Superpowers
Sécurité
Agents non fiables : sandbox + deny d'outils. tools.elevated est global — refuser exec par agent si besoin.
Où exécuter le Gateway
OpenClaw est local-first (macOS, Linux, WSL2). Gardez le Gateway en ligne pour les webhooks.
Les équipes utilisent parfois un Mac dédié 24h/24 plutôt qu'un portable — comme un serveur domestique, avec SSH pour l'admin. Voir notre guide accès SSH Mac mini M4 pour les bases d'accès distant.
Dépannage
Mauvais agent répond
openclaw agents list --bindings — ordre des règles, clés accountId, puis openclaw gateway restart.
Mélange auth / sessions
agentDir unique par agent ; openclaw channels login si besoin.
Échec de sonde
Identifiants, pare-feu, tokens Discord/Telegram selon les guides canaux.
FAQ
agentId.install.sh openclaw pour certains outils.Conclusion
L'orchestration multi-agents OpenClaw commence au Gateway : bindings déterministes, agents isolés. Puis agent-to-agent ou orchestrateurs externes si le routage seul ne suffit pas.
Héberger le Gateway en continu
Pour un Mac dédié avec OpenClaw, les bases SSH et d'exploitation sont dans notre centre d'aide.