# Send peaq Robotics to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "peaq-robotics",
    "name": "peaq Robotics",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/lavish0000/peaq-robotics",
    "canonicalUrl": "https://clawhub.ai/lavish0000/peaq-robotics",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/peaq-robotics",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=peaq-robotics",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/peaq_ros2.sh",
      "scripts/lib/utils.sh",
      "scripts/lib/nodes.sh",
      "scripts/lib/wallet.sh",
      "scripts/lib/env.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/peaq-robotics"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/peaq-robotics",
    "downloadUrl": "https://openagent3.xyz/downloads/peaq-robotics",
    "agentUrl": "https://openagent3.xyz/skills/peaq-robotics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/peaq-robotics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/peaq-robotics/agent.md"
  }
}
```
## Documentation

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lavish0000
- Version: 0.1.7
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/peaq-robotics)
- [Send to Agent page](https://openagent3.xyz/skills/peaq-robotics/agent)
- [JSON manifest](https://openagent3.xyz/skills/peaq-robotics/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/peaq-robotics/agent.md)
- [Download page](https://openagent3.xyz/downloads/peaq-robotics)