CowAgent 可以生成便携的本地归档,用于设备迁移或灾难恢复。
创建备份
归档包含:
config.json
AGENT.md、USER.md、MEMORY.md 等 Agent 人格和用户文件
- 工作区内的每日记忆、会话历史、知识库、自定义技能和定时任务
- 配置多 Agent 后的 Agent registry、通道绑定和全部 Agent 工作区
- 旧版
user_datas.pkl(如存在)
临时 tmp/ 数据、缓存、Git 元数据和符号链接不会写入归档。在操作系统支持的情况下,归档文件权限会限制为仅当前用户可读写。
备份中可能含有 API 密钥、对话历史及其他个人数据,应按密钥文件保存和传输。ZIP 文件本身没有加密。
恢复备份
恢复前先停止 CowAgent:
迁移到不同工作区时,可以显式指定路径:
恢复多 Agent 归档时,--workspace 表示实例根目录:默认 Agent 恢复到该根目录,其余 Agent 恢复到 <根目录>/agents/<agent-id>,与 Agent registry 自身推导的布局一致。未传该参数时,本机已存在的同名 Agent 沿用当前工作区,其余 Agent 落在本机当前使用的实例根目录下。
恢复命令会在写入前校验归档格式和所有路径。它会覆盖同名文件,但不会删除目标目录中无关的现有文件。如果检测到当前 CowAgent 数据,会先在所选归档旁创建 cow-pre-restore-*.zip 回滚备份。
无人值守脚本可传入 --yes 确认覆盖。