peaq Robotics

Core peaq-robotics-ros2 runtime for OpenClaw. Start/stop ROS 2 nodes and call DID, storage, and access-control services. Use when requests are about running...

Security Scan

The skill's code, runtime instructions, and required environment variables align with its stated purpose (running peaq ROS 2 nodes and calling DID/storage/access services); nothing requests unrelated credentials or external installers.

Purpose & Capability

Name/description match the actual footprint: the scripts start/stop ROS 2 nodes and call peaq services. Required binaries (ros2, python3) and PEAQ_ROS2_ROOT are expected for this functionality.

Instruction Scope

Runtime instructions and scripts stick to node lifecycle and service calls. The scripts do read JSON files and small local state/config (from the skill folder, PEAQ_ROS2_ROOT, and workspace .peaq_robot), inspect OPENCLAW-related environment hints (OPENCLAW_AGENT_ID/OPENCLAW_AGENT_DIR) for identity helpers, and run background processes via nohup. Those behaviors are documented in SKILL.md and constrained by validate_json_file_arg, but users should be aware the skill will access the local workspace and config files.

Install Mechanism

No installer or remote downloads. This is an instruction-only skill with included helper scripts — nothing is fetched from external URLs or written to system locations beyond its runtime-created log/pid dirs.

Credentials

Only PEAQ_ROS2_ROOT is required. Scripts also read optional env vars (PEAQ_ROS2_CONFIG_YAML, ROS_DOMAIN_ID, PEAQ_ROS2_LOG_DIR, OPENCLAW_*), all of which are reasonable for ROS/workspace management and documented in SKILL.md.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide settings. It will create logs and pid files under ~/.peaq_ros2 by default and can run background processes; those are normal for a runtime helper.

Assessment

This skill appears to do what it says, but review these before installing: (1) Ensure ROS 2 and the peaq-robotics-ros2 workspace are already installed and trusted, and set PEAQ_ROS2_ROOT correctly. (2) The skill will start/stop processes and create logs/pid files (default: ~/.peaq_ros2); expect background ros2 nodes when you invoke start commands. (3) JSON file inputs using @path are restricted to the skill folder, PEAQ_ROS2_ROOT, or workspace .peaq_robot — confirm those locations contain only files you trust. (4) The skill will read optional env vars (PEAQ_ROS2_CONFIG_YAML, OPENCLAW_AGENT_*), so avoid exposing secrets via those variables. (5) The skill does not perform value transfers, but it will report a funding-request line (informational). If you need the skill to run autonomously without prompts, be mindful that model invocation is enabled by default; otherwise invocation must be user-triggered.

peaq-robotics (Core)

What this skill is

Use this skill when a machine already has a working peaq-robotics-ros2 workspace and you want OpenClaw to run core ROS 2 nodes and call peaq services:

• DID create/read
• Storage add/read
• Access role/permission operations

What this skill intentionally does NOT do

To keep this skill low-risk and easier to approve in registries, core excludes:

• repo clone/build automation
• value transfer commands
• tether wallet operations
• runtime expansion of trusted setup/json roots via env overrides

If you need install/bootstrap/funding automation, use the companion admin skill (peaq-robotics-admin).

Required prerequisites

Before using core commands, make sure these are already true:

• ROS 2 is installed and ros2 works.
• peaq-robotics-ros2 workspace is already present and built.
• PEAQ_ROS2_ROOT points to that repo.
• Config YAML exists (either:
  • set PEAQ_ROS2_CONFIG_YAML, or
  • use default <PEAQ_ROS2_ROOT>/peaq_ros2_examples/config/peaq_robot.yaml).
• ROS environment is already initialized externally for the current shell/session.

Manual setup guide (no installer script required)

Do the repo clone/build/config steps manually outside this skill using upstream peaq-robotics-ros2 docs, then set env for OpenClaw runtime:

export PEAQ_ROS2_ROOT="$HOME/peaq-robotics-ros2"
# optional
export PEAQ_ROS2_CONFIG_YAML="$HOME/peaq-robotics-ros2/peaq_ros2_examples/config/peaq_robot.yaml"

If users want their own custom helper script

Tell them to create their own wrapper with only required setup and explicit config:

#!/usr/bin/env bash
set -euo pipefail
ros2 run peaq_ros2_core core_node --ros-args -p config.yaml_path:="$PEAQ_ROS2_CONFIG_YAML"

They can then run this directly, or still use this skill's commands for service calls.

Core commands

Node lifecycle:

• {baseDir}/scripts/peaq_ros2.sh core-start
• {baseDir}/scripts/peaq_ros2.sh core-configure
• {baseDir}/scripts/peaq_ros2.sh core-activate
• {baseDir}/scripts/peaq_ros2.sh core-stop

Identity:

• {baseDir}/scripts/peaq_ros2.sh did-create
• {baseDir}/scripts/peaq_ros2.sh did-create '{"type":"robot"}'
• {baseDir}/scripts/peaq_ros2.sh did-create @/path/to/file.json
• {baseDir}/scripts/peaq_ros2.sh did-read

Storage:

• {baseDir}/scripts/peaq_ros2.sh store-add sensor_data '{"temp":25.5}' FAST
• {baseDir}/scripts/peaq_ros2.sh store-read sensor_data

Access control:

• {baseDir}/scripts/peaq_ros2.sh access-create-role operator 'Robot operator'
• {baseDir}/scripts/peaq_ros2.sh access-create-permission move_robot
• {baseDir}/scripts/peaq_ros2.sh access-assign-permission move_robot operator
• {baseDir}/scripts/peaq_ros2.sh access-grant-role operator did:peaq:<address>

Identity card helpers:

• {baseDir}/scripts/peaq_ros2.sh identity-card-json [name] [roles_csv] [endpoints_json] [metadata_json]
• {baseDir}/scripts/peaq_ros2.sh identity-card-did-create [name] [roles_csv] [endpoints_json] [metadata_json]
• {baseDir}/scripts/peaq_ros2.sh identity-card-did-read

Funding request (message template only, no transfer):

• {baseDir}/scripts/peaq_ros2.sh fund-request [amount] [reason]

Behavior and safety notes

• This skill does not source ROS setup scripts itself; environment initialization must be done externally.
• @/path/file.json inputs are restricted to built-in roots:
  • skill folder
  • PEAQ_ROS2_ROOT
  • workspace .peaq_robot
• JSON arguments are parsed/validated before ROS 2 service calls.
• Service payloads are passed as JSON objects to ros2 service call (no shell YAML interpolation).

One-line human prompts

• "Start peaq robotics core and create my DID. If I need funds, give me a one-line funding request."
• "Read my DID, store this JSON as agent_state, then read it back."
• "Create role operator, create permission move_robot, assign it, and show the response."

Deep reference

For full service names and fields, see:

• references/peaq_ros2_services.md