QClaw历史会话日志按日期归档于YYYY-MM-DD命名的文件夹中，用于精准回溯交互、排查异常；需定位%APPDATA%\QClaw\logs（Windows）或~/Library/Application Support/QClaw/logs（macOS），打开对应日期文件夹，优先查阅main.log或gateway.log+agent-*.log，通过时间戳搜索定位会话起止及错误点，导出为zip供离线分析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QClaw历史会话日志按日期归档，是为了方便你回溯某天的具体交互过程、排查当天模型响应异常或微信消息未送达等问题，而不是靠滚动当前日志去猜哪条出错了。
定位日志根目录并进入日期子目录
Windows用户按下 Win + R，输入 %APPDATA%\QClaw\logs 回车；macOS用户打开终端，执行 open ~/Library/Application\ Support/QClaw/logs/。这一步必须做对，否则后续所有操作都找不到文件。
进入该目录后，你会看到多个以 YYYY-MM-DD 格式命名的文件夹（如 2026-06-17）、一个 latest 文件夹，以及若干 qclaw-current.log 或 main.log 文件。【历史会话日志只存在于 YYYY-MM-DD 命名的文件夹内，latest 是当前会话软链接，不存归档数据】。
双击打开目标日期文件夹，例如今天是2026年6月18日，你想查昨天的会话，就点开 2026-06-17。
识别并打开当天的有效日志文件
方法一：找带时间戳的 main.log 文件
该文件记录网关层完整通信流，包含微信握手、消息路由、模型调用请求与响应，是还原会话链路最全的日志。直接双击用记事本或 VS Code 打开即可。
方法二：找 gateway.log + agent-*.log 组合
gateway.log 负责渠道接入，agent-xxx.log 记录对应AI代理的推理细节。若你怀疑是某个特定技能（比如“写周报”）失败，优先打开匹配的 agent-*.log；若问题出现在微信扫码后无响应，则 gateway.log 更关键。
注意：不要打开 .zip 压缩包——它们是系统自动打包的归档副本，已压缩不可直接阅读；解压后内容与同名文件夹内一致，纯属冗余备份。
在日志中快速定位某次会话的起止范围
第一步：搜索会话发起时间点
在日志文件中按 Ctrl+F（Windows）或 Cmd+F（macOS），输入类似 [2026-06-17 14:22: 的精确时间片段（时分秒前两位即可）。QClaw日志严格按 ISO 8601 格式打时间戳，每条记录开头都是 [YYYY-MM-DD HH:MM:SS]。
第二步：顺着时间戳向下扫，找到首个包含 wechat message received 或 incoming msg from 的行——这就是该次会话的起点。
第三步：继续往下看，直到出现 response sent to wechat 或 session closed，中间所有日志即为本次会话的完整执行路径。若中途出现 ERROR 或 panic，说明卡点就在这里。
这一步不能靠眼睛硬扫，必须用搜索跳转；日志里每秒可能产生数十行，手动滚动极易漏掉关键报错行。
导出某天全部日志用于离线分析
选中目标日期文件夹（如 2026-06-17），右键 → “发送到” → “压缩(zipped)文件夹”（Windows）或按 Cmd+Shift+Z（macOS）。
压缩完成后，将生成的 2026-06-17.zip 文件发给同事或技术支持。他们可用命令行批量 grep：zgrep -i "error\|fail" 2026-06-17.zip，5秒内筛出全部异常。
别用截图！截图无法复制文本、无法搜索、无法定位行号，技术支援看到就直接跳过。
