> ## 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.

# Danger

> Full agent inventory, plus restart and delete

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:

| Field             | What it is                                                                                                                   |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Agent ID**      | The unique slug used in URLs and API calls (e.g. `x0i33jye`)                                                                 |
| **Status**        | `starting`, `running`, or `not_running`                                                                                      |
| **Name**          | What you named it                                                                                                            |
| **Engine**        | The container engine — `openclaw` (default) or `hermes`                                                                      |
| **Version**       | Engine version. **Change** lets you bump it.                                                                                 |
| **Config**        | Path to `openclaw.json` inside the container. **Edit** opens an editor.                                                      |
| **Gateway Token** | The credential used to authenticate against the agent's own subdomain. See [API → Gateway token](/agents/api#gateway-token). |
| **Created**       | When the agent was created                                                                                                   |
| **Base URL**      | `https://{agentId}.agents.pinata.cloud`                                                                                      |

The **manifest.json schema** link at the top of this section jumps to the [full field reference](/agents/manifest).

## Workspace

| Field            | What it shows                                                                       |
| ---------------- | ----------------------------------------------------------------------------------- |
| **Path**         | The workspace directory inside the container (default `/home/node/clawd/workspace`) |
| **Snapshot CID** | IPFS CID of the most recent synced snapshot                                         |
| **Last Sync**    | How recently the workspace was captured                                             |

For diffs and restore, use the [Files](/agents/snapshots) 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](/agents/manifest#scripts) for the details.

## Scheduled Tasks

Just a status summary. Manage them on the [Tasks](/agents/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](/agents/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.

<a id="device-pairing" />

### 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

<Warning>
  Restarting disconnects all clients (chat, channel bots, custom domain traffic) for a minute or two.
</Warning>

From the API:

```bash theme={null}
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.

<Warning>
  Misconfiguration here can break the agent. For day-to-day config, edit `manifest.json` instead. See the [manifest reference](/agents/manifest).
</Warning>

### 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:

```bash theme={null}
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](/agents/manifest#validation).

### Update OpenClaw

The **Change** button next to the Version field checks for updates and applies them. Equivalent CLI calls:

```bash theme={null}
# 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

<Warning>
  There's no undo. The agent ID is gone — it won't be reissued.
</Warning>