Manage Devices in OpenClaw

From the OpenClaw cheat sheet · Device Pairing & Scopes · verified Jul 2026

Manage Devices

List, approve, and clear paired devices.

bash
# List paired and pending devices
openclaw devices list

# Approve a pending device by request ID
openclaw devices approve <request-id>

# Clear all pairing state (nuclear reset)
openclaw devices clear --yes

# Restart gateway after pairing changes
openclaw gateway restart
💡 WebSocket close code 1008 in gateway logs means a device needs scope approval
⚡ The "repair" flag on a pending request means an existing device is requesting upgraded scopes
📌 If "devices approve" fails with "unknown requestId" in local mode, manually edit paired.json
🟢 Always restart the gateway after approving or clearing devices
devicespairingscopes
Back to the full OpenClaw cheat sheet