agentCLAWHUBUnverified

Agent Ros Bridge

Universal ROS1/ROS2 bridge for AI agents to control robots and embodied intelligence systems.

OpenClaw

Rank

62

Safety

84

Downloads

624

Updated

Apr 15, 2026

Version

0.3.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 624 downloads reported by the source. Last updated 4/15/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Apr 15, 2026
Protocol compatibility
OpenClawcompatibility · observed Apr 15, 2026
Adoption signal
624 downloadsadoption · observed Apr 15, 2026
Latest release
0.3.4release · observed Feb 21, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn7865tvdsqd9pjav1n98at3qn80w4ws:agent-ros-bridge
  1. Install using `clawhub skill install kn7865tvdsqd9pjav1n98at3qn80w4ws:agent-ros-bridge` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-kn7865tvdsqd9pjav1n98at3qn80w4ws-agent-ros-bridge/snapshot"

Documentation

CLAWHUB

48,744 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: agent-ros-bridge
version: 0.3.2
description: Universal ROS1/ROS2 bridge for AI agents to control robots and embodied intelligence systems.
author: Agent ROS Bridge Team
homepage: https://github.com/webthree549-bot/agent-ros-bridge
repository: https://github.com/webthree549-bot/agent-ros-bridge.git
license: MIT
metadata:
  {
    "openclaw":
      {
        "emoji": "🤖",
        "requires": { "bins": ["python3"], "env": ["JWT_SECRET"] },
        "suggests": { "bins": ["docker"] },
        "env":
          {
            "JWT_SECRET":
              {
                "description": "Required: Secret key for JWT authentication. Bridge will fail to start without this.",
                "sensitive": true,
                "required": true,
              },
            "BRIDGE_HOST":
              {
                "description": "Optional: Bind address (default: 127.0.0.1 for security)",
                "sensitive": false,
                "required": false,
              },
          },
        "security":
          {
            "notes": "SECURITY-FIRST DESIGN: JWT authentication is always required and cannot be disabled. All examples run in Docker containers for isolation. Never expose to public networks without TLS and firewall rules.",
          },
        "install":
          [
            {
              "id": "pip",
              "kind": "pip",
              "package": "agent-ros-bridge",
              "label": "Agent ROS Bridge from PyPI",
            },
            {
              "id": "docker",
              "kind": "manual",
              "label": "Docker Desktop (optional but recommended)",
              "instruction": "For running examples in isolated containers. Install from https://www.docker.com/products/docker-desktop",
            },
          ],
        "category": "robotics",
        "tags": ["ros", "ros2", "robotics", "iot", "automation", "bridge", "embodied-intelligence", "arm", "navigation"],
      },
  }

---

# 🤖 Agent ROS Bridge

**Universal ROS1/ROS2 bridge for AI agents to control robots and embodied intelligence systems.**

