应关闭qoderwake后台自动更新机制以保障数字员工稳定性，具体方法包括：一、控制台禁用自动更新；二、修改config.yaml屏蔽更新端点；三、阻断更新域名解析；四、通过connector权限沙盒冻结更新能力；五、私有化集群中禁用fota通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake过程中发现其频繁检查或下载新版本，导致身份配置、记忆上下文或权限红线策略被意外重置，影响数字员工在生产环境中的长期运行稳定性，则可能是QoderWake默认启用了后台自动更新机制。以下是关闭该功能的具体操作方法：
一、通过QoderWake控制台禁用自动更新
该方式利用QoderWake官方提供的Web管理界面直接修改运行时策略，适用于所有已部署Agent实例的用户，无需接触底层配置文件，操作可逆且实时生效。
1、使用管理员账号登录QoderWake控制台（默认地址为https://localhost:8080，或您部署时指定的域名）。
2、在左侧导航栏中点击「系统设置」→「更新与维护」。
3、找到「启用自动版本检测」开关，将其切换为关闭状态。
4、取消勾选「允许静默下载更新包」和「自动应用热修复补丁」两项复选框。
5、点击页面底部的「保存配置并重启Agent服务」按钮，确认执行后等待服务状态恢复为“运行中”。
二、修改config.yaml强制屏蔽更新端点
此方法通过修改QoderWake主配置文件，从启动参数层面禁用全部更新逻辑，适用于控制台不可达、服务崩溃或需批量部署锁定版本的场景，作用于进程初始化阶段。
1、停止QoderWake服务：在Linux/macOS终端中执行sudo systemctl stop qoderwake；在Windows中通过服务管理器结束“QoderWake Agent Service”进程。
2、定位配置文件：打开安装目录下的config.yaml（典型路径为/opt/qoderwake/config.yaml或C:\Program Files\QoderWake\config.yaml）。
3、使用支持YAML语法的编辑器（如VS Code、Notepad++）打开该文件。
4、查找字段auto_update:，将其值由true改为false。
5、在update:节点下新增两行配置：
disable_update_endpoint: true
update_check_interval: 0
6、保存文件，执行sudo systemctl start qoderwake（Linux/macOS）或重启Windows服务，使配置加载生效。
三、阻断更新域名解析（网络层隔离）
该方案在操作系统DNS解析层拦截QoderWake向阿里云更新服务器发起的HTTP/HTTPS请求，不依赖软件内部逻辑，即使配置被覆盖或重装亦持续生效，适用于企业级安全合规场景。
1、以管理员权限打开终端（Windows为命令提示符或PowerShell，Linux/macOS为root终端）。
2、编辑hosts文件：
Windows路径为C:\Windows\System32\drivers\etc\hosts；
Linux/macOS路径为/etc/hosts。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在文件末尾新增一行：
127.0.0.1 update.qoderwake.aliyuncs.com
4、保存文件，执行ipconfig /flushdns（Windows）或sudo dscacheutil -flushcache（macOS）、sudo systemd-resolve --flush-caches（Linux）刷新DNS缓存。
5、重启QoderWake服务，验证日志中不再出现GET https://update.qoderwake.aliyuncs.com/v1/check类请求记录。
四、通过Connector权限沙盒冻结更新能力
QoderWake的权限红线机制允许将特定工具调用行为标记为禁止项，本方法将更新检查API调用列入沙盒黑名单，从能力维度彻底移除Agent发起更新动作的可能性，符合其“有红线”的设计原则。
1、进入QoderWake控制台，点击「权限管理」→「Connector策略」。
2、在搜索框中输入update，定位到名为aliyun-update-checker的内置Connector。
3、点击其右侧「编辑策略」，在「可用操作」列表中取消勾选check_version与download_patch两项。
4、在「适用角色」中选择当前部署的所有Agent身份（如“数字程序员”“运维协作者”等）。
5、勾选「启用强制拒绝策略」，点击「提交并同步至运行时」。
6、返回「Agent监控」页面，对任一在线实例点击「触发策略重载」，确保沙盒规则即时注入。
五、禁用FOTA通道（仅限私有化部署集群）
针对采用Kubernetes或Docker Compose部署的QoderWake高可用集群，可通过关闭底层固件式空中升级（FOTA）通道，阻断Operator组件对Agent镜像版本的主动拉取与滚动更新，保障整个集群镜像版本统一且不可变。
1、登录集群管理控制台（如Rancher、OpenShift或自建Argo CD界面）。
2、定位QoderWake命名空间（通常为qoderwake-prod或agent-system）。
3、查找名为qoderwake-operator的Deployment资源，点击进入YAML编辑模式。
4、在env:环境变量区块中，添加以下两行：
- name: ENABLE_FOTA
value: "false"
- name: DISABLE_IMAGE_AUTO_SYNC
value: "true"
5、保存变更，等待Operator Pod重建完成，观察其日志中不再输出FOTA sync triggered或pulling new agent image字样。
