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.