Agent Ros Bridge
Universal ROS1/ROS2 bridge for AI agents to control robots and embodied intelligence systems.
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- Install using `clawhub skill install kn7865tvdsqd9pjav1n98at3qn80w4ws:agent-ros-bridge` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- 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.**
[](https://github.com/webthree549-bot/agent-ros-bridge/actions/workflows/ci.yml)
[](https://pypi.org/project/agent-ros-bridge/)
[](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: falseconfig/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: 9090config/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
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!
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
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.
