← Back to Skills Marketplace
peaq Robotics
by
Lovish Arora
· GitHub ↗
· v0.1.7
1760
Downloads
5
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install peaq-robotics
Description
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...
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: peaq-robotics
Version: 0.1.7
The skill is designed with strong security controls, explicitly limiting its scope to interacting with a pre-existing peaq-robotics-ros2 environment without handling installation or value transfers. It implements robust input validation, restricts file access for `@json_file` arguments to predefined safe roots (skill folder, PEAQ_ROS2_ROOT, workspace .peaq_robot), and uses `subprocess.run` with argument lists in Python to prevent shell injection when calling `ros2` commands. No evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation was found. The SKILL.md is transparent about its capabilities and limitations, and does not contain prompt injection attempts.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install peaq-robotics - After installation, invoke the skill by name or use
/peaq-robotics - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.7
Version 0.1.7
- Removed legacy configuration helper script: scripts/lib/config.sh.
- Updated documentation to clarify that ROS environment setup is now required externally; the skill no longer sources ROS setup scripts.
- Updated prerequisites and safety notes to remove references to auto-created workspace-local config and sourcing setup scripts.
- Funding command information in documentation now only refers to message template, not balance checking.
v0.1.6
peaq-robotics 0.1.6
- Split skill responsibilities for security and clarity: this core skill is now runtime-only and excludes install/build/funding automation.
- Removed installer script (`scripts/lib/install.sh`). All manual setup and admin flows are now handled outside this skill (see `peaq-robotics-admin` for install/bootstrap commands).
- Updated description and metadata to clarify core focus: running nodes and calling DID, storage, and access-control services only.
- Prerequisites, setup, and command documentation overhauled to cover only essential runtime usage.
- All risky or value-transfer features (funding, tether, trusted root/env expansion) removed for registry safety.
v0.1.5
peaq-robotics 0.1.5
- Added metadata block specifying required binaries (`ros2`, `colcon`, `python3`, `git`) and required environment variable (`PEAQ_ROS2_ROOT`) for OpenClaw integration.
- Clarified that `PEAQ_ROS2_ROOT` is now required and declared in metadata; `PEAQ_ROS2_CONFIG_YAML` is now optional.
- Updated documentation to describe new runtime environment variable requirements and explicit value-transfer enable flag (`PEAQ_ROS2_ENABLE_TRANSFERS=1`).
- No code or logic changes; documentation and metadata enhancements only.
v0.1.4
No user-facing changes; documentation cleanup only.
- Clarified setup script trust-roots instruction.
- Improved wording and formatting in install instructions.
- No new features, commands, or interface changes.
v0.1.3
peaq-robotics 0.1.3
- Improved security and flexibility during installation: setup scripts are now restricted to trusted roots by default, with override options (`PEAQ_ROS2_TRUSTED_SETUP_ROOTS`, `PEAQ_ROS2_TRUST_SETUP_OVERRIDES`).
- Transfers (fund and tether USDT) are now disabled by default for safety; enable explicitly via `PEAQ_ROS2_ENABLE_TRANSFERS=1` to allow value transfers.
- Documentation updated to specify the new defaults and environment variable requirements.
- No code changes; documentation only.
v0.1.2
peaq-robotics 0.1.2
- Improved installer safety: now only accepts existing git clones if the origin is the official peaqnetwork/peaq-robotics-ros2 repo.
- The installer no longer patches or alters upstream source files, ensuring reproducible installs.
- Added guidance to pin a known tag or commit for deterministic installations.
- No code changes; documentation was updated and clarified for install-related steps.
v0.1.1
Hardening pass: installer only clones official peaqnetwork repo; removed auto agent-to-agent send; wallet secret no longer passed via command line args; docs updated for container-friendly sandbox usage.
v0.1.0
peaq-robotics 0.1.0 – Initial Release
- Introduces skill to control peaq-robotics-ros2 from OpenClaw, including starting ROS 2 nodes and calling services for identity (DID), storage, access control, and USDT tethering.
- Provides detailed install and onboarding instructions for agents (shared host, per-workspace, or remote/ClawHub).
- Supports environment variable configuration, network pinning with fallbacks, and wallet path overrides.
- Implements bootstrap funding flows, agent onboarding, and step-by-step guidance for funding requests and transfers.
- Adds identity card creation and reading linked to DIDs for agent contact records.
- Includes templates and scripts for common workflows such as funding requests, agent-to-agent messaging, and ROS 2 node management.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 1760 downloads so far.
How do I install peaq Robotics?
Run "/install peaq-robotics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is peaq Robotics free?
Yes, peaq Robotics is completely free (open-source). You can download, install and use it at no cost.
Which platforms does peaq Robotics support?
peaq Robotics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created peaq Robotics?
It is built and maintained by Lovish Arora (@lavish0000); the current version is v0.1.7.
More Skills