更新失败应先查日志中403 Forbidden或404 Not Found错误：前者多因CDN拦截无User-Agent的请求，后者系版本下架或路径错误；需核对平台架构、下载对应安装包，走手动安装通道，并检查config.yaml与skills/兼容性。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

更新失败时先看日志里有没有 403 Forbidden 或 404 Not Found

这两个错误最常见，说明 AionClaw 没法从远程服务器拉取新版安装包。不是本地网络断了，而是请求被拒绝或路径根本不存在。

原因通常是：AionClaw 默认尝试从 GitHub 或 GitCode 的原始 release 地址下载，但国内访问不稳定；或者你用的是私有部署版，更新源没配对；又或者当前版本太老，官方已下架旧版安装包链接。

• 403 Forbidden：大概率是用了镜像站或代理，但目标 CDN 拦截了非浏览器 User-Agent，AionClaw 的更新请求没带伪装头
• 404 Not Found：检查你当前运行的版本号（比如 v2.0.0），去 AionUi 项目页 的 Releases 列表确认该版本是否还存在——有些测试版发布后会被撤回
• 别信界面上“检查更新”按钮显示的“发现新版本”，它只比对 version.json，不校验安装包实际可下载性

手动下载安装包前，必须核对平台标识和架构类型

AionClaw 的更新包不是通用二进制，Windows/macOS/Linux 各自分开，而且 macOS 还要区分 arm64（M 系列芯片）和 x64（Intel 芯片）。填错一个字母，安装器会静默失败，连错误提示都不给。

AionClaw

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

下载

• 打开终端或命令行，执行 uname -m（Linux/macOS）或 echo %PROCESSOR_ARCHITECTURE%（Windows CMD）确认架构
• 在 AionUi 设置页「关于 & 检查更新」模块里，留意右下角显示的平台字符串，例如 darwin-arm64 或 win32-x64，这个就是你要找的包名后缀
• 不要下载 .zip 源码包，要找 .dmg（macOS）、.exe（Windows）、.AppImage（Linux）这类可执行安装包

跳过自动更新，改用双路径更新机制中的手动通道

AionUi 实际内置了双路径更新逻辑：自动拉包 + 手动导入。很多用户卡在自动失败就以为“不能更新”，其实可以直接走手动通道绕过所有网络校验。

• 在设置页「关于 & 检查更新」里，找到「手动安装」按钮（不是「检查更新」），点击后会弹出文件选择框
• 把刚才下载好的正确平台安装包拖进去，AionClaw 会校验签名并直接覆盖安装，不走任何 HTTP 请求
• 注意：手动安装不会自动重启，装完要自己关掉当前窗口再双击桌面图标重进
• 如果弹出“签名不可信”警告，macOS 用户需到「系统设置 → 隐私与安全性」下滑到底，点“仍要打开”；Windows 用户右键安装包 → 属性 → 勾选“解除锁定”

更新后功能异常？重点检查 skills/ 目录和 config.yaml 兼容性

新版本往往调整了技能加载逻辑或配置项结构，但不会自动迁移老配置。界面能启动，不代表技能能跑通。

• 更新后首次启动，立刻打开开发者工具（Ctrl+Shift+I），切到 Console 标签，看有没有 Failed to load skill 或 config.yaml parse error
• 对比新旧版本的 config.yaml 结构，尤其关注 model: 下的 base_url 和 api_key 字段——v2.0.0 开始要求 base_url 必须以 /api 结尾，不能带 /v1
• 旧版 skills/ 目录下的 SKILL.md 若含已废弃的字段（如 timeout_ms 改成 timeout），会导致整个技能加载失败，建议先清空该目录再重新导入

更新失败真正难缠的地方不在下载环节，而在配置迁移和技能兼容性上。自动更新只是个触发器，背后那一整套配置、技能、模型通道的耦合关系，才是升级后出问题的高发区。