Open Source Robotics

Uma coleção selecionada de projetos, ferramentas e software de robótica de código aberto de alta qualidade.

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

Este site requer JavaScript. Por favor, habilite o JavaScript para explorar nossos projetos de robótica.