Backup and Restore

Overview

profClaw stores configuration, memory, audit logs, and task history locally. Regular backups ensure you can recover from hardware failures, corruption, or accidental deletion.

What Gets Backed Up

Data	Location	Included
Configuration	`.profclaw/settings.yml`	Yes
SQLite database	`.profclaw/profclaw.db`	Yes
Memory entries	`.profclaw/memory/`	Yes
Audit logs	`.profclaw/audit/`	Yes
Plugin data	`.profclaw/plugins/`	Yes
Encryption keys	`.profclaw/keys/`	Yes
Skills	`skills/`	Yes
Environment vars	`.env`	No (manual)
Redis data	External	No (separate backup)

Manual Backup

# Create a backup
profclaw backup create

# Create with custom output path
profclaw backup create --output ./backups/

# Create with timestamp
profclaw backup create --output ./backups/profclaw-$(date +%Y%m%d).tar.gz

Automatic Backups

Enable scheduled backups:

backup:
  enabled: true
  interval: 86400000   # Every 24 hours (ms)
  retention: 7         # Keep last 7 backups
  path: .profclaw/backups

Or via environment variables:

export BACKUP_ENABLED=true
export BACKUP_INTERVAL=86400000
export BACKUP_RETENTION=7

Restore

# List available backups
profclaw backup list

# Restore from latest
profclaw backup restore --latest

# Restore from specific file
profclaw backup restore --file ./backups/profclaw-20260312.tar.gz

Restoring a backup replaces your current data. The current state is automatically saved as a pre-restore backup before the restore operation begins.

Docker Backup

For Docker deployments, back up the data volume:

# Backup
docker run --rm \
  -v profclaw-data:/data \
  -v $(pwd)/backups:/backup \
  alpine tar czf /backup/profclaw-$(date +%Y%m%d).tar.gz /data

# Restore
docker run --rm \
  -v profclaw-data:/data \
  -v $(pwd)/backups:/backup \
  alpine sh -c "rm -rf /data/* && tar xzf /backup/profclaw-20260312.tar.gz -C /"

Redis Backup (Pro Mode)

If using Redis for the job queue:

# Trigger Redis RDB snapshot
redis-cli BGSAVE

# Copy the dump file
cp /var/lib/redis/dump.rdb ./backups/redis-$(date +%Y%m%d).rdb

Disaster Recovery Checklist

Stop profClaw: profclaw daemon stop or systemctl stop profclaw
Restore backup: profclaw backup restore --file backup.tar.gz
Verify config: profclaw doctor
Restore Redis (if pro mode): Copy RDB file to Redis data directory
Start profClaw: profclaw serve
Verify: profclaw status

​Overview

​What Gets Backed Up

​Manual Backup

​Automatic Backups

​Restore

​Docker Backup

​Redis Backup (Pro Mode)

​Disaster Recovery Checklist

Overview

What Gets Backed Up

Manual Backup

Automatic Backups

Restore

Docker Backup

Redis Backup (Pro Mode)

Disaster Recovery Checklist