Documentation

Everything you need to back up your agent's soul. Instructions for both agents and humans.

On this page

Getting Started

Step-by-step setup for agents (and the humans who configure them).

  1. Human signs up and pays at keepmyclaw.com
  2. Human receives an API key via email or dashboard
  3. Agent installs the clawkeeper skill — or follows the manual setup below
  4. Agent configures: API key, agent name, and encryption passphrase
  5. Agent runs first backup to verify everything works

Recommended: Use the clawkeeper skill for automated backups. It handles encryption, scheduling, and restore for you. Manual instructions below are for agents without skill support.

API Reference

Base URL: https://api.keepmyclaw.com

Authentication: Include Authorization: Bearer <api_key> in all requests.

Endpoints

Method Endpoint Description
POST /v1/agents/:name/backups Upload encrypted backup. Body = raw bytes. Set Content-Type: application/octet-stream.
GET /v1/agents/:name/backups List all snapshots for an agent. Returns JSON array of snapshot objects.
GET /v1/agents/:name/backups/:id Download a snapshot. Use latest as :id for the most recent.
DELETE /v1/agents/:name/backups/:id Delete a specific snapshot.
GET /v1/agents List all agents under this account.
GET /v1/account Account info, usage stats, and storage remaining.

Error Codes

401
Unauthorized — invalid or missing API key
403
Forbidden — LIMIT_EXCEEDED (storage or snapshot limit reached)
404
Not found — agent or snapshot doesn't exist
413
Payload too large — backup exceeds maximum allowed size

Manual Backup

If you're not using the clawkeeper skill, run this to create and upload an encrypted backup:

# Create encrypted backup and upload in one command
tar czf - ~/.openclaw/workspace/ ~/.openclaw/openclaw.json ~/.openclaw/credentials/ | \
  openssl enc -aes-256-cbc -salt -pbkdf2 -iter 100000 -pass pass:YOUR_PASSPHRASE | \
  curl -X POST \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/octet-stream" \
    --data-binary @- \
    https://api.keepmyclaw.com/v1/agents/YOUR_AGENT_NAME/backups

What gets backed up: Your workspace (SOUL.md, memory, skills, projects), main config (openclaw.json), and credentials. Everything that makes your agent your agent.

Restore

Download and decrypt the latest backup to restore your agent's full state:

# Download latest backup, decrypt, and extract
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.keepmyclaw.com/v1/agents/YOUR_AGENT_NAME/backups/latest | \
  openssl enc -d -aes-256-cbc -pbkdf2 -iter 100000 -pass pass:YOUR_PASSPHRASE | \
  tar xzf - -C /

To restore a specific snapshot, replace latest with the snapshot ID from the list endpoint.

Scheduling Automatic Backups

Set up a cron job to back up your agent automatically. Example: daily at 3 AM.

# Edit crontab
crontab -e

# Add this line (daily at 3:00 AM)
0 3 * * * tar czf - ~/.openclaw/workspace/ ~/.openclaw/openclaw.json ~/.openclaw/credentials/ | \
  openssl enc -aes-256-cbc -salt -pbkdf2 -iter 100000 -pass pass:YOUR_PASSPHRASE | \
  curl -s -X POST -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/octet-stream" \
    --data-binary @- \
    https://api.keepmyclaw.com/v1/agents/YOUR_AGENT_NAME/backups

Tip: The clawkeeper skill handles scheduling for you, including smart backups that only trigger when files have actually changed.

For Humans

What you're paying for, in plain English.

What Gets Backed Up

Your OpenClaw agent builds up identity, memory, and skills over time — its SOUL.md, daily memory files, learned preferences, credentials, and workspace projects. If the machine dies, all of that is gone. Keep My Claw ensures it isn't.

Zero-Knowledge — We Can't See Your Data

Your agent encrypts everything before it leaves your machine using a passphrase only you and your agent know. What we store is an encrypted blob — meaningless without the key. We never see your agent's memories, credentials, or personality. We can't.

How to Get Started

  1. Sign up at keepmyclaw.com and choose a plan
  2. Get your API key from the dashboard
  3. Give the key to your agent — tell it to install the clawkeeper skill or configure manually
  4. Choose a passphrase — write it down somewhere safe. Lost passphrase = lost data.
  5. Your agent handles the rest — backups run automatically

Security

  • Client-side AES-256-CBC encryption with PBKDF2 key derivation (100,000 iterations)
  • We never see your data. Encryption happens on your machine before upload.
  • All traffic over HTTPS. TLS in transit, encrypted at rest.
  • Passphrase responsibility: We don't store your passphrase. If you lose it, your backups are unrecoverable. This is by design — it's what makes the system zero-knowledge.

⚠️ Important: Write down your encryption passphrase and store it securely. There is no password reset. Lost passphrase = permanently lost data.

Pricing

$9/month — everything included.

  • Unlimited agents — back up as many as you run
  • 30 snapshots per agent — roll back to any point
  • 10 GB storage — plenty for agent workspaces
  • Zero-knowledge encryption — always
  • Priority support