ATXP Backup — Agent Identity & Memory Backup

Back up and restore your agent's .md files (SOUL.md, MEMORY.md, memory/*.md, AGENTS.md, USER.md, etc.) to ATXP servers. If your workspace is lost, pull your backup to a fresh machine and resume where you left off.

Security Model

• Only .md files are collected and transmitted. No credentials, JSON configs, binaries, or other file types are ever sent.

• Files are sent to ATXP servers over HTTPS, associated with the authenticated agent's identity.

• push replaces the server snapshot entirely (latest snapshot only, no history).

• pull is non-destructive — it writes server files to the local directory but does not delete local files absent from the server.

• Filesystem access: reads from --path directory (push), writes to --path directory (pull). No other directories are touched.

• No modification of OpenClaw config or auth files.

When to Use

Situation Command

After meaningful changes to SOUL.md, MEMORY.md, or at end of session push

Bootstrapping a fresh workspace or recovering from environment loss pull

Verify backup exists before risky operations status

Commands Reference

Command Description

npx atxp@latest backup push --path <dir>

Recursively collect all *.md files from <dir> and upload to server

npx atxp@latest backup pull --path <dir>

Download backup from server and write files to <dir>

npx atxp@latest backup status

Show file count, total size, and last sync time

Options

Option Required Description

--path <dir>

Yes (push/pull) Directory to push from or pull to

Path Conventions

Typical OpenClaw workspace paths:

~/.openclaw/workspace-<id>/ ~/.openclaw/workspace-<id>/SOUL.md ~/.openclaw/workspace-<id>/MEMORY.md ~/.openclaw/workspace-<id>/memory/ ~/.openclaw/workspace-<id>/AGENTS.md ~/.openclaw/workspace-<id>/USER.md

Limitations

• .md files only — all other file types are ignored during push and not present in pull.

• Latest snapshot only — each push overwrites the previous backup. There is no version history.

• Requires ATXP auth — run npx atxp@latest login or npx atxp@latest agent register first.

• --path is required — there is no auto-detection of workspace location.