必须立刻打开可视化日志面板定位问题根源，通过托盘龙虾图标→右键选「打开管理面板」→访问http://127.0.0.1:8080→切换至error/warn级别→用搜索框查wechat connected/model loaded/permission denied等关键词→导出带时间戳的日志快照发送给支持。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QClaw桌面应用已启动但微信无响应、模型加载失败或指令执行卡住时，必须立刻打开可视化日志面板定位问题根源，而不是反复重启或重绑微信。
通过托盘图标快速打开日志面板
这一步操作起来很简单，直接点击任务栏右下角的龙虾图标就行。
1、确认QClaw托盘图标为绿色（非灰色或闪烁状态），表示服务正在运行；
2、右键点击该图标，在弹出菜单中选择「打开管理面板」；
3、浏览器将自动跳转至 http://127.0.0.1:8080，若页面空白或报错404，请先检查是否被系统防火墙拦截本地端口；
4、进入后左侧导航栏点击「运行日志」，默认加载最近200条INFO级别日志；
5、页面顶部可切换日志级别——遇到功能异常时，务必点开「ERROR」或「WARN」，【90%以上的连接失败和模型加载超时都集中在这两个级别里】。
在日志面板中精准定位关键事件
日志滚动太快看不清？别用眼睛扫，用搜索框直接查关键词。
方法一：查微信连接状态
在面板右上角搜索框输入 wechat connected，回车。若无结果，说明微信扫码后未完成握手，需重新绑定；
方法二：查模型加载完成信号
搜索 model loaded 或 LLM ready，出现该行才代表AI核心已就绪，否则所有指令都会返回“模型未就绪”；
方法三：查文件路径错误（高频坑）
搜索 permission denied 或 no such file，常见于用户把QClaw装在加密盘、OneDrive同步目录或权限受限的Program Files路径下，【此时需卸载并重装到D:\QClaw或~/Applications/QClaw等标准用户可写路径】。
导出日志快照用于远程协助
当你需要把问题发给技术支持或群友帮忙分析时，截图没用，必须导出原始日志。
1、确保当前日志面板已切换到「ERROR」级别，并手动向上滚动查看完整上下文；
2、点击右上角「下载日志快照」按钮；
3、文件自动保存为 qclaw-log-YYYYMMDD-HHMMSS.txt 格式，命名含精确时间戳；
4、将该文件直接拖进微信对话框发送即可，无需压缩或改名——技术支持能从中提取进程ID、错误堆栈和系统环境变量。
