AgenticROS
ROS 2 ロボットに共通の MCP ツール面を与える、エージェント非依存のブリッジ
ライセンス
Apache-2.0
概要
AgenticROS は、最先端のエージェントランタイムと ROS 2 をつなぐ変換レイヤーです。ロボットは型付きの動詞(drive_base、take_snapshot、measure_depth、find_object、follow_person に加え、スキルパッケージが追加するもの)を公開し、対応するすべてのエージェントが同じ一覧を参照するため、エージェントは生のトピックではなく能力に基づいて計画を立てます。1 つの MCP サーバーが Claude Code、Claude Desktop、Claude Dispatch、Codex CLI、Hermes、Google の Antigravity CLI に対応し、OpenClaw プラグインは Web UI、遠隔操作、メッセージングチャネルを追加します。Gemini CLI は MCP を一切使わず関数呼び出しを用います。run_mission ツールは、あるステップの出力が次のステップにテンプレートとして渡される宣言型のステップグラフを実行し、ルールベースのプランナーが平易な英語の目標を、ループ内にモデルを必要とせずにそのグラフへコンパイルします。
他の MCP-to-ROS ブリッジと分けるのは、接続そのものではなく契約です。多くは ROS のトピックとサービスをそのまま公開し、/cmd_vel をどう使うかはモデルに委ねます。AgenticROS はケイパビリティマニフェスト──型付き入力を持つ名前付き動詞で、そのまま ACP / A2A のエージェントカードとしても使える形──を定義し、どのアダプタも同じマニフェストを提示します。実務上の帰結として、異なるベンダーのスタック上にある 2 つのエージェントが同じロボットを運転し、同じ方言を話せます。一方のために書かれたミッションが、もう一方でもそのまま動くのです。
ミッション実行系はスター数から想像されるより練られています。run_mission は {id, capability, inputs, on_fail} からなるステップグラフを受け取り、出力は {{stepId.outputs.field}} 参照で前方へ流れるため、検出結果がそのまま次の移動指令へ接続され、糊のコードが要りません。フリート照会(ケイパビリティ・機種・オンライン状態で絞り込む ros2_find_robots_for、背後には 1 Hz のハートビートトピック)により、1 つのミッションが異なるステップを異なるロボットへ振り分けられます。キャンセルはステップ境界で確認されるトークンを反転させ、共有メモリバックエンドが有効なら各ステップが長期記憶へ書き込まれるため、別プロセスの別エージェントが何が起きたかを想起して作業を引き継げます。
自然言語プランナーについては正確に述べておく価値があります。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 を publish するところまで。エージェント型ロボットについて読むところから実際に一台所有するまでの道筋が、端から端まで文書化されています。
解決する課題
AI エージェントを ROS 2 ロボットに向けるには、通常そのエージェントとそのロボット専用のツール面を書く必要があり、次の組み合わせでは一からやり直しになります。AgenticROS は型付きのケイパビリティ契約を間に挟むため、ロボットを一度記述すれば Claude、Codex、Gemini、Hermes、OpenClaw のすべてが同じ動詞と同じミッションでそれを運転できます。
主なポイント
- 1 つの能力マニフェスト(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 のハートビートトピックをもとに能力、種類、オンライン状態でロボットを順位付けし、1 つのミッションで複数のロボットを扱える
- カメラ映像をクラウド 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 でオープンな issue がゼロという状態は、外部での利用がこれまでごく少なかったことを示唆する
- GitHub のリリースはなく、バージョン管理は npm パッケージ上でのみ行われている(現在 0.7.x)
- ロボットとシミュレーションの部分には ROS 2 Humble または Jazzy が必須であり、これは ROS への橋であって ROS の代替ではない
- OpenClaw が旗艦統合であり、設定 UI・遠隔操作・スキルローダーを独占している。他のアダプタはより薄い
- 自然言語プランナーが認識するのは固定の動詞語彙のみで、それ以外はすべて明示的なステップグラフとして書く必要がある
- README の contributing 節はクローン先として github.com/PlaiPin/agenticros を示しているが、現在は 404 を返す
- ハードウェアガイドは著者自身の購入価格による参考構成であり、検証済みキットではない。部品表は出発点として扱い、価格は各自で取り直すべき