AgenticROS
ROS 2 로봇에 공통 MCP 도구 표면을 부여하는 에이전트 비종속 브리지
라이선스
Apache-2.0
개요
AgenticROS는 최신 에이전트 런타임과 ROS 2 사이의 변환 계층입니다. 로봇은 drive_base, take_snapshot, measure_depth, find_object, follow_person 등 타입이 지정된 동사와 스킬 패키지가 추가하는 모든 동사를 공개하고, 지원되는 모든 에이전트가 같은 목록을 보므로 에이전트는 원시 토픽이 아니라 기능을 기준으로 계획을 세웁니다. 하나의 MCP 서버가 Claude Code, Claude Desktop, Claude Dispatch, Codex CLI, Hermes, Google의 Antigravity CLI를 지원하고, OpenClaw 플러그인은 웹 UI, 원격 조작, 메시징 채널을 추가하며, Gemini CLI는 MCP 없이 함수 호출을 사용합니다. run_mission 도구는 한 단계의 출력이 다음 단계에 템플릿으로 들어가는 선언형 단계 그래프를 실행하고, 규칙 기반 플래너는 루프 안에 모델 없이도 평범한 영어 목표를 그런 그래프로 컴파일합니다.
다른 MCP-ROS 브리지와 이것을 가르는 것은 연결이 아니라 계약이다. 대부분은 ROS 토픽과 서비스를 그대로 노출하고 /cmd_vel을 어떻게 쓸지는 모델이 알아서 하게 둔다. AgenticROS는 역량 매니페스트를 정의한다. 타입이 붙은 입력을 갖는 이름 있는 동사들이며, 그대로 ACP나 A2A 에이전트 카드로도 쓰일 수 있는 형태다. 그리고 모든 어댑터가 바로 그 매니페스트를 내보인다. 실무적 귀결은 이렇다. 서로 다른 벤더 스택 위의 두 에이전트가 같은 로봇을 몰면서 같은 방언을 쓸 수 있고, 한쪽을 위해 쓴 미션이 다른 쪽에서도 돌아간다.
미션 런타임은 별 개수가 시사하는 것보다 더 깊이 다듬어져 있다. run_mission은 {id, capability, inputs, on_fail}로 이루어진 단계 그래프를 받고, 출력은 {{stepId.outputs.field}} 참조로 앞으로 흘러가므로 검출 결과가 접착 코드 없이 곧장 이동 명령으로 이어진다. 플릿 질의(역량·종류·온라인 상태로 거르는 ros2_find_robots_for, 뒤에는 1Hz 하트비트 토픽)를 쓰면 한 미션이 서로 다른 단계를 서로 다른 로봇에 보낼 수 있다. 취소는 단계 경계에서 확인되는 토큰을 뒤집고, 공유 메모리 백엔드가 켜져 있으면 모든 단계가 장기 기억에 기록되므로 다른 프로세스의 다른 에이전트가 무슨 일이 있었는지 되짚어 작업을 넘겨받을 수 있다.
자연어 플래너는 정확히 말해둘 가치가 있다. README의 표현이 과장으로 읽힐 수 있기 때문이다. 실체는 역량 레지스트리를 상대로 하는 수백 줄의 결정론적 패턴 매칭이다. 「drive forward at 0.3 m/s」는 drive_base{linear_x: 0.3}가 되고, 컴파일할 수 없는 목표는 자기가 아는 동사 목록과 함께 오류를 돌려준다. 실질적 장점이 있는 설계 선택이다. 모델 의존이 없고, 없는 도구 호출을 지어내지 않는다. 개방형 언어 이해가 아니며, 그렇다고 주장하지도 않는다.
중요한 이유
에이전트에서 ROS 2로 가는 다리는 붐비는 분야이고, 대부분의 항목은 rostopic 위에 얇게 씌운 MCP 래퍼다. 이것은 대신 공유 동사 계약에서 출발하며, 그 덕분에 미션이 Claude, Codex, Gemini, Hermes, OpenClaw 사이를 옮겨 다닌다. 에이전트마다 맞춤 도구 표면을 새로 익힐 필요가 없다. 게다가 이 분야에서 거의 아무도 하지 않는 일을 한다. 어떤 로봇을 만들어야 하는지 알려준다. L298N을 섀시에 배선하고 /cmd_vel을 발행하는 데까지. 에이전트 로봇에 관해 읽는 지점에서 실제로 한 대를 갖는 지점까지의 경로가 처음부터 끝까지 문서화되어 있다.
해결하는 문제
AI 에이전트를 ROS 2 로봇에 붙이려면 보통 그 에이전트와 그 로봇에 맞춘 도구 표면을 직접 써야 하고, 다음 조합에서는 처음부터 다시 해야 한다. AgenticROS는 타입이 붙은 역량 계약을 그 사이에 둔다. 로봇을 한 번만 기술하면 Claude, Codex, Gemini, Hermes, OpenClaw가 모두 같은 동사와 같은 미션으로 그것을 몬다.
핵심 요점
- drive_base, take_snapshot, measure_depth, find_object, follow_person에 스킬까지 더한 하나의 기능 매니페스트가 지원되는 모든 에이전트에 동일하게 노출됨
- 하나의 MCP 서버가 Claude Code, Claude Desktop, Claude Dispatch, Codex CLI, Hermes, Antigravity CLI를 지원하고, OpenClaw와 Gemini에는 전용 어댑터가 있음
- run_mission은 단계 사이에 {{stepId.outputs.field}} 템플릿을 사용하고 단계별 on_fail 처리를 갖춘 선언형 단계 그래프를 실행함
- 자연어 플래너는 LLM이 아닌 결정론적 패턴 매칭이므로, 로봇에 없는 기능을 지어내는 일이 없음
- 플릿 도구는 1 Hz 하트비트 토픽을 기준으로 기능, 종류, 온라인 상태에 따라 로봇 순위를 매기므로 하나의 미션이 여러 로봇에 걸칠 수 있음
- 카메라 프레임을 클라우드 API로 보내고 싶지 않다면 로컬 Ollama 비전 모델만으로 전부 실행 가능
- 2륜 AMR과 6 자유도 팔의 Gazebo 및 RViz 시뮬레이션이 CLI와 함께 제공되므로, 하드웨어가 없어도 전체 스택을 테스트할 수 있음
- 하드웨어 가이드가 차동 구동 섀시와 L298N부터 RealSense를 거쳐 에이전트가 조종할 수 있는 로봇까지 안내함
대상
- 어댑터를 쓰지 않고 Claude Code, Codex, Gemini에서 기존 로봇과 대화하고 싶은 ROS 2 사용자
- 부품으로 소형 차동구동 로봇을 만들면서 에이전트 계층을 처음부터 설계에 넣고 싶은 사람
- 하드코딩된 네임스페이스 대신 역량 기반 라우팅을 원하는 다중 로봇 운영 팀
- 비전 부분을 클라우드 API가 아니라 로컬 Ollama에서 돌려야 하는 개발자
- 무언가를 사기 전에 Gazebo에서 전체 스택을 먼저 시험해보고 싶은 취미 제작자
한계
- 2026년 3월 이후 기여자 1명, 커밋 70건 미만이다. 솜씨 있는 작업이지만 버스 팩터가 1이다
- 별 148개에 열린 이슈가 없다는 것은 지금까지 외부 사용이 거의 없었음을 시사한다
- GitHub 릴리스가 없다. 버전 관리는 npm 패키지에서만 이루어지며 현재 0.7.x다
- 로봇과 시뮬레이션 부분에는 ROS 2 Humble 또는 Jazzy가 필요하다. 즉 이것은 ROS로 가는 다리이지 ROS의 대안이 아니다
- OpenClaw가 대표 통합이며 설정 UI, 원격조작, 스킬 로더를 독점한다. 다른 어댑터는 더 얇다
- 자연어 플래너가 인식하는 것은 고정된 동사 어휘뿐이므로, 그 바깥의 것은 모두 명시적 단계 그래프로 써야 한다
- README의 기여 절이 클론 주소로 github.com/PlaiPin/agenticros를 가리키는데, 지금은 404를 반환한다
- 하드웨어 가이드는 저자 본인의 구매가를 담은 참조 구성이지 검증된 키트가 아니다. 부품표는 출발점으로 삼고 가격은 직접 다시 확인해야 한다