You need to enable JavaScript to run this app.
文档中心
ArkClaw 企业版

ArkClaw 企业版

复制全文
下载 pdf
ArkClaw高级功能
升级ArkClaw版本
复制全文
下载 pdf
升级ArkClaw版本
定期升级 ArkClaw 实例版本,是保障智能体网关稳定、安全、高效运行的核心举措。不仅能解决旧版本安全隐患,实现系统全面优化与能力跃升,而且能使用新增功能,适配业务迭代。平台推送新版本时,推荐及时升级到最新版本,本文为您介绍员工如何升级 ArkClaw 实例版本。​
背景信息​
ArkClaw 版本由平台统一管理和推送,平台发布新版本后,员工将收到升级提醒和版本更新说明,推荐及时升级 ArkClaw 实例版本。详细升级流程如下:​
  1. 平台推送新版本后,员工检查更新可以获取新版本和版本更新说明。​
  1. 确认无误后执行升级操作,正式升级前,将自动触发实例数据备份,若备份失败,将直接中止升级任务,若备份成功,将正式进入升级环节。​
  1. 升级过程将依次对实例中的 Core、Skill、Plugin 进行升级。若升级失败,会触发自动回滚机制,将实例版本回滚到升级前的版本,确保实例可用;若升级成功,将结束升级流程。​
​​​
前提条件​
平台已经推送 ArkClaw 新版本,通过检查更新能够查询到新版本及其更新记录。​
使用限制​
  • 平台仅维护官方提供的 Core、Skill、Plugin,用户自行安装的内容不在维护范围内。​
  • 仅“运行中”状态的实例支持执行升级操作,升级期间服务中断约 10~15 分钟,为了不影响正常使用,建议在业务低峰期执行升级操作。​
  • 员工升级 ArkClaw 实例版本时自动备份的数据,将覆盖员工手动备份数据。​
  • ArkClaw 采用 x.y.z 格式进行版本标记,其中 x 表示大版本,y 和 z 表示小版本。跨大版本可能存在不兼容变更,不允许一键升级到最新版本;同一大版本中的小版本支持一键升级到最新版本。​
  • 同一大版本中的小版本向后兼容,允许一键升级到最新版本。例如:假设当前版本是 1.0.1,最新版本是 1.2.0,同属于一个大版本,即便间隔其他小版本,依然允许一键从 1.0.1 升级到 1.2.0 版本。​
  • 跨大版本可能存在不兼容变更,若期望跨大版本升级到最新版本,需要进行多次升级。例如:假设当前版本是 1.0.1,最新版本是 2.2.3,升级期间存在跨 2.0.0 大版本的情况,需要先从 1.0.1 升级到 2.0.0 版本,再从 2.0.0 升级到 2.2.3 版本,经过两次升级才能升级到最新版本。​
  • ​​​
操作步骤​
  1. 打开浏览器,在浏览器地址栏中输入登录ArkClaw链接,按“回车”键。​
  1. 切换至目标ArkClaw页面后,单击右上角的详情图标。​
  • ​​​
  1. 单击“检查更新”按钮,检查平台是否已经推送 ArkClaw 新版本。​
  • ​​​
  • 若提示“发现新版本”,表示平台已经推送新版本,可以查看新版本更新说明和版本详情,并执行升级操作。​
  • ​​​
  • 若提示“已是最新版本”,表示平台没有推送新版本,无需进行升级。​
  • ​​​
  1. 单击 立即更新,开始升级,包含预检查、备份当前版本、升级组件 3 个环节。单击升级页面中的 查看日志,可实时查看升级相关日志信息。​
注意​
升级过程预计 10~15 分钟,请勿关闭页面。​
  • ​​​
  1. 升级成功后,单击 完成 按钮,将返回对话页面,恢复与 ArkClaw 的正常交互,体验新版本功能。​
  • ​​​
后续操作​
  • 若升级失败,ArkClaw 将自动回滚至升级前的版本,常见升级失败原因及解决方案如下:​
  • ​
    常见原因​
    说明​
    解决方案​
    备份失败​
    ArkClaw 实例数据备份失败,导致升级作业中止。​
    通常再次尝试升级即可解决。​
    自行升级 OpenClaw 版本​
    员工自行升级了 OpenClaw 版本,与平台推送的版本冲突,导致无法正常升级。​
    注意​
    推荐跟随平台推送进行版本升级,不建议企业员工自行升级 OpenClaw 版本等核心组件。​
    手动回滚 OpenClaw 版本与平台推送版本一致后重试,或通过 问题反馈 获取技术支持。​
    自行安装的内容升级失败​
    员工自行安装非平台提供的 Skill、Plugin 等工具,形成阻塞,导致无法正常升级。​
    注意​
    推荐使用平台提供的 Skill、Plugin 等工具,不建议企业员工自行安装非官方工具。​
    手动升级员工自行安装的 Skill、Plugin 等工具后重试,或通过 问题反馈 获取技术支持。​
    ​
  • 若升级后存在使用故障,可前往数据页面,使用升级前自动的备份的数据(手动备份页签中的备份数据),快速恢复到升级前的版本。备份/恢复相关更多说明参见:备份/恢复ArkClaw数据。​
警告​
  • 平台不推荐一直使用历史版本,仅当新版本存在故障且已经影响业务正常运作时,可使用此方式快速恢复到升级前的版本。​
  • 若通过备份数据恢复到升级前的版本,后续依然需要重新升级到最新版本。​
  • ​​​
最近更新时间:2026.06.12 20:49:44
这个页面对您有帮助吗?
有用
有用
无用
无用