メニュー
Backup OpenClaw state directory and workspace. Includes excluding sensitive files, packaging for backup. Triggered when user asks to backup, export, or save state.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/javimosch/open-claw-skills --skill safe-backupコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | safe-backup |
| description | Backup OpenClaw state directory and workspace. Includes excluding sensitive files, packaging for backup. Triggered when user asks to backup, export, or save state. |
Backup OpenClaw state directory and workspace with security best practices.
~/.openclaw/skills/safe-backup/scripts/backup.sh
Backup file: /tmp/safe-backup-20260223.tar.gz (Linux)
Backup file: /var/folders/xx/.../safe-backup-20260223.tar.gz (macOS)
Backup file: C:\Users\xxx\AppData\Local\Temp\safe-backup-20260223.tar.gz (Windows)
See "Storage Options" below.
| Platform | Status | Requirements |
|---|---|---|
| Linux | ✅ Fully supported | Native bash |
| macOS | ✅ Fully supported | Native bash |
| Windows (Git Bash) | ✅ Supported | Git for Windows |
| Windows (WSL) | ✅ Supported | WSL Ubuntu/Debian |
| Windows (Native CMD) |
| ❌ Not supported |
| Requires bash |
The script automatically detects the appropriate temp directory for each platform:
| Platform | Temp Directory | Environment Variable |
|---|---|---|
| Linux | /tmp | - |
| macOS | /var/folders/xx/... | $TMPDIR |
| Windows (Git Bash) | C:\Users\xxx\AppData\Local\Temp | $TEMP / $TMP |
The script uses rsync for efficient file copying:
If rsync is not available, the script will fail. For Windows without Git Bash, you need to install rsync separately (e.g., via MSYS2 or Cygwin).
The script uses Unix-style forward slashes (/). This works in:
Native Windows CMD uses backslashes (\) and won't work without modifications.
The script uses $HOME environment variable:
/home/username/Users/usernameC:\Users\usernameThis works correctly in all supported platforms.
When migrating from one platform to another:
# Run from Git Bash, NOT CMD or PowerShell
~/.openclaw/skills/safe-backup/scripts/backup.sh
If you get "rsync not found", install Git for Windows with all optional Unix tools.
# Native bash is available
~/.openclaw/skills/safe-backup/scripts/backup.sh
Temp directory will be in $TMPDIR (e.g., /var/folders/xx/...).
# Native bash is available
~/.openclaw/skills/safe-backup/scripts/backup.sh
Temp directory will be /tmp.
| Directory | Contents |
|---|---|
~/.openclaw/ | OpenClaw configuration |
~/.openclaw/workspace/ | Agent workspace files |
agents/ | Agent definitions |
skills/ | Installed skills |
memory/ | Memory files |
hooks/ | Custom hooks |
| Pattern | Reason |
|---|---|
*.log | Log files |
*.log.* | Log rotation files |
sessions.json | Session data |
logs/ | Log directory |
auth-profiles.json | API tokens & credentials |
.env | Environment variables |
*.pem, *.key | TLS/SSH keys |
credentials.json | Stored credentials |
api-keys.json | API keys |
sessions/ | Runtime sessions |
browser/ | Browser cache |
canvas/ | Canvas cache |
media/ | Temporary media files |
backups/ | Backup directory itself |
delivery-queue/ | Runtime queue |
devices/ | Device cache |
subagents/ | Runtime subagents |
completions/ | Auto-completion cache |
*.bak | Backup files |
*.save | Save files |
update-check.json | Update check cache |
| Scenario | Recommended Solution | Description |
|---|---|---|
| Regular Backup | Local encrypted storage | Weekly backup, store in encrypted local directory |
| Migrate to New Machine | Local tarball + USB | Transfer between machines, avoid network transmission |
| Cloud Disaster Recovery | Private GitHub repo | Private repo + encryption, for offsite backup |
| Server Environment | rsync to backup server | Automated periodic sync, suitable for production |
# Step 1: Run backup
~/.openclaw/skills/safe-backup/scripts/backup.sh
# Step 2: Find output path (check the last line of output)
# The script will display: "Backup file: /path/to/safe-backup-YYYYMMDD.tar.gz"
# Step 3: Verify backup contents
tar -tzf "$(ls -t /tmp/safe-backup-*.tar.gz | head -1)" | head -20
# Or use the exact path shown in output:
# tar -tzf /tmp/safe-backup-20260223.tar.gz | head -20
Choose one:
# Find the latest backup file
BACKUP_FILE=$(ls -t /tmp/safe-backup-*.tar.gz | head -1)
# Create encrypted archive
openssl enc -aes-256-cbc -salt -in "$BACKUP_FILE" -out ~/backups/safe-backup-$(date +%Y%m%d).tar.gz.enc
# Enter a strong password when prompted
# Delete unencrypted backup
rm "$BACKUP_FILE"
# One-time setup: Create private repo on GitHub
# Find the latest backup file
BACKUP_FILE=$(ls -t /tmp/safe-backup-*.tar.gz | head -1)
# Clone your private repo
git clone https://github.com/YOUR_USERNAME/safe-backup.git ~/safe-backup
# Extract backup
mkdir -p ~/safe-backup/$(date +%Y-%m-%d)
tar -xzf "$BACKUP_FILE" -C ~/safe-backup/$(date +%Y-%m-%d)/
# Commit and push
cd ~/safe-backup
git add .
git commit -m "Backup $(date +%Y-%m-%d)"
git push origin main
# Delete local copy
rm -rf ~/safe-backup
rm "$BACKUP_FILE"
# Example: sync to remote server
rsync -avz --delete \
--exclude='*.log' \
--exclude='sessions.json' \
~/.openclaw/ user@backup-server:/path/to/backups/
# If encrypted
openssl enc -aes-256-cbc -d -in ~/backups/safe-backup-20260223.tar.gz.enc -out /tmp/safe-backup.tar.gz
# If plain tarball, find the file
# Check your backup location (USB, cloud download, etc.)
cp /path/to/your/backup/safe-backup-20260223.tar.gz /tmp/
systemctl --user stop openclaw-gateway
# Determine temp directory based on platform
if [[ -n "$TMPDIR" ]]; then
TEMP_DIR="$TMPDIR"
elif [[ -n "$TEMP" ]]; then
TEMP_DIR="$TEMP"
elif [[ -n "$TMP" ]]; then
TEMP_DIR="$TMP"
else
TEMP_DIR="/tmp"
fi
# Extract to temporary location
mkdir -p "$TEMP_DIR/restore"
tar -xzf "$TEMP_DIR/safe-backup.tar.gz" -C "$TEMP_DIR/restore"
# Restore state directory
cp -r "$TEMP_DIR/restore/state/"* ~/.openclaw/
# Restore workspace (if needed)
cp -r "$TEMP_DIR/restore/workspace/"* ~/.openclaw/workspace/
Because auth-profiles.json was excluded, you must re-configure:
# Edit config to add authentication
openclaw config edit
# Or manually create auth-profiles.json
nano ~/.openclaw/agents/main/agent/auth-profiles.json
Required re-configuration:
systemctl --user start openclaw-gateway
# Verify
openclaw status
| Variable | Default | Description |
|---|---|---|
OPENCLAW_STATE_DIR | $HOME/.openclaw | OpenClaw state directory |
OPENCLAW_WORKSPACE_DIR | $HOME/.openclaw/workspace | Workspace directory |
Example:
OPENCLAW_STATE_DIR=/data/openclaw ~/.openclaw/skills/safe-backup/scripts/backup.sh
# Check if OpenClaw is installed
ls -la ~/.openclaw
# Run with appropriate permissions
chmod +x ~/.openclaw/skills/safe-backup/scripts/backup.sh
# Install Git for Windows with Unix tools, or use WSL
# Alternatively, install rsync via MSYS2:
# pacman -S rsync
# Check backup integrity
tar -tzf /path/to/your/backup.tar.gz
# If encrypted, verify password
openssl enc -aes-256-cbc -d -in backup.enc -o /dev/null