AgenticROS
Bridge indipendente dall'agente che dà ai robot ROS 2 una superficie di strumenti MCP condivisa
Licenza
Apache-2.0
Panoramica
AgenticROS è un livello di traduzione tra i runtime degli agenti di frontiera e ROS 2. Un robot dichiara verbi tipizzati (drive_base, take_snapshot, measure_depth, find_object, follow_person, più tutto ciò che aggiunge un pacchetto di skill) e ogni agente supportato vede lo stesso elenco, così un agente pianifica in base alle capacità invece che sui topic grezzi. Un unico server MCP serve Claude Code, Claude Desktop, Claude Dispatch, Codex CLI, Hermes e Antigravity CLI di Google; un plugin OpenClaw aggiunge un'interfaccia web, la teleoperazione e canali di messaggistica; una Gemini CLI usa il function calling senza alcun MCP. Lo strumento run_mission esegue grafi di passi dichiarativi in cui l'output di un passo entra come template nel successivo, e un pianificatore basato su regole compila obiettivi in inglese semplice in quei grafi senza bisogno di un modello nel ciclo.
Ciò che distingue questo progetto dagli altri bridge da MCP a ROS è il contratto più che la connessione. La maggior parte di essi espone direttamente topic e servizi ROS e lascia che sia il modello a capire che cosa fare con /cmd_vel. AgenticROS definisce un manifesto delle capacità (verbi con nome e input tipizzati, strutturato in modo da poter fungere anche da agent card ACP o A2A) e ogni adattatore espone lo stesso manifesto. La conseguenza pratica è che due agenti su stack di due fornitori diversi possono guidare lo stesso robot parlando lo stesso dialetto, e una missione scritta per uno funziona con l'altro.
Il runtime delle missioni è più ragionato di quanto suggerisca il numero di stelle. run_mission accetta un grafo di passi {id, capability, inputs, on_fail}, con gli output che scorrono in avanti tramite riferimenti {{stepId.outputs.field}}, così un rilevamento si collega direttamente a un comando di movimento senza codice di raccordo. Le query sulla flotta (ros2_find_robots_for per capacità, tipo e stato online, basate su un topic di heartbeat a 1 Hz) permettono a una missione di instradare passi diversi verso robot diversi. L'annullamento cambia un token controllato ai confini tra i passi, e quando il backend di memoria condivisa è attivo, ogni passo viene scritto nella memoria a lungo termine, così un altro agente in un altro processo può ricordare che cosa è successo e riprendere il lavoro.
Sul pianificatore in linguaggio naturale conviene essere precisi, perché l'impostazione del README potrebbe sopravvalutarlo. Si tratta di qualche centinaio di righe di pattern matching deterministico sul registro delle capacità («drive forward at 0,3 m/s» diventa drive_base{linear_x: 0.3}) e gli obiettivi che non riesce a compilare restituiscono un errore che elenca i verbi che conosce. È una scelta progettuale con un merito reale: nessuna dipendenza da un modello, nessuna chiamata a strumenti inventata. Non è una comprensione del linguaggio aperta, e non pretende di esserlo.
Perché è importante
Il collegamento tra agenti e ROS 2 è una categoria affollata e la maggior parte delle proposte è un sottile wrapper MCP sopra rostopic. Questa parte invece da un contratto di verbi condiviso, ed è ciò che rende le missioni portabili tra Claude, Codex, Gemini, Hermes e OpenClaw, invece di costringere ogni agente a imparare una superficie di strumenti su misura. Fa anche ciò che quasi nessuno in questa categoria fa: dice quale robot costruire, collegando un L298N a un telaio e pubblicando /cmd_vel, così il percorso dal leggere dei robot agentici al possederne uno è documentato dall'inizio alla fine.
Il problema che risolve
Collegare un agente di IA a un robot ROS 2 di solito significa scrivere una superficie di strumenti su misura per quell'agente e quel robot, e ricominciare da capo per il successivo. AgenticROS interpone un contratto di capacità tipizzato, così il robot viene descritto una volta sola e Claude, Codex, Gemini, Hermes e OpenClaw lo guidano tutti con gli stessi verbi e le stesse missioni.
Punti chiave
- Un unico manifesto delle capacità (drive_base, take_snapshot, measure_depth, find_object, follow_person, più le skill) esposto in modo identico a ogni agente supportato
- Un unico server MCP copre Claude Code, Claude Desktop, Claude Dispatch, Codex CLI, Hermes e Antigravity CLI; OpenClaw e Gemini hanno adattatori propri
- run_mission esegue grafi di passi dichiarativi con template {{stepId.outputs.field}} tra i passi e gestione on_fail per ogni passo
- Il pianificatore in linguaggio naturale è pattern matching deterministico, non un LLM, quindi non inventa mai una capacità che il robot non ha
- Gli strumenti per la flotta classificano i robot per capacità, tipo e stato online in base a un topic di heartbeat a 1 Hz, così una missione può coinvolgere più robot
- Funziona interamente con un modello di visione Ollama locale, se si preferisce non inviare i frame della telecamera a un'API cloud
- Simulazioni Gazebo e RViz di un AMR a 2 ruote e di un braccio a 6 gradi di libertà sono fornite con la CLI, così l'intero stack è testabile prima che esista qualsiasi hardware
- Una guida all'hardware accompagna da un telaio a trazione differenziale e un L298N, passando per RealSense, fino a un robot che un agente può guidare
A chi si rivolge
- Proprietari di robot ROS 2 che vogliono comunicare con un robot esistente da Claude Code, Codex o Gemini senza scrivere un adattatore
- Chiunque costruisca da componenti un piccolo robot a trazione differenziale e voglia il livello degli agenti previsto fin dall'inizio
- Team con più robot che vogliono un instradamento basato sulle capacità invece di namespace fissati nel codice
- Sviluppatori che hanno bisogno che la parte di visione funzioni in locale su Ollama invece che tramite un'API cloud
- Hobbisti che vogliono provare l'intero stack in Gazebo prima di comprare qualsiasi cosa
Limiti
- Un solo contributore e meno di 70 commit da marzo 2026: un lavoro valido, ma con un bus factor pari a uno
- 148 stelle e nessuna issue aperta suggeriscono che finora il progetto abbia avuto pochissimo uso esterno
- Non ci sono release su GitHub; il versionamento avviene solo sul pacchetto npm, ora alla 0.7.x
- Per le parti robot e simulazione serve ROS 2 Humble o Jazzy, quindi è un bridge verso ROS e non un'alternativa
- OpenClaw è l'integrazione di punta e ha l'interfaccia di configurazione, la teleoperazione e il caricatore di skill; gli altri adattatori sono più essenziali
- Il pianificatore in linguaggio naturale riconosce un vocabolario di verbi fisso, quindi tutto ciò che ne esce va scritto come grafo di passi esplicito
- La sezione del README sui contributi indica github.com/PlaiPin/agenticros per la clonazione, che ora restituisce 404
- La guida all'hardware è una build di riferimento con i prezzi dell'autore, non un kit testato: la distinta base va considerata un punto di partenza e i prezzi vanno ricalcolati da sé