aionclaw升级前必须确认是否与openclaw原生流程共存,因二者进程隔离、插件路径及技能注册表已存在实质性差异,直接覆盖会导致定时任务中断、插件失效、hermes记忆库无法加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

升级AionClaw前必须确认是否与当前运行的OpenClaw原生流程共存,因为二者虽同源但进程隔离策略、插件加载路径和技能市场注册表结构已产生实质性差异,直接覆盖安装会导致原有定时任务中断、自定义插件失效、Hermes记忆库无法加载。
判断是否影响现有OpenClaw流程
先执行环境探查命令,确认当前系统中是否存在双框架共存痕迹:
openclaw doctor --list-installs
若输出中同时出现 【/opt/aionclaw】 和 【~/.openclaw】 两个路径,则说明已存在物理隔离部署,升级AionClaw不会触碰OpenClaw原生目录;若只显示后者,而你又曾手动运行过 openclaw serve,则本次AionClaw升级将默认接管系统级服务端口(8080)和全局CLI别名,原有流程会因端口冲突或命令覆盖而静默失败。
安全升级AionClaw的三种路径
方法一:保留双框架并行(推荐给仍在维护OpenClaw原生流程的用户)
下载AionClaw独立安装包后,不运行默认installer.sh,改用离线部署模式:
tar -xzf aionclaw-2026.2.9-linux-amd64.tar.gz -C /opt/aionclaw-isolated
然后手动修改其启动脚本中的端口为8081,再执行 ./aionclaw start --port 8081
这一步必须做,否则AionClaw服务启动时会强制kill掉占用8080端口的任何进程——包括你正在跑的OpenClaw原生实例。
方法二:迁移式升级(仅适用于已决定弃用OpenClaw原生版的用户)
第一步:导出当前OpenClaw全部技能与任务配置
openclaw skill export --all > ~/oc_backup/skills.json
第二步:停用原生服务并卸载CLI
systemctl stop openclaw → pip uninstall openclaw-cli -y
第三步:运行AionClaw安装器时添加 --migrate-from-openclaw 参数
sudo ./installer.sh --migrate-from-openclaw --backup-dir ~/oc_backup
该参数会自动解析skills.json并映射为AionClaw可识别的技能包格式,但【Hermes Agent记忆库中的会话上下文、个性化偏好词表、临时文件缓存不会迁移】,这些数据仍保留在 ~/.openclaw/ 目录下,需人工决定是否合并。
方法三:容器化隔离升级(适合开发测试环境)
使用官方提供的Docker Compose模板启动AionClaw,完全不接触宿主机上的OpenClaw安装目录:
curl -O https://aionclaw.io/releases/compose-v2026.2.9.yml → docker-compose -f compose-v2026.2.9.yml up -d
此方式下,AionClaw所有数据写入容器卷 /var/lib/docker/volumes/aionclaw_data/_data,与宿主机 ~/.openclaw 彻底无关,OpenClaw原生流程可照常运行。










