Documentation

Your encryption passphrase is a separate key from your account password. It encrypts your backups with AES-256-GCM before they leave your machine. MemoryClaw operates on a zero-knowledge model — we never see, store, or transmit your passphrase. Only encrypted data reaches our servers.

On first backup, you choose a passphrase (minimum 8 characters) and confirm it. You are then offered to save it locally, encrypted with a machine-specific key. Once saved, auto-backups and the --auto flag work without prompting.

You can change your passphrase at any time via memoryclaw → Settings → Change encryption passphrase, or from the interactive settings menu. Note that changing your passphrase only affects future backups — existing backups remain encrypted with their original passphrase.

Every backup creates a new, independently stored version. Previous versions are not overwritten — they remain in your backup history until your storage quota is reached, at which point the oldest versions are automatically removed to make room.

You can browse your full version history from the dashboard, where each entry shows the timestamp, file size, and a per-entry download button. From the CLI, memoryclaw history lists all available versions, and the memoryclaw pull command includes a version picker so you can restore any specific backup — not just the latest.

During your first backup, your passphrase is saved locally (encrypted). This enables the memoryclaw push --auto flag, which runs without any prompts.

The installer configures an OpenClaw cron job that calls memoryclaw push --auto on a schedule so your memory stays backed up hands-free.

A claw is an OpenClaw instance backed up by MemoryClaw. Each claw has its own backup history, storage usage, and backup schedule. You can have multiple claws on the same machine — each pointing to a different OpenClaw directory — or spread them across different machines. Name them anything you like (e.g. work-claw, personal-claw).

Free plan: up to 1 claw. Pro plan: up to 10 claws. See pricing for details.

When you first run MemoryClaw, it registers your default OpenClaw directory as a claw. To add more claws (e.g. for different projects or directories on the same machine), use memoryclaw claws add. You can rename or set a primary claw from the CLI. Deleting claws is only available from the dashboard for safety.

Run memoryclaw with no arguments to open the interactive menu. From here you can access all features without memorizing commands. The menu loops back after every action — no need to re-launch.

The Change backup frequency option lets you adjust how often auto-backups run. Free plans can schedule hourly or less frequent backups. Pro plans unlock frequencies down to every 5 minutes.

The Exclude files/folders option lets you add or remove glob patterns to skip certain files from your backup (e.g. *.log, node_modules/, .env).

All account management is available from the dashboard:

• Change password — Security section with current password verification.
• Change email — Verified flow: enter your current password and the new email address, then check the new inbox for a confirmation link. A notification is also sent to your old email for security.
• Manage subscription — View billing interval, switch between monthly/annual, cancel or reactivate. Cancellation keeps access until the end of the billing period.
• Delete account — Permanently removes your account, all backups, and cancels any active subscription.

Run memoryclaw doctor to perform a full health check of your setup. It verifies:

• Config directory exists and is writable
• Device config (device.json) is valid
• Authentication status and token validity
• API connectivity and latency
• Cron job (auto-backup) is installed
• OpenClaw directory exists
• Passphrase is saved locally

Each check shows a pass/fail indicator with a description of what to fix if something is wrong. This is the first command to run when troubleshooting.