Operate ReClaw from the CLI, API, or agent skill.

The docs below give agents and operators the stable, machine-readable entry points ORA could not discover.

Overview

ReClaw creates encrypted restore points for OpenClaw workspaces. The CLI captures local OpenClaw state, encrypts the archive before upload, and stores ciphertext with restore metadata in the ReClaw API.

The dashboard is for human operators. The CLI, OpenAPI document, markdown docs, and agent skill are the supported surfaces for automation.

Install

Install or update the managed CLI from the public installer:

curl -fsSL https://reclaw.io/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
reclaw --version

The installer also ships the ReClaw Backup Operator skill for OpenClaw.

Backup Flow

Initialize a vault, create a restore point, and verify the ledger:

reclaw backup bootstrap
reclaw backup create --label "Before risky change"
reclaw backup list --json
reclaw backup show <backup-id> --decrypt-metadata

ReClaw stores encrypted metadata and ciphertext. It never receives the backup passphrase.

Restore Flow

Restore downloads, decrypts, and optionally verifies an archive. It does not invent or execute OpenClaw import commands.

reclaw backup restore <backup-id> \
  --verify \
  --output /safe/path/archive.tar.gz

Operating Guides

Auth

Browser sessions are for dashboard use. API keys are for CLI and agent use. Send keys with Authorization: Bearer <key> or x-api-key: <key>.

Backup API keys can be scoped to backups:read, backups:write, and backups:restore.

Rate Limits And Errors

Backup creation is cadence-limited by plan. Free allows one backup per day, Plus allows one every four hours, and Pro allows one every thirty minutes.

Errors are structured JSON:

{
  "error": "Backup cadence limit reached.",
  "code": "rate_limited",
  "message": "Backup cadence limit reached.",
  "resolution": "Wait until the Retry-After value or details.nextAllowedAt before retrying.",
  "details": {
    "nextAllowedAt": "2026-04-30T12:00:00.000Z"
  }
}

Streaming Progress

Agents can receive progress feedback for a backup with the SSE status stream. Use it while uploads and finalization are in progress instead of waiting only for a final response.

curl -N \
  -H "Accept: text/event-stream" \
  -H "Authorization: Bearer $RECLAW_TOKEN" \
  https://reclaw.io/api/backups/<backup-id>/events