ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

ros2-introspection

Execute core ROS 2 introspection commands to query the ROS graph (topics, nodes, services, actions, parameters). STRICTLY read-only.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/bigrobinson/ros2-introspection
Or

ROS 2 Introspection (Sandboxed)

Setup & Installation

Before this skill can be used, the local environment must be configured.

  1. Source your environment: You MUST source your ROS 2 environment first in your terminal. 
    source /opt/ros/<distro>/setup.bash
  2. Run setup: 
    ./scripts/setup.sh

Overview

Use this skill to inspect the ROS 2 graph. It is STRICTLY read-only. You cannot use this skill to run nodes, call services, or send action goals (use ros2-execution for that).

SECURITY CONSTRAINT: You must ALWAYS use the safe wrapper script located at ./scripts/safe_ros2_introspection.py. This Python script uses subprocess (shell=False) to prevent command injection and validates the command against a strict allowlist.

Wrapper Path: Resolve ./scripts/safe_ros2_introspection.py against this SKILL.md directory.

Allowed Commands

Usage: ./scripts/safe_ros2_introspection.py <category> <subcmd> [args]

  • Topics:
    • ./scripts/safe_ros2_introspection.py topic list
    • ./scripts/safe_ros2_introspection.py topic info <topic>
    • ./scripts/safe_ros2_introspection.py topic echo <topic>
    • ./scripts/safe_ros2_introspection.py topic hz <topic>
    • ./scripts/safe_ros2_introspection.py topic bw <topic>
  • Nodes:
    • ./scripts/safe_ros2_introspection.py node list
    • ./scripts/safe_ros2_introspection.py node info <node>
  • Services:
    • ./scripts/safe_ros2_introspection.py service list
    • ./scripts/safe_ros2_introspection.py service type <srv>
    • ./scripts/safe_ros2_introspection.py service find <type>
  • Actions:
    • ./scripts/safe_ros2_introspection.py action list
    • ./scripts/safe_ros2_introspection.py action info <action>
  • Parameters:
    • ./scripts/safe_ros2_introspection.py param list
    • ./scripts/safe_ros2_introspection.py param get <node> <param>
    • ./scripts/safe_ros2_introspection.py param dump <node>
  • Interfaces:
    • ./scripts/safe_ros2_introspection.py interface show <type>
  • RQT:
    • ./scripts/safe_ros2_introspection.py rqt_graph
Read Full Documentation on GitHub

Metadata

Author@bigrobinson
Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-bigrobinson-ros2-introspection": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

ros2-control-introspection

Execute ROS 2 Control read-only introspection commands (list, view) in a sandboxed environment. Supports parameter profiles.

bigrobinson 4473

ros2-control-execution

Execute ROS 2 Control state-changing commands (load, switch, unload) in a sandboxed environment. Supports parameter profiles.

bigrobinson 4473

ros2-execution

Execute ROS 2 commands (run, launch, call) in a sandboxed, allowlisted environment. Supports parameter profiles.

bigrobinson 4473