AgenticROS
Ponte agnóstica a agentes que dá aos robôs ROS 2 uma superfície de ferramentas MCP comum
Licença
Apache-2.0
Visão geral
O AgenticROS é uma camada de tradução entre runtimes de agentes de ponta e o ROS 2. Um robô anuncia verbos tipados (drive_base, take_snapshot, measure_depth, find_object, follow_person, além de tudo o que um pacote de habilidades acrescentar) e todo agente suportado vê a mesma lista, de modo que um agente planeja com base em capacidades, e não em tópicos brutos. Um único servidor MCP atende Claude Code, Claude Desktop, Claude Dispatch, Codex CLI, Hermes e o Antigravity CLI do Google; um plugin OpenClaw acrescenta uma interface web, teleoperação e canais de mensagens; um Gemini CLI usa function calling sem nenhum MCP. A ferramenta run_mission executa grafos de etapas declarativos em que a saída de uma etapa é inserida por template na seguinte, e um planejador baseado em regras compila objetivos em inglês simples nesses grafos sem precisar de um modelo no loop.
O que separa isto das outras pontes MCP-para-ROS é o contrato, não a conexão. A maioria expõe tópicos e serviços do ROS diretamente e deixa o modelo descobrir o que fazer com /cmd_vel. O AgenticROS define um manifesto de capacidades — verbos nomeados com entradas tipadas, moldados para servir também como cartão de agente ACP ou A2A — e todo adaptador expõe esse mesmo manifesto. A consequência prática é que dois agentes sobre pilhas de fornecedores diferentes podem dirigir o mesmo robô falando o mesmo dialeto, e uma missão escrita para um roda sob o outro.
O runtime de missões é mais pensado do que a contagem de estrelas sugere. run_mission recebe um grafo de passos {id, capability, inputs, on_fail}, com saídas fluindo adiante por referências {{stepId.outputs.field}}, de modo que uma detecção emenda direto num comando de movimento sem código de cola. Consultas de frota (ros2_find_robots_for por capacidade, tipo e estado on-line, apoiadas num tópico de batimento a 1 Hz) permitem que uma missão roteie passos diferentes para robôs diferentes. O cancelamento vira um token verificado nas fronteiras de passo e, com o backend de memória compartilhada ligado, cada passo é escrito em memória de longo prazo, de modo que outro agente em outro processo pode recordar o que aconteceu e retomar o trabalho.
Vale ser preciso sobre o planejador de linguagem natural, porque a redação do README pode vendê-lo além do que é. São algumas centenas de linhas de casamento de padrões determinístico contra o registro de capacidades — «drive forward at 0.3 m/s» vira drive_base{linear_x: 0.3} — e objetivos que ele não consegue compilar retornam um erro listando os verbos que conhece. É uma decisão de projeto com mérito real: sem dependência de modelo e sem chamadas de ferramenta inventadas. Não é compreensão aberta de linguagem, e não afirma ser.
Por que importa
A ponte de agentes para ROS 2 é uma categoria lotada e a maioria das entradas é um invólucro MCP fino sobre o rostopic. Esta parte de um contrato de verbos compartilhado, que é o que torna as missões portáveis entre Claude, Codex, Gemini, Hermes e OpenClaw em vez de obrigar cada agente a aprender uma superfície sob medida. E faz o que quase ninguém nessa categoria faz: diz qual robô construir, ligando um L298N a um chassi e publicando /cmd_vel, de forma que o caminho de ler sobre robôs agênticos até ter um esteja documentado de ponta a ponta.
Problema que resolve
Apontar um agente de IA para um robô ROS 2 normalmente significa escrever uma superfície de ferramentas sob medida para aquele agente e aquele robô, e recomeçar do zero no próximo. O AgenticROS coloca no meio um contrato de capacidades tipado: o robô é descrito uma vez, e Claude, Codex, Gemini, Hermes e OpenClaw o dirigem todos pelos mesmos verbos e pelas mesmas missões.
Pontos principais
- Um único manifesto de capacidades (drive_base, take_snapshot, measure_depth, find_object, follow_person, além de habilidades) exposto de forma idêntica a todo agente suportado
- Um único servidor MCP cobre Claude Code, Claude Desktop, Claude Dispatch, Codex CLI, Hermes e Antigravity CLI; OpenClaw e Gemini têm adaptadores próprios
- O run_mission executa grafos de etapas declarativos com templates {{stepId.outputs.field}} entre as etapas e tratamento on_fail por etapa
- O planejador de linguagem natural é correspondência de padrões determinística, não um LLM, então nunca inventa uma capacidade que o robô não tem
- As ferramentas de frota classificam robôs por capacidade, tipo e status online com base em um tópico de heartbeat de 1 Hz, para que uma missão possa abranger vários robôs
- Roda inteiramente em um modelo de visão local do Ollama, se você preferir não enviar quadros da câmera para uma API na nuvem
- Simulações em Gazebo e RViz de um AMR de 2 rodas e de um braço de 6 DOF acompanham a CLI, então toda a pilha pode ser testada antes de existir qualquer hardware
- Um guia de hardware leva você de um chassi de tração diferencial e um L298N, passando pela RealSense, até um robô que um agente pode conduzir
Para quem é
- Donos de ROS 2 que querem falar com um robô existente a partir do Claude Code, Codex ou Gemini sem escrever um adaptador
- Quem está montando um pequeno robô de tração diferencial com peças e quer a camada de agentes prevista desde o início
- Equipes com vários robôs que querem roteamento por capacidade em vez de namespaces fixos no código
- Desenvolvedores que precisam que a parte de visão rode localmente no Ollama e não por uma API na nuvem
- Entusiastas que querem experimentar a pilha inteira no Gazebo antes de comprar qualquer coisa
Limitações
- Um único contribuidor e menos de 70 commits desde março de 2026 — trabalho competente, mas com fator ônibus de um
- 148 estrelas e nenhuma issue aberta sugerem que o projeto teve pouquíssimo uso externo até agora
- Não há releases no GitHub; o versionamento acontece apenas no pacote npm, hoje em 0.7.x
- ROS 2 Humble ou Jazzy é exigido para as partes de robô e simulação, então isto é uma ponte para o ROS, não uma alternativa a ele
- O OpenClaw é a integração principal e fica com a interface de configuração, a teleoperação e o carregador de habilidades; os outros adaptadores são mais magros
- O planejador de linguagem natural reconhece um vocabulário fixo de verbos, então tudo fora dele precisa ser escrito como grafo de passos explícito
- A seção de contribuição do README aponta para github.com/PlaiPin/agenticros para clonar, endereço que hoje devolve 404
- O guia de hardware é uma montagem de referência com os preços do próprio autor, não um kit testado — trate a lista de materiais como ponto de partida e refaça a cotação por conta própria