用途:ATXP Backup 用于备份和恢复智能体的 .md 文件(SOUL.md、MEMORY.md、memory/*.md、AGENTS.md、USER.md 等)到 ATXP 服务器。若工作区丢失,可在新机器上拉取备份继续工作。
主要能力:push 递归收集指定目录下所有 *.md 文件并上传,替换服务器快照;pull 从服务器下载备份并写入指定目录,非破坏性,不删除本地多余文件;status 显示文件数量、总大小和最后同步时间。
使用方式:需先完成 ATXP 认证,运行 npx atxp@latest login 或 npx atxp@latest agent register。命令为 npx atxp@latest backup push --path <dir>、npx atxp@latest backup pull --path <dir>、npx atxp@latest backup status。push/pull 必须提供 --path,无自动检测。典型 OpenClaw 工作区路径如 ~/.openclaw/workspace-<id>/。
安全模型:仅收集和传输 .md 文件,不发送凭据、JSON 配置、二进制或其他文件类型;文件经 HTTPS 发送至 ATXP 服务器,并与已认证的智能体身份关联;push 完全替换服务器快照;pull 不删除本地文件;仅读写 --path 目录,不修改 OpenClaw 配置或认证文件。
适用场景:对 SOUL.md、MEMORY.md 有实质修改后或会话结束时 push;初始化新工作区或环境丢失后 pull;高风险操作前用 status 确认备份存在。
限制:仅支持 .md 文件;仅保留最新快照,每次 push 覆盖上一次,无版本历史;需要 ATXP 认证;--path 为必填项。