Agent Life — 备份、同步与恢复

alf CLI 使用 Agent Life 格式 (ALF) 将您的代理的记忆、身份、凭证和工作区文件备份、同步并恢复到云端。所有命令均以 JSON 格式输出到 stdout。进度信息输出到 stderr。详见 https://agent-life.ai

安装

从 GitHub Releases 下载并安装 alf 二进制文件：

sh

选项 1：下载、检查然后运行安装脚本（推荐）

选项 2：直接下载二进制文件（无安装脚本）

查看平台二进制文件：https://github.com/agent-life/agent-life-adapters/releases/latest

源代码：https://github.com/agent-life/agent-life-adapters（MIT 许可证，开源）
安装脚本源码：https://github.com/agent-life/agent-life-adapters/blob/main/scripts/install.sh

安装脚本会检测您的平台，下载二进制文件，验证 SHA256 校验和，并安装到 /usr/local/bin/alf（无 root 权限时安装到 ~/.local/bin/alf）。标准输出为 JSON：

json
{ok:true,version:v0.2.0,installedversion:alf 0.2.0,path:/usr/local/bin/alf,checksumverified:true}

验证：alf --version

身份验证

在 https://agent-life.ai/settings/api-keys 获取 API 密钥，然后存储：

sh
alf login --key

输出：

json
{ok:true,keymasked:alfsk1...cdef,configpath:/home/user/.alf/config.toml}

检查环境

在同步之前，运行 alf check 验证环境并自动发现工作区：

sh
alf check -r openclaw

该命令会从 ~/.openclaw/openclaw.json 或 ~/.alf/config.toml 自动发现工作区路径。要显式指定工作区：

sh
alf check -r openclaw -w /path/to/workspace

JSON 输出中的关键字段：

如果 readytosync 为 false，请阅读 issues[] 了解需要修复的内容。每个问题都有一个 fix 字段，包含解决该问题的确切命令或操作。

核心工作流程

预检后同步（推荐）

sh
check=$(alf check -r openclaw)
ready=$(echo $check | jq -r .readytosync)
ws=$(echo $check | jq -r .workspace.path)

if [ $ready = true ]; then
alf sync -r openclaw -w $ws
else
echo $check | jq -r .issues[] | [\(.severity)] \(.message)\n Fix: \(.fix) >&2
fi

首次备份

导出创建本地 .alf 存档，然后同步将其上传到云端：

sh
alf export -r openclaw -w
alf sync -r openclaw -w

导出输出：

json
{ok:true,output:agent-export.alf,agentname:Atlas,alfversion:1.0.0-rc.1,memoryrecords:47,filesize:102400}

同步输出（首次同步 — 完整快照）：

json
{ok:true,sequence:0,delta:false,changes:null,snapshotpath:/home/user/.alf/state/abc-snapshot.alf,nochanges:false}

增量同步

首次同步后，后续同步仅上传更改的内容：

sh
alf sync -r openclaw -w

输出：

json
{ok:true,sequence:5,delta:true,changes:{creates:2,updates:1,deletes:0},snapshotpath:/home/user/.alf/state/abc-snapshot.alf,nochanges:false}

从云端恢复

下载最新状态并恢复到工作区：

sh
alf restore -r openclaw -w

如果本地跟踪多个代理，请指定要恢复的代理：

sh
alf restore -r openclaw -w -a

输出：

json
{ok:true,agentid:a1b2c3d4,agentname:Atlas,sequence:5,runtime:openclaw,memory_records:47,workspace:/home/user/.openclaw/workspace,warnings:[]}

导入存档

将 .alf 文件导入工作区，无需经过云端：

sh
alf import -r openclaw -w backup.alf

验证存档

根据 ALF JSON 模式检查 .alf 文件：

sh
alf validate backup.alf

输出：

json
{ok:true,valid:true,errors:[],warnings:[]}

常见错误及修复