QClaw功能异常需按五步排查：一、启用微信客服消息并完成扫码激活；二、配置OpenClaw工具权限为full并重启网关；三、确保Ollama服务运行且config.yaml中ollama_base_url地址正确；四、访问http://localhost:8090并禁用CSP策略修复白屏；五、在config.yaml中将tts.enabled设为false以阻止误触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装并关联QClaw，但部分核心功能（如微信远程操控、文件管理、技能调用等）无法响应或报错，则可能是由于配置冲突、权限限制、服务依赖缺失或通信链路中断所致。以下是针对QClaw功能异常的多种排查与修复路径：
一、检查微信客服消息入口是否正确启用
QClaw在微信中以客服形式存在，不显示于主聊天列表，需手动进入客服消息页才能触发交互。若未在微信中完成有效绑定或入口被折叠，将导致所有远程指令失效。
1、打开微信，点击右下角“我” → 进入“设置” → “新消息通知” → 确保“客服消息”开关已开启。
2、返回微信首页，点击右上角“+”号 → 选择“添加朋友” → 在搜索框输入“QClaw” → 若未出现结果，说明未完成首次扫码绑定。
3、回到QClaw桌面客户端左下角弹窗，重新点击“配置微信远程控制”，刷新二维码并用手机微信扫描。
4、扫码后，微信将跳转至客服对话页，必须在此页面内发送任意文字（如“你好”）完成会话激活，否则QClaw后台不会建立长连接。
二、验证OpenClaw网关与工具权限配置
QClaw依赖本地OpenClaw网关提供技能调度能力。2026.3.2版本起，默认工具执行权限被设为受限模式，即使技能已安装，也会返回“我没有权限执行此操作”提示。
1、确保QClaw客户端正在运行，并观察系统托盘图标是否为绿色常亮状态；若为灰色，右键选择“重启服务”。
2、打开命令行终端（Windows：PowerShell；Mac：Terminal），执行：openclaw configsettools.profile full。
3、执行完成后，返回QClaw客户端界面，点击右上角齿轮图标 → “重启网关” → 等待状态栏显示“网关已就绪”。
4、在微信客服对话中发送测试指令，例如“列出当前桌面文件”，确认是否恢复响应。
三、排查Ollama模型服务连接异常
QClaw依赖Ollama作为本地大模型推理后端，若Ollama未运行、监听地址错误或网络不可达，将导致所有AI对话与技能生成失败，日志中常见“could not connect to ollama server”错误。
1、在终端中运行：ollama list，确认至少有一个模型（如qwen2:7b）处于loaded状态。
2、若无输出或报错，执行：OLLAMA_HOST=0.0.0.0:11434 ollama serve 启动服务并强制绑定全网卡。
3、在QClaw安装目录下找到config.yaml，定位到ollama_base_url字段，将其值修改为：http://host.docker.internal:11434（Windows/macOS）或http://[宿主机局域网IP]:11434（Linux）。
4、保存配置后，在QClaw客户端中点击“重载配置”，再尝试微信发送“天气预报”等带Skill调用的指令。
四、修复面板白屏或技能界面加载失败
QClaw内置Web控制台（默认http://localhost:8080）若出现空白页或无限转圈，通常由Docker监听地址错误、端口被占或CSP策略拦截引起，直接影响技能调试与状态查看。
1、关闭QClaw客户端，打开任务管理器（Windows）或活动监视器（Mac），结束所有名为“docker”、“ollama”、“qclaw”的进程。
2、重新启动QClaw，等待托盘图标亮起后，打开浏览器访问：http://localhost:8090（QClaw默认将内部8080映射至8090以规避冲突）。
3、若仍白屏，在浏览器开发者工具（F12）Console标签页中查看报错；若出现CSP相关警告，说明本地安全策略阻止了内联脚本加载。
4、临时解决方法：在QClaw安装目录的config.yaml中，将server.csp_enabled设为false，保存后重启客户端。
五、处理TTS误触发导致文字回复中断
当QClaw在应返回纯文本时突然输出音频流（如Base64编码的wav片段），表明TTS模块被意外激活，干扰正常文本交互流程，尤其影响微信消息解析与文件内容提取类技能。
1、定位QClaw安装路径下的config.yaml文件，使用文本编辑器打开。
2、搜索关键词“tts”，找到modules.tts区块。
3、将其中enabled字段明确设为：enabled: false，注意冒号后必须保留一个空格。
4、检查该行缩进是否与其他modules层级一致（通常为2个空格），YAML格式错误会导致整个配置加载失败。
5、保存文件，右键QClaw托盘图标 → “重载配置”，随后在微信中发送“测试文字”验证是否稳定返回文本。
