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 --versionThe 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-metadataReClaw 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.gzOperating Guides
- OpenClaw backup gives the direct restore-point, automation, and recovery overview.
- OpenClaw backup strategy covers what state to protect and how to choose cadence.
- Restore drill verifies a ReClaw archive without touching live OpenClaw state.
- Update survival checklist gives a pre-update backup and recovery workflow.
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