QClaw服务异常时，可通过四种方式查看日志：一、内置管理面板实时查看；二、读取本地logs目录下qclaw-current.log等文件；三、终端命令行tail或Get-Content追踪；四、微信发送/log last error获取错误摘要。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已完成QClaw部署但无法确认服务是否正常启动，或需排查配置失败、微信未响应、模型调用超时等问题，则需定位并查看QClaw运行时生成的日志文件。以下是多种可直接操作的日志查看方法：
一、通过QClaw内置管理面板查看实时日志
QClaw桌面应用集成可视化管理界面，启动后自动托管本地Web服务，日志以流式方式实时推送至前端控制台，无需命令行操作。
1、确保QClaw应用已成功启动，托盘图标显示为绿色状态。
2、点击系统托盘中的QClaw图标，选择“打开管理面板”，浏览器将自动打开http://127.0.0.1:8080页面。
3、在面板左侧导航栏中，点击“运行日志”选项卡。
4、页面顶部可切换日志级别（INFO/DEBUG/WARN/ERROR），默认显示最近200条滚动日志。
5、如需导出当前日志，点击右上角“下载日志快照”按钮，保存为qclaw-log-YYYYMMDD-HHMMSS.txt格式文件。
二、直接读取本地日志文件路径
QClaw遵循标准日志存储规范，在安装目录下固定生成结构化日志文件，适用于离线分析或配合第三方工具做关键词检索。
1、打开QClaw安装根目录，Windows系统默认路径为：C:\Users\[用户名]\AppData\Local\QClaw\logs\。
2、macOS系统默认路径为：~/Library/Application Support/QClaw/logs/。
3、进入logs子目录，可见按日期命名的压缩日志包（如qclaw-20260312.zip）及当日未压缩的qclaw-current.log。
4、使用文本编辑器（如VS Code、Notepad++）直接打开qclaw-current.log，搜索关键词"wechat connected"或"model loaded"快速定位关键事件。
三、通过终端命令行实时追踪日志流
该方法适用于高级用户或自动化脚本集成场景，可实现日志持续监听、错误高亮、管道过滤等操作。
1、在Windows PowerShell中执行：Get-Content "$env:LOCALAPPDATA\QClaw\logs\qclaw-current.log" -Wait。
2、在macOS终端中执行：tail -f ~/Library/Application\ Support/QClaw/logs/qclaw-current.log。
3、若需仅显示错误行，追加过滤参数：| grep -i "error\|fail\|panic"。
4、按Ctrl+C可中断实时追踪，返回命令行提示符。
四、微信端触发日志上报并查看摘要
QClaw支持通过微信对话主动拉取最近一次异常会话的上下文日志摘要，适用于远程诊断且无本地访问权限的场景。
1、在已绑定QClaw的微信对话中，向机器人发送指令：/log last error。
2、等待约3秒，QClaw将自动回复一条含时间戳、错误类型、关联模块（如wechat、model、storage）的精简摘要。
3、若需完整日志，回复消息中附带的“点击查看完整日志”链接，点击后跳转至管理面板对应日志段落。
4、该功能仅对绑定微信账号开放，且仅上报最近1小时内发生的ERROR级别事件。
