更新aionclaw后，安装路径、本地工作目录、已装插件、对话历史、hermes日志、快捷方式、托盘行为及通知设置自动保留；qwen-portal-auth认证、早于2026年7月20日的配置、2025年底前生成的32字节密钥需手动重配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
更新AionClaw后，部分旧配置可能失效，尤其涉及模型认证方式、密钥格式或路径规则的配置项，必须按新版要求手动调整才能继续使用。
哪些配置会自动保留
安装路径、本地工作目录、技能市场已安装的插件、对话历史记录、Hermes模块的运行日志默认全部保留。这些数据存储在用户目录下的aionclaw-data文件夹中，更新程序不会触碰该目录。
桌面快捷方式、系统托盘行为、通知开关设置也维持原状。
哪些配置必须手动重配
方法一：Qwen模型服务商迁移
原使用 qwen-portal-auth 方式认证的用户，更新后将无法调用通义千问系列模型。openclaw v2026.3.28起已彻底移除该认证通道，强制切换至 Model Studio API Key 模式。
执行命令：openclaw onboard --auth-choice modelstudio-api-key → 按提示粘贴新获取的 Model Studio API Key → 选择对应模型版本（如 qwen-max、qwen-plus）。
注意：旧 portal.qwen.ai 页面生成的 OAuth Token 已完全失效，不可复用。
配置迁移的时效边界
第一步：检查配置时间戳
打开终端，运行 openclaw config show --raw，查看输出中 created_at 字段值。
第二步：判断是否在保留窗口内
若该时间早于 2026年7月20日，则此配置不被新版自动识别，启动时会直接报错并中断服务；必须删除旧配置文件 ~/.aionclaw/config.yaml，重新运行 openclaw onboard 初始化。
第三步：极旧密钥不再重写
对于 2025 年底前生成的密钥对（如 base64 编码长度为 32 字节的老式 token），新版加载器不再尝试兼容解码，而是直接拒绝加载——这一步没有警告，只会在日志里写入 invalid legacy auth key。
