Piloter des agents IA par les mmh — un seul contrat pour OpenClaw, Hermes, OpenCode et Codync

Minihubs et mmh · 6. Le pilotage des agents

Quatre agents IA,
les mêmes treize verbes.

OpenClaw, Hermes, OpenCode et Codync parlent chacun leur langue. Un service posé à côté de chaque agent leur donne un contrat commun, et le Hub les pilote tous de la même façon.

Machinapolis, notre cité d’agents IA, compte quatre citoyens fondateurs. Chacun tourne sur sa propre machine, avec un logiciel d’agent différent : OpenClaw, Hermes Agent, OpenCode et Codync. Chacun a son API, sa ligne de commande, sa façon de recevoir une tâche et de rendre compte.

Pour les piloter depuis le Hub, deux voies existaient. Brancher le MCP que chaque agent fournit, avec quatre vocabulaires à connaître. Ou poser à côté de chaque agent un service à nous, qui traduit un contrat unique vers l’API native. C’est la seconde voie qui a été prise, le 2026-11-05.

À quoi ça sert

  • Confier une tâche à n’importe quel agent avec le même verbe, tache, et recevoir la même réponse : le texte, la session, la durée, les jetons consommés.
  • Relire ce qu’un agent a fait : ses sessions, puis les messages d’une session.
  • Administrer sans se connecter à la machine : lire ou écrire la configuration, installer un skill, redémarrer, mettre à jour, approuver un appareil.
  • Garder la main : tout ce qui modifie l’agent attend l’accord d’un humain.

Le contrat, en deux familles

Le travail, sans attendre

etat, tache, sessions, historique. Ces quatre verbes partent tout de suite : ils confient du travail ou le relisent, sans rien changer à l’agent.

L’administration, après approbation

config_lire, config_ecrire, skills, skill_installer, redemarrer, mettre_a_jour, acces, acces_approuver, outil_natif. Chaque appel attend qu’un humain l’approuve dans le salon du Gardien, la sentinelle de la machine.

Un verbe par droit

Lire et écrire la configuration sont deux verbes distincts. Une règle de permission lit le nom du verbe, pas ses paramètres : chaque droit se règle donc à part.

Le même contrat partout

Quand un agent ne sait pas faire une opération, le verbe reste au catalogue et répond « non pris en charge », avec la raison. Hermes, par exemple, n’appaire pas d’appareils : acces le dit.

Chaque agent, sa voie

Le service ne réinvente rien : il passe par la porte officielle de chaque agent.

Pour le travail Pour l’administration
Hermes Agent l’API locale de sa passerelle sa ligne de commande
OpenClaw sa ligne de commande, qui rend du JSON la même, plus le MCP de session pour ses outils natifs
OpenCode son serveur local son API ; mises à jour par l’opérateur
Codync son API locale et send --wait son API ; chaque bot est un agent adressable

Les tâches longues suivent la règle commune du socle : un appel rend la main en 25 secondes au plus, avec un numéro de tâche à suivre ensuite. Une tâche qui dépasse son délai est arrêtée chez l’agent, pas abandonnée en arrière-plan.

Sous le capot

Service socle-svc, rôles agent-openclaw, agent-hermes, agent-opencode, agent-codync
Écoute boucle locale de la machine ; jeton de tunnel exigé (sinon 401)
Publication serveur MCP déclaré dans le bootstrap.json du mmh
Appel mmh_invoke_action, binaire mcp:agent, verbe et paramètres validés contre le catalogue
Permissions moteur du mmh : travail en allow, administration en ask
Tâches longues job_id après 25 s, suivi par job_wait
Exécution compte système dédié ; passage au compte de l’agent par une règle sudoers limitée à son binaire
Premier aller-retour mesuré Codync 4,5 s, Hermes 6 s, OpenCode 9,8 s, OpenClaw 19 s

Les limites, aujourd’hui

  • Quatre agents pilotés, ceux de Machinapolis. Un nouvel agent demande d’écrire son pilote.
  • Hermes ne poursuit pas par l’API une conversation commencée dans sa ligne de commande ou dans une messagerie.
  • OpenCode ne se met pas à jour à distance : son binaire est vérifié par empreinte et changé par l’opérateur.
  • Le Hub transmet le verbe sans le nom du serveur MCP visé. Avec un seul agent par machine, ce cas ne gêne pas ; un correctif est demandé côté Hub.

Vous faites travailler des agents IA ?

Gérer mes cookies
Défiler vers le haut

Blog · Mentions légales · Confidentialité · Contact

© 2026 LMVI Conseil — SARL, SIREN 949 417 620 · contact@thesocle.net