Backup to Telnyx Storage

Backup and restore your OpenClaw workspace to Telnyx Storage (S3-compatible).

Setup (One-Time)

# 1. Install Telnyx CLI (if not already)
npm install -g @telnyx/api-cli

# 2. Authenticate
telnyx auth setup

That's it. No boto3, no AWS credentials, no environment variables.

Usage

Backup

./backup.sh

# Output:
# 🔄 OpenClaw Backup → Telnyx Storage
# ========================================
# Creating archive: openclaw-backup-20260201-120000.tar.gz
#   + MEMORY.md
#   + SOUL.md
#   + memory/
# ✅ Backup complete: openclaw-backup/openclaw-backup-20260201-120000.tar.gz

Custom bucket and workspace:

./backup.sh my-bucket ~/my-workspace

Control backup retention (default: 48, ~24h of 30-min backups):

MAX_BACKUPS=100 ./backup.sh

List Backups

./list.sh

# Output:
# 📋 Available Backups
# ========================================
# Bucket: openclaw-backup
#
#   • openclaw-backup-20260201-120000.tar.gz  1.2M  2/1/2026
#   • openclaw-backup-20260131-180000.tar.gz  1.1M  1/31/2026

Restore

# Restore latest backup
./restore.sh latest

# Restore specific backup
./restore.sh openclaw-backup-20260201-120000.tar.gz

# Restore to different location
./restore.sh latest my-bucket ~/restored-workspace

What Gets Backed Up

• AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md
• MEMORY.md, HEARTBEAT.md, GUARDRAILS.md
• memory/, knowledge/, scripts/

Scheduling

Automatic backups every 30 minutes:

crontab -e
# Add:
*/30 * * * * ~/skills/backup-to-telnyx-storage/backup.sh >> /tmp/backup.log 2>&1

Pricing

Telnyx Storage: $0.023/GB/month — typical workspace costs pennies.

Legacy Python Script

The original backup.py using boto3 is still available if you need AWS SDK compatibility:

pip install boto3
export TELNYX_API_KEY=KEYxxxxx
python3 backup.py

Note: The CLI-based scripts (backup.sh, list.sh, restore.sh) are recommended as they require no additional dependencies and provide full backup/list/restore functionality.