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.
Multi-agent routing · openclaw/openclaw
À lire aussi : Siri AI + Gemini (WWDC 2026) · Headroom compression outils · Mac mini OpenClaw mémoire & swap · Computex 2026 infra agents (Xeon 6+) · Hermes WebUI (interface 3 colonnes style Claude) · Understand Anything · DeepSeek-R1 local
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.