QClaw配置修改未生效需按五步操作：一、重启主进程；二、执行qclawctl reload config命令；三、清除Cache缓存及config.json.bak；四、校验config.json语法与字段格式；五、回滚至config.json.lastgood快照。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成QClaw配置修改，但新设置未在实际运行中体现，则可能是配置未正确加载、缓存未清除或服务未重启所致。以下是使QClaw配置修改立即生效的具体操作方法：
一、重启QClaw主进程
QClaw采用热加载机制，但部分关键配置（如模型路由地址、微信接入开关、tools.profile级别）需完全重启主进程才能生效。直接关闭并重启动态服务可强制重新读取全部配置文件。
1、点击系统任务栏右下角QClaw图标，选择“退出”或“Quit”选项；
2、确认弹窗中点击“确定”以终止所有后台进程；
3、重新双击桌面或应用程序目录中的QClaw快捷方式启动；
4、启动完成后，观察左下角状态栏是否显示“已就绪”及微信连接图标是否恢复亮起。
二、手动触发配置重载命令
QClaw内置配置热重载接口，适用于已部署为系统服务或通过终端启动的用户。该方式无需中断当前会话，可快速刷新模型参数、技能启用状态等非核心安全配置。
1、打开终端（macOS 使用 Terminal，Windows 使用 PowerShell 或 CMD）；
2、执行命令：qclawctl reload config；
3、等待终端返回“Config reloaded successfully”提示；
4、在QClaw主界面右上角点击“刷新”按钮，验证对话窗口右下角模型标识是否更新为新配置值。
三、清除QClaw本地配置缓存
QClaw会在首次启动时将解析后的配置写入本地缓存目录（如 macOS 的 ~/Library/Caches/QClaw/，Windows 的 %LOCALAPPDATA%\QClaw\Cache\），若缓存文件损坏或版本不匹配，会导致修改被忽略。
1、关闭QClaw应用；
2、定位并删除对应系统的缓存文件夹：QClaw/Cache/；
3、同步删除同级目录下的 config.json.bak 备份文件（避免旧备份覆盖新配置）；
4、重新启动QClaw，此时应用将强制从主配置文件 config.json 重建缓存。
四、检查配置文件语法与路径有效性
QClaw仅加载位于标准安装路径下的 config.json 文件，且要求严格符合 JSON 格式。任意逗号遗漏、引号不闭合或字段名拼写错误均会导致整份配置被跳过，回退至默认值。
1、使用 VS Code 或 Notepad++ 打开安装目录下的 config.json；
2、按 Ctrl+Shift+I（Windows）或 Cmd+Shift+I（macOS）校验 JSON 语法；
3、确认 "model_endpoint" 字段值为完整 HTTPS URL，且不含中文空格或全角符号；
4、检查 "wechat_enabled" 值为 true 或 false（小写，无引号）；
5、保存后执行“重启QClaw主进程”步骤以确保加载。
五、回滚至上次有效配置
当多次修改导致配置异常且无法定位错误时，QClaw自动保留最近一次成功加载的配置快照，可通过内置回滚机制快速恢复可用状态。
1、确保QClaw处于关闭状态；
2、进入安装目录，查找名为 config.json.lastgood 的文件；
3、将该文件重命名为 config.json，覆盖当前配置；
4、启动QClaw，观察日志窗口是否输出“Loaded config from lastgood snapshot”；
5、登录微信扫码重新关联，验证基础指令是否恢复正常响应。
