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 表示大版本,yz 表示小版本。跨大版本可能存在不兼容变更,不允许一键升级到最新版本;同一大版本中的小版本支持一键升级到最新版本。
  • 同一大版本中的小版本向后兼容,允许一键升级到最新版本。例如:假设当前版本是 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
这个页面对您有帮助吗?
有用
有用
无用
无用