[![CI](https://github.com/webthree549-bot/agent-ros-bridge/actions/workflows/ci.yml/badge.svg)](https://github.com/webthree549-bot/agent-ros-bridge/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/agent-ros-bridge.svg)](https://pypi.org/project/agent-ros-bridge/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

---

## 🔐 Security-First Design

**JWT authentication is always required and cannot be disabled.**

```bash
# Generate a secure secret (REQUIRED - no exceptions)
export JWT_SECRET=$(openssl rand -base64 32)
```

The bridge will **fail to start** without JWT_SECRET. This is by design — security is not optional.

See [SECURITY.md](SECURITY.md) for complete security guidelines.

---

## Quick Start

### Option 1: Docker Examples (Recommended for Testing)

All examples run in isolated Docker containers with simulated robo

_meta.json

{
  "ownerId": "kn7865tvdsqd9pjav1n98at3qn80w4ws",
  "slug": "agent-ros-bridge",
  "version": "0.3.4",
  "publishedAt": 1771639355034
}

config/bridge-auth.yaml

# Agent ROS Bridge Configuration with Authentication Enabled

bridge:
  name: "agent_ros_bridge"
  
  transports:
    websocket:
      port: 8766
      host: "0.0.0.0"
      auth:
        enabled: true
        jwt_secret: "8GpxD7Zp6L6bGl_bHbzLmNNaEpyKE3Sh1xEzO-dJfAo"
        jwt_expiry_hours: 24
        api_keys:
          "ak_test123":
            user_id: "test_user"
            roles: ["operator"]
  
  connectors:
    ros:
      auto_detect: false
      endpoints: []

  security:
    enabled: false
  
  telemetry:
    enabled: false

config/bridge.yaml

# Agent ROS Bridge Configuration
# Supports multiple ROS1/ROS2 endpoints (local and remote)

bridge:
  name: "agent_ros_bridge"
  
  transports:
    websocket:
      port: 8765
      host: "0.0.0.0"
      # Authentication settings
      auth:
        enabled: false  # Set to true to enable JWT/API key auth
        jwt_secret: null  # Set via JWT_SECRET env var
        jwt_expiry_hours: 24
        api_keys: {}
          # Example API keys:
          # "ak_1234567890abcdef":
          #   user_id: "dashboard"
          #   roles: ["operator"]
          # "ak_0987654321fedcba":
          #   user_id: "viewer"
          #   roles: ["viewer"]
  
  connectors:
    ros:
      # Auto-detect local ROS if no endpoints configured
      auto_detect: true
      
      # Multiple ROS endpoints (local + remote)
      # Uncomment and configure for mixed ROS1/ROS2 environments
      endpoints: []
        # Example 1: Local ROS2
        # - id: "local_ros2"
        #   ros_type: "ros2"
        #   ros_distro: "jazzy"
        #   host: "localhost"
        #   domain_id: 0
        #   auto_discover: true
        
        # Example 2: Local ROS1
        # - id: "local_ros1"
        #   ros_type: "ros1"
        #   ros_distro: "noetic"
        #   host: "localhost"
        #   port: 11311
        #   auto_discover: true
        
        # Example 3: Remote ROS2 robot
        # - id: "warehouse_bot_01"
        #   ros_type: "ros2"
        #   ros_distro: "humble"
        #   host: "192.168.1.100"
        #   domain_id: 42
        #   auto_discover: true
        #   topics:
        #     - "/cmd_vel"
        #     - "/odom"
        #     - "/scan"
        
        # Example 4: Dual ROS1 + ROS2
        # - id: "legacy_arm"
        #   ros_type: "ros1"
        #   ros_distro: "noetic"
        #   host: "arm-robot.local"
        # - id: "new_base"
        #   ros_type: "ros2"
        #   ros_distro: "humble"
        #   host: "mobile-base.local"
        #   domain_id: 0

  security:
    enabled: false
  
  telemetry:
    enabled: true
    metrics_port: 9090

config/debug_config.yaml

# Debug Config
logging:
  level: "INFO"
  console_logging: true
  log_format: "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
  date_format: "%Y-%m-%d %H:%M:%S"
monitoring:
  metrics: ["cpu", "memory", "latency"]
  realtime_dashboard: true
debug:
  mock_mode_default: false
Github ReposUpdated 9h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceUrl": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-kn7865tvdsqd9pjav1n98at3qn80w4ws-agent-ros-bridge/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kn7865tvdsqd9pjav1n98at3qn80w4ws-agent-ros-bridge/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "624 downloads",
      "href": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceUrl": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.3.4",
      "href": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceUrl": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-21T02:02:35.034Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-kn7865tvdsqd9pjav1n98at3qn80w4ws-agent-ros-bridge/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kn7865tvdsqd9pjav1n98at3qn80w4ws-agent-ros-bridge/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.3.4",
      "description": "- Major cleanup: removed 33 files including all example scripts, documentation (README.md, SECURITY.md, etc.), and dashboards. - Added new configuration files for various components (e.g., debug_config.yaml, fault_config.yaml, hal_config.yaml, openclaw_config.yaml, ros1_config.yaml, ros2_config.yaml, global_config.yaml). - Modified internal package structure and initialization files. - SKILL.md updated: reverted version and metadata to earlier state (from 0.3.3 to 0.3.2), and removed extended documentation.",
      "href": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceUrl": "https://clawhub.ai/kn7865tvdsqd9pjav1n98at3qn80w4ws/agent-ros-bridge",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-21T02:02:35.034Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to Agent Ros Bridge and adjacent AI workflows.