启用stable通道自动更新需同时设置update.auto.enabled为true且update.channel为"stable",并配置stabledelayhours与stablejitterhours,修改~/.aionclaw/config.json后重启客户端,日志出现“auto-update enabled for channel: stable”即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

默认不开启自动更新,必须手动修改配置才能生效;Web UI 和 CLI 两种入口都能改,但底层都写入同一份 JSON 配置文件。
怎么启用 stable 通道的自动更新
稳定版自动更新依赖 update.auto.enabled 和 update.channel 两个关键字段。只开 enabled:true 不够,如果 channel 还是空或错写成 latest,实际不会拉取任何更新。
- 编辑配置文件:
~/.aionclaw/config.json(Linux/macOS)或%APPDATA%\AionClaw\config.json(Windows) - 确保包含以下结构(注意缩进和逗号):
{ "update": { "channel": "stable", "auto": { "enabled": true, "stableDelayHours": 6, "stableJitterHours": 12 } } } - 保存后重启 AionClaw 客户端,启动日志里会出现
Auto-update enabled for channel: stable才算真正生效
beta 通道更新频率怎么调
beta 用户更关注新功能落地速度,betaCheckIntervalHours 控制检查间隔,默认是 1 小时。设太小会频繁请求 GitHub API,可能触发限流;设太大又容易错过热修复。
- 该参数只在
channel: "beta"时起作用,stable模式下完全忽略它 - 推荐值:开发测试期设为
0.5(30 分钟),日常使用保持1即可 - 修改后无需重启,下次检查周期到来时自动按新值执行
Docker 部署下自动更新为什么不起作用
容器内运行时,openclaw update 命令本身能执行,但自动更新触发器常因权限或路径问题静默失败——尤其当容器以非 root 用户启动、且挂载的 config.json 是只读时。
- 确认挂载卷权限:用
docker exec -it aionclaw ls -l ~/.aionclaw/查看 config.json 是否可写 - 检查日志关键词:
Failed to write update config或Permission denied writing to /root/.aionclaw/config.json - 临时解决:进容器手动执行
openclaw update,再openclaw gateway restart;长期建议在 docker-compose.yml 中加user: "root"或修复挂载权限
自动更新不是“设完就完事”,最常被忽略的是 stableJitterHours 的作用:它让同一批用户不会在同一秒涌向更新服务器,而是分散在指定时间窗内完成安装。如果你在集群中管理几十台设备,这个抖动值直接影响你后端 CDN 和 GitHub Release 的负载压力。











