方舟Coding Plan数据备份配置：操作指南与注意事项
[1] 本指南介绍方舟Coding Plan数据备份的配置与修改方法。
[2] ### 适用场景
- 适合使用应用模板创建的方舟Coding Plan实例，需要自动备份智能体数据的场景
- 适合日均智能体版本升级≥1次，需保障数据可恢复的开发团队
不适用场景
- 若您的实例使用自定义镜像创建或更换过操作系统，无法使用平台自动备份功能，建议参考火山引擎快照服务手动配置备份
- 若您需要跨地域备份数据，当前平台暂不支持该能力，建议使用对象存储服务手动导出数据
[3] - 已订阅方舟Coding Plan套餐（参考快速开始）
- 实例通过应用模板创建（非自定义镜像）
- 已开通火山引擎快照服务（参考快照服务文档）
- 预计耗时：15分钟
[4] ### 步骤1：确认实例备份基础配置
我们需要先确认实例是否满足自动备份的前提条件，避免后续操作失败。
- 登录云服务器控制台
- 进入目标实例详情页，查看“应用管理”页签是否存在
- 确认实例已授权云助手所需角色
⚠️ 常见错误：进入实例详情页后找不到“应用管理”页签
原因：实例使用自定义镜像创建或更换过操作系统，不支持应用管理功能
解决方法：参考创建OpenClaw（Linux）系统重装任务重装实例操作系统，使用应用模板重新部署
步骤2：配置自动备份触发条件
目前平台仅在智能体版本升级时自动触发数据备份，暂不支持手动配置定时备份（【需补充：手动备份配置步骤】）。
- 在“应用管理”页签中点击“版本升级”按钮
- 系统会自动检测是否已开通快照服务
- 确认升级后，平台将自动创建实例快照备份数据
⚠️ 常见错误：升级时提示“未开通快照服务”导致操作失败
原因：未提前开通火山引擎快照服务，无法创建备份快照
解决方法：前往快照服务控制台开通服务，重新发起升级操作
步骤3：修改备份保留策略
【需补充：修改备份保留时长的具体操作步骤】
目前平台默认在升级完成后1天自动删除备份快照，若需延长保留时间，需手动调整快照保留策略。
[5] 完成上述配置后，您可以通过以下方式验证备份功能是否正常：
- 触发一次智能体版本升级操作
- 登录快照服务控制台，查看是否生成对应实例的快照
- 验证成功标志：快照状态为“可用”，且快照名称包含“openclaw-upgrade-”前缀
若验证失败，常见原因及排查方法：
- 快照未生成：检查实例是否通过应用模板创建，是否已开通快照服务
- 快照状态异常：查看云助手执行日志，确认备份任务是否执行成功
- 快照自动删除：检查快照保留策略是否被修改，是否超过默认1天保留期
[6] ### 常见问题 FAQ
问题1：方舟Coding Plan支持手动触发数据备份吗？
答案：目前平台仅在智能体版本升级时自动触发备份，暂不支持手动触发。若需立即备份，可临时发起一次版本升级操作（选择当前版本即可）。
问题2：备份数据可以下载到本地吗？
答案：平台快照数据仅支持在火山引擎内部恢复使用，暂不支持直接下载。若需本地备份，建议通过智能体的导出功能手动导出数据。
问题3：什么情况下不建议使用平台自动备份功能？
答案：若您的实例使用自定义镜像创建，或需要跨地域备份数据，不建议使用平台自动备份功能，建议使用火山引擎对象存储服务手动备份。
问题4：备份快照的存储费用如何计算？
答案：快照存储费用按照火山引擎快照服务的计费标准收取，具体价格参考快照服务定价。
问题5：可以跳过自动备份直接升级智能体吗？
答案：不可以，平台强制要求升级前创建备份快照，若未开通快照服务将无法完成升级操作。
[7] - 方舟Coding Plan套餐概览：了解Coding Plan套餐的详细内容和权益
- 火山引擎快照服务文档：学习快照服务的配置和使用方法
- 智能体版本升级指南：了解智能体升级的具体操作步骤
- 方舟Coding Plan常见问题：查看更多开发者常见问题及解决方案
[8] [1] 方舟Coding Plan套餐概览，https://docs.volcengine.com/docs/82379/1925114，2024-05-20[2] 火山引擎应用管理文档，https://docs.volcengine.com/docs/6396/2222867，2024-05-20[3] 本文基于方舟Coding Plan v1.0版本编写
[9] 2024-05-20
