← Back to Skills Marketplace
2. Copy the
agent-backup-transfer
by
Pacifier00
· GitHub ↗
· v1.0.0
· MIT-0
270
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install agent-backup-transfer
Description
Backup and restore your OpenClaw agent's workspace and config to preserve memory, identity, and settings or migrate to a new computer.
README (SKILL.md)
SKILL.md - OpenClaw Backup
Backup and restore your OpenClaw agent (workspace + config).
When to Use
- User wants to create a backup of their agent
- User wants to move to a new computer
- User asks how to preserve their agent's memory/identity
- Important memories or updates happened — time to save!
What Gets Backed Up
- Workspace —
~/.openclaw/workspace/(agent memory, identity, files) - OpenClaw Config —
~/.openclaw/(settings, sessions, agents)
Commands
Create Backup (Manual)
cd ~/.openclaw/workspace
./skills/openclaw-backup/openclaw-backup.sh create
Creates: ~/openclaw-backups/openclaw-backup-YYYY-MM-DD_HHMMSS.tar.gz
Keeps last 10 backups automatically.
Auto-Backup Setup
./skills/openclaw-backup/openclaw-backup.sh setup-auto
Creates a hook at ~/.openclaw/workspace/.hooks/post-memory-save.sh
Call it manually when important memories are saved:
~/.openclaw/workspace/.hooks/post-memory-save.sh
Or add daily backups via crontab:
crontab -e
# Add: 0 2 * * * ~/.openclaw/workspace/skills/openclaw-backup/openclaw-backup.sh create
List Backups
./skills/openclaw-backup/openclaw-backup.sh list
Restore from Backup
./skills/openclaw-backup/openclaw-backup.sh restore ~/Downloads/openclaw-backup-2026-03-09.tar.gz
Moving to a New Computer
1. On OLD computer:
cd ~/.openclaw/workspace
./skills/openclaw-backup/openclaw-backup.sh create
ls ~/openclaw-backups/
2. Copy the .tar.gz file to new computer
- USB drive, cloud sync, email, Discord... whatever works
- Put it in your Downloads folder or anywhere you can find
3. On NEW computer:
If OpenClaw is already installed:
tar -xzf ~/Downloads/openclaw-backup-2026-03-09.tar.gz -C ~
openclaw gateway start
If OpenClaw is NOT installed:
# 1. Install OpenClaw (see docs)
# 2. Then restore:
tar -xzf ~/Downloads/openclaw-backup-2026-03-09.tar.gz -C ~
openclaw gateway start
4. Done!
Open http://127.0.0.1:18789/ — your agent is back! 🎉
Requirements
- Linux/WSL2 (tested on Ubuntu/WSL2)
- tar (pre-installed on most systems)
- ~1-2MB per backup (excludes logs and temp files)
Notes
- Excludes logs, temp files, node_modules, .git to keep backup small
- Tested on WSL2 / Linux systems
Usage Guidance
This skill appears to do exactly what it says: create, list, restore, and optionally hook automatic backups of your OpenClaw workspace and config. Before installing or using it, consider the following:
- Backups include identity and config files (e.g., .openclaw/openclaw.json, identity, agents) which may contain keys or tokens. Treat backup tar.gz files as sensitive secrets.
- When moving backups between machines, use secure transfer channels (encrypted cloud storage, SFTP, or an encrypted USB drive). Avoid sending raw backups over email, instant messaging, or other unencrypted/third-party channels unless you encrypt them first.
- The restore action extracts into $HOME and can overwrite files. Verify the archive contents (e.g., tar -tzf <file>) before restoring and keep backups of any files you might need to preserve.
- The auto-hook expects the backup script to be located at ~/.openclaw/workspace/skills/openclaw-backup/openclaw-backup.sh; if your skills are stored elsewhere the hook may not find it. Review the created hook script before enabling automated runs or adding it to cron.
- As a precaution, inspect the included openclaw-backup.sh yourself (it is provided) and consider encrypting stored backups (e.g., use gpg) if you need to store them long-term or on third-party services.
Capability Analysis
Type: OpenClaw Skill
Name: agent-backup-transfer
Version: 1.0.0
The skill provides standard backup and restore functionality for the OpenClaw agent's workspace and configuration files. The bash script (openclaw-backup.sh) uses standard tools like tar to manage local archives in the user's home directory and includes basic safety features like backup rotation and confirmation prompts during restoration.
Capability Assessment
Purpose & Capability
The name/description match the provided script and SKILL.md. The script backs up ~/.openclaw/workspace and relevant config files (.openclaw/openclaw.json, identity, agents) and provides create/list/restore/setup-auto commands as advertised.
Instruction Scope
Instructions stay within the stated purpose (creating/restoring backups and installing a hook). The restore command extracts the archive into $HOME and will overwrite files; the script prompts for confirmation before restoring. The SKILL.md recommends transferring backups via arbitrary channels (email, Discord, cloud)—this is a user guidance point because backups include sensitive data.
Install Mechanism
No install spec; this is an instruction-only skill with an included bash script. Nothing is downloaded from external URLs or written outside the user's home directory by the script itself.
Credentials
The skill requests no environment variables or external credentials (proportionate). However, backups intentionally include identity/config files which likely contain sensitive tokens/keys; that is expected for a full agent backup but requires the user to protect the generated tar.gz files appropriately.
Persistence & Privilege
always is false and the script does not request elevated or system-wide privileges. The setup-auto command creates a hook under ~/.openclaw/workspace/.hooks which is limited to the user's home and does not alter other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-backup-transfer - After installation, invoke the skill by name or use
/agent-backup-transfer - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Major refactor: Unified all backup and restore functionality into a single script, openclaw-backup.sh.
- Removed legacy scripts/backup.sh and references/restore.md for a simpler, script-first workflow.
- New features: Auto-backup hook support, backup listing, and step-by-step agent migration guidance.
- Rotation now keeps the last 10 backups automatically (up from 7).
- Updated documentation with clearer instructions, usage scenarios, and Linux/WSL2 requirements.
Metadata
Frequently Asked Questions
What is agent-backup-transfer?
Backup and restore your OpenClaw agent's workspace and config to preserve memory, identity, and settings or migrate to a new computer. It is an AI Agent Skill for Claude Code / OpenClaw, with 270 downloads so far.
How do I install agent-backup-transfer?
Run "/install agent-backup-transfer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is agent-backup-transfer free?
Yes, agent-backup-transfer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does agent-backup-transfer support?
agent-backup-transfer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created agent-backup-transfer?
It is built and maintained by Pacifier00 (@pacifier00); the current version is v1.0.0.
More Skills