Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

The Danger tab does two things. First, it’s the single place where you can see everything about an agent — every secret attached, every skill installed, every channel configured, every snapshot CID. It’s also where you’ll find restart, settings edit, and delete. The name is mostly about the buttons at the bottom — Restart Gateway is disruptive, Delete is permanent. But it’s also the page you’ll open most often when you’re answering “how is this agent actually configured?”

​
Layout

Two big sections.
  • General — agent details, workspace state, lifecycle scripts, channels, skills, devices, secrets. One row at a time.
  • Actions — three buttons: Restart Gateway, OpenClaw Settings UI, Delete This Agent.

​
Agent details

The first block in General is the agent itself:
FieldWhat it is
Agent IDThe unique slug used in URLs and API calls (e.g. x0i33jye)
Statusstarting, running, or not_running
NameWhat you named it
EngineThe container engine — openclaw (default) or hermes
VersionEngine version. Change lets you bump it.
ConfigPath to openclaw.json inside the container. Edit opens an editor.
Gateway TokenThe credential used to authenticate against the agent’s own subdomain. See API → Gateway token.
CreatedWhen the agent was created
Base URLhttps://{agentId}.agents.pinata.cloud
The manifest.json schema link at the top of this section jumps to the full field reference.

​
Workspace

FieldWhat it shows
PathThe workspace directory inside the container (default /home/node/clawd/workspace)
Snapshot CIDIPFS CID of the most recent synced snapshot
Last SyncHow recently the workspace was captured
For diffs and restore, use the Files tab.

​
Lifecycle Scripts

Whether your build and start scripts are configured, and their current status. The states are self-explanatory: Not configured, pending, running, success, failed. If something failed, use the OpenClaw Settings UI action or POST /v0/agents/{agentId}/scripts/retry to re-run the lifecycle. Logs end up in /tmp/user-build.log and /tmp/user-start.log — see Manifest → Scripts for the details.

​
Scheduled Tasks

Just a status summary. Manage them on the Tasks tab.

​
Channels

A quick rollup — for each of Telegram, Slack, Discord, and WhatsApp, you’ll see either Enabled or Not configured.

​
Skills

Every attached skill, its installed version, and its IPFS CID. The same info as the Skills tab, in a flat-list format.

​
Devices

Clients paired with the agent — mobile, the CLI, browser sessions. Each is listed with its status (paired, pending) and last activity.

​
Device pairing

Some clients (the CLI in particular) need to be approved before they can talk to the agent. The flow:
  1. The client asks to pair. A pending entry appears in this list.
  2. You approve it — either click Approve here or hit POST /v0/agents/{agentId}/devices/{requestId}/approve.
  3. To approve everything pending at once: POST /v0/agents/{agentId}/devices/approve-all.

​
Secrets

Every attached secret, with a Synced indicator that tells you whether the running gateway has picked up the latest value. If you updated a secret and the indicator says out of sync, restart the gateway.

​
Actions

​
Restart Gateway

Restarts the gateway process inside the container. Use it when:
  • You changed a secret, skill, or channel and want the agent to actually pick it up
  • The agent is misbehaving
  • WebSocket connections look stuck
Restarting disconnects all clients (chat, channel bots, custom domain traffic) for a minute or two.
From the API: 
curl -X POST \
  -H "Authorization: Bearer $PINATA_JWT" \
  https://agents.pinata.cloud/v0/agents/$AGENT_ID/restart

​
OpenClaw Settings UI

Opens OpenClaw’s internal settings panel. This is a low-level config editor for the engine itself — useful for advanced debugging.
Misconfiguration here can break the agent. For day-to-day config, edit manifest.json instead. See the manifest reference.

​
Edit config

The Edit button next to the Config row opens openclaw.json directly. Changes are validated server-side before they’re written. You can also validate any config string without applying it: 
curl -X POST \
  -H "Authorization: Bearer $PINATA_JWT" \
  -H "Content-Type: application/json" \
  -d '{"config":"{...}"}' \
  https://agents.pinata.cloud/v0/agents/$AGENT_ID/config/validate
This validates openclaw.json (the runtime config), not manifest.json. For manifest validation, see Manifest → Validation.

​
Update OpenClaw

The Change button next to the Version field checks for updates and applies them. Equivalent CLI calls: 
# Check
curl -H "Authorization: Bearer $PINATA_JWT" \
  https://agents.pinata.cloud/v0/agents/$AGENT_ID/update

# Apply
curl -X POST \
  -H "Authorization: Bearer $PINATA_JWT" \
  -H "Content-Type: application/json" \
  -d '{"tag":"latest"}' \
  https://agents.pinata.cloud/v0/agents/$AGENT_ID/update

​
Delete Agent

Permanent. Removes:
  • The container
  • All workspace files and snapshots
  • All R2 storage tied to the agent
  • Channel configurations
  • Custom domains
There’s no undo. The agent ID is gone — it won’t be reissued.