
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.
