☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
需手动启用openclaw网关自动更新功能，支持配置文件、cli命令和webui三种方式，均需指定更新通道、延迟与抖动参数，并重启服务或重载配置以生效。
如果您已部署 openclaw 网关服务，但希望其在后台自动检测并应用新版本更新，则需显式启用自动更新功能。该功能默认处于关闭状态，需通过配置文件或 cli 命令手动开启并指定更新策略。以下是启用自动更新的具体操作路径：
一、通过配置文件启用自动更新
OpenClaw 的自动更新由 Gateway 核心模块原生支持，配置项位于主配置文件中，修改后需重启网关服务方可生效。配置内容控制更新通道、触发时机与抖动策略，确保升级行为稳定可控。
1、使用文本编辑器打开 OpenClaw 主配置文件，路径通常为 ~/.openclaw/config.json 或 ./config.json（当前工作目录下）。
2、在配置文件根对象内查找 "update" 字段；若不存在，则在顶层添加该字段及其嵌套结构。
3、将以下 JSON 片段完整写入配置文件，替换原有 update 部分（如存在）：
4、保存文件后，执行 openclaw gateway --restart 重启网关服务，使配置生效。
二、通过 CLI 命令动态启用自动更新
无需手动编辑 JSON 文件，可直接调用内置命令写入配置并触发重载，适用于脚本化部署或快速验证场景。该方式会覆盖已有 update 配置，且立即提交至运行时环境。
1、在终端中执行命令启用稳定通道自动更新，并设置基础延迟参数：openclaw config set update.auto.enabled true。
2、设定稳定版更新首次检查延迟（单位：小时）：openclaw config set update.auto.stableDelayHours 6。
3、设定稳定版更新随机抖动范围（单位：小时），用于分散集群内更新时间：openclaw config set update.auto.stableJitterHours 12。
4、指定默认更新通道为 stable：openclaw config set update.channel stable。
5、执行 openclaw config reload 强制重新加载配置，使自动更新模块开始监听。
三、通过 WebUI 图形界面启用自动更新
对于不熟悉命令行的用户，WebUI 提供了可视化开关与参数输入框，所有修改均经校验后写入配置文件，并提示是否立即重启服务。该方式避免手动编辑错误，适合生产环境谨慎操作。
1、确保网关服务正在运行，访问 WebUI 地址（如 http://localhost:3000 或云实例公网地址）。
2、使用有效 token 登录后，进入「系统设置」→「版本管理」页面。
3、向下滚动至「自动更新设置」区域，勾选「启用自动更新」开关。
4、在「更新通道」下拉菜单中选择 stable、beta 或 dev 之一。
5、填写「稳定版延迟小时数」和「稳定版抖动小时数」数值框，确认无误后点击「保存配置」按钮。
6、页面弹出提示要求重启网关以应用变更，点击「立即重启」完成启用流程。
四、验证自动更新是否已激活
启用操作完成后，必须验证自动更新模块是否真正加载并注册定时任务。验证结果可通过日志输出与配置回读双重确认，排除因权限、路径或语法错误导致的静默失败。
1、执行状态检查命令，查看 update 段是否显示 enabled:true：openclaw status | grep -A 5 "update"。
2、查看网关运行日志末尾，搜索关键词 "auto-update scheduled" 或 "next check in"。
3、在 WebUI「版本管理」页刷新页面，确认「自动更新状态」栏显示为 已启用 并列出下次检查时间。
4、手动触发一次模拟检查（不执行更新），运行：openclaw update --dry-run --channel stable，观察是否返回通道匹配与版本差异信息。
