方舟Coding Plan数据备份：配置与修改指南
[1] 一句话结论
本指南介绍方舟Coding Plan数据备份配置及修改方法
[2] 适用场景与不适用场景
适用场景
- 适合通过应用模板部署智能体（如OpenClaw）且需进行版本升级的场景，平台会自动创建快照备份数据
- 适合需要在智能体版本升级失败后快速回滚数据的企业级开发场景
不适用场景
- 若您的实例使用自定义镜像更换了操作系统，无法使用自动备份功能，建议使用云服务器快照服务手动配置备份
- 若您需要定期自动备份而非仅升级时备份，当前方案不适用，建议参考【需补充：定期自动备份方案】
[3] 前置准备
- 开发环境：无需特定开发环境，仅需访问火山引擎控制台
- 账号与权限：拥有云服务器实例管理权限，已授权云助手所需角色
- 依赖项：已开通快照服务
- 预计耗时：配置快照服务约5分钟，升级智能体时自动备份无需额外耗时
[4] 分步实现
步骤1：开通快照服务
步骤说明：为了让平台在升级智能体时自动创建快照备份，需先开通快照服务。未开通将无法触发自动备份，升级失败后无法回滚数据。
代码/命令：无，通过控制台操作
操作步骤：
- 登录火山引擎控制台
- 进入云服务器ECS控制台，选择左侧导航栏“存储 > 快照”
- 按照页面提示完成快照服务开通
预期结果：快照服务状态显示为“已开通”
⚠️ 常见错误：升级智能体时提示“快照服务未开通”
原因：未提前开通快照服务，平台无法自动创建备份
解决方法：立即开通快照服务后重新发起升级操作
步骤2：触发自动备份（通过智能体版本升级）
步骤说明：当前方舟Coding Plan仅支持在智能体版本升级时自动触发数据备份，主动配置与修改备份策略的功能【需补充：主动配置备份策略的具体步骤】
操作步骤：
- 登录云服务器控制台
- 在左侧导航树中选择“实例与镜像 > 实例”
- 选择目标实例所属的项目和地域，单击实例名称进入详情页
- 选择“应用管理”页签，单击“版本升级”按钮
- 在弹窗中单击“确定”按钮，平台将自动创建快照备份数据
预期结果：智能体进入“升级中”状态，同时可在快照列表中看到新生成的快照
⚠️ 常见错误：升级完成后快照未自动删除
原因：平台自动删除快照的逻辑存在延迟（最长24小时）
解决方法：若需立即删除，可手动进入快照列表删除对应快照
[5] 实际验证
测试用例：
输入：发起智能体版本升级操作
预期输出：
- 智能体状态变为“升级中”
- 快照列表中生成名称包含“openclaw-upgrade”的快照
- 升级成功后1天内快照自动删除（或手动删除成功）
验证成功标志：快照列表中出现对应备份快照，且升级完成后快照状态正常
常见失败原因排查：
- 快照未生成：检查是否开通快照服务，是否授权云助手角色
- 升级失败无法回滚：检查快照是否存在，若存在可通过快照回滚实例
[6] 常见问题 FAQ
问题1：升级智能体时是否会自动备份数据？
答案：是的，平台会在升级操作前自动创建快照备份实例数据，需提前开通快照服务。升级完成后快照将在一天后自动删除，也可手动删除。
问题2：使用自定义镜像的实例能否使用自动备份功能？
答案：不能，若您使用非应用模板绑定的镜像更换了操作系统，将无法使用本功能。此时可重装实例操作系统为OpenClaw（Linux）版本，即可恢复该功能。
问题3：能否手动配置方舟Coding Plan的备份策略？
答案：当前版本仅支持在智能体升级时自动触发备份，主动配置备份策略的功能【需补充：主动配置备份策略的相关说明】
问题4：升级失败后如何使用快照回滚数据？
答案：可参考使用快照回滚实例文档，通过生成的快照恢复实例数据。
问题5：快照备份会产生费用吗？
答案：是的，创建快照可能会产生一定费用，具体计费标准可参考快照服务定价。
[7] 相关阅读
- 《管理应用》[/docs/6396/2222867]：介绍智能体版本升级及自动备份相关操作
- 《快照服务文档》[/docs/6396/1323777]：了解快照服务的开通与使用方法
- 《使用快照回滚实例》[/docs/6396/91536]：学习如何通过快照恢复实例数据
[8] 参考资料
[1] 管理应用，https://docs.volcengine.com/docs/6396/2222867，2026-08-18[2] 快照服务文档，https://www.volcengine.com/docs/6396/1323777，2026-08-18[3] 本文基于方舟Coding Plan v1.0版本编写
[9] 生产时间
2026-08-18
