Architecture OpenClaw : Composants clés et interactions
OpenClaw repose sur une architecture en hub-and-spoke avec un Gateway central comme plan de contrôle. Cette configuration permet à l'agent d'interagir avec des périphériques et des canaux d'entrée/sortie. Comprendre les rôles du nœud, de la session, du canal et de l'opérateur facilite la mise en place et l'utilisation du système pour les développeurs intermédiaires à seniors.
Un nœud agit comme un périphérique compagnon, se connectant au Gateway via WebSocket avec role: "node". Il expose une surface de commandes via node.invoke, incluant canvas., camera., device., notifications., system.* et system.run.
Rôles et interactions des acteurs
Le Gateway gère les connexions des nœuds et opérateurs, coordonne les canaux et sessions, et s'occupe de l'appairage des appareils. Les canaux s'intègrent à des messageries comme WhatsApp, Telegram, Discord, Slack et Signal, acheminant les messages vers la session → agent et vice-versa.
| Acteur | Responsabilité | Interactions |
|-------------|---------------------------------|---------------------------------------|
| Gateway | Plan de contrôle | Connexions nœuds/opérateurs, gestion sessions/canaux |
| Canaux | Intégration messageries | Messages vers Gateway → Session → Agent |
| Nœuds | Périphériques | Connexion avec role: node, node.invoke |
| Opérateurs| Gestion | Appairage, approbations, configuration |
| Sessions| Contexte agent | Stockage historique et état |
| Agent | Runtime IA | Appels outils/nœuds en session |
| Utilisateur | Utilisateur final | Via canaux/opérateurs |
| Appareils | Appareils connectés | Appairage via Gateway |
Flux : Utilisateur → Canal → Gateway → Session → Agent → Nœud/Canal. L'opérateur approuve l'appairage et les actions.
Types de nœuds :
- Application barre de menu macOS
- iOS/Android pour caméra, GPS, écran
- Sans interface (
openclaw node run) pour serveurs - Extension VS Code
Canvas et A2UI dans l'écosystème
Canvas est un espace de travail visuel contrôlé par l'agent. A2UI est un protocole pour générer dynamiquement des interfaces. L'agent appelle canvas.present ou canvas.a2ui.push pour créer des descriptions JSON d'UI, rendues sur les nœuds (macOS, iOS, Android, web).
Cas d'usage :
- Tableaux de bord dynamiques
- Formulaires interactifs
- Visualisation de données
- Applications natives IA (CRM, monitoring)
- Jeux, galeries
Les actions utilisateur remontent vers l'agent via WebSocket pour des mises à jour en temps réel.
Cas concret : CRM personnel
Problème : Données éparpillées dans Gmail, WhatsApp, Agenda, Notion.
Flux utilisateur : Message Telegram : « Profil d'Ivan Ivanov. » L'agent ouvre Canvas avec onglets, champs et historique.
Résultat : CRM unifié boosté à l'IA avec mises à jour en temps réel.
Architecture : Canal → Gateway → Session → Agent (compétence canvas + A2UI) → Nœud (UI). L'opérateur gère les approbations ; données stockées en session.
Cas concret : Briefing matinal
Problème : Collecte manuelle de données agenda, email, météo (10-15 min).
Flux utilisateur : « Briefing » → suites comme « Météo à Moscou. »
Résultat : Digest avec graphiques dans Canvas.
Architecture : Tâche planifiée Gateway → Session → Agent (compétences : agenda/email/météo) → Canal/Canvas. Nœud sans interface en option.
Cas concret : Liste de courses familiale
Problème : Chaos dans les chats de groupe.
Flux utilisateur : Messages Telegram de groupe → « Montre le panier » → Canvas avec liste et boutons.
Résultat : Liste à jour sur nœud mobile.
Architecture : Canal (groupe) → Gateway → Session → Agent (analyse, canvas) → Nœud mobile. WebSocket pour actions.
Cas concret : Orchestration multi-agents
Problème : Un agent unique perd le fil.
Flux utilisateur : « Appel » → délégation de tâches.
Résultat : Rapport final de l'équipe d'agents.
Architecture : Gateway (multi-sessions) → Agent principal (délégation) → Nœuds par agent → Canal.
Cas concret : Ferme d'imprimantes 3D
Problème : Surveillance manuelle des imprimantes Bambu Lab.
Flux utilisateur : « Statut X1C », « Imprime Benchy », « Montre la caméra. »
Résultat : Contrôle à distance avec flux caméra.
Architecture : Canal → Gateway → Session → Agent → Nœud physique (intégration Bambu) → Imprimantes.
Points clés
- Le Gateway est le cœur central — rien ne fonctionne sans lui.
- Les nœuds étendent l'agent aux appareils : sans interface pour serveurs, mobile pour capteurs.
- Canvas/A2UI transforment les chats en interfaces complètes.
- Les sessions isolent les contextes et stockent la mémoire.
- Les opérateurs assurent un appairage sécurisé et des approbations.
— Editorial Team
Aucun commentaire pour le moment.