必须获取结构化日志才能定位问题，首选内置管理面板实时查看；其次启用tool_debug日志排查工具调用失败；再通过本地文件grep快速检索错误；最后可用微信指令/log last error秒级获取最近致命错误摘要。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
排查QClaw服务异常、工具调用失败或微信无响应时，必须获取结构化、可追溯的运行日志，否则无法定位是模型连接中断、权限拒绝还是沙箱拦截导致的问题。
通过内置管理面板实时查看日志
这是最直观的方式，适合刚启动QClaw、尚未配置任何外部日志路径的用户，无需命令行操作，所有日志以流式方式在浏览器中滚动呈现。
1、确保QClaw托盘图标为绿色，表示核心服务已就绪；
2、右键点击系统托盘中的QClaw图标，选择“打开管理面板”，浏览器将自动跳转至 http://127.0.0.1:8080；
3、点击左侧导航栏的“运行日志”，页面默认加载最近200条INFO及以上级别日志；
4、若需聚焦错误，顶部下拉选择“ERROR”级别，此时仅显示panic、timeout、permission denied等关键报错行；
5、点击右上角“下载日志快照”，文件名形如qclaw-log-20260615-215302.txt，【该文件不含敏感认证信息，但包含完整时间戳与堆栈，可用于向技术支持提交】。
启用调试日志并定位工具调用问题
当工具（如file_search.py）始终返回空结果或提示“未找到工具”，说明注册或执行环节出错，必须开启tool_debug日志才能暴露真实原因。
方法一：终端临时启用（推荐首次调试）
在启动前执行：export QCLAW_TOOL_DEBUG=1 && openclaw；这会强制QClaw在~/.openclaw/logs/tool_calls.log中记录每次工具入参、出参及子进程退出码。
方法二：配置文件持久启用
编辑~/.openclaw/config.yaml，在根级添加：
logging:
tool_calls: true
这一步操作起来很简单，直接把配置加进去就行。但要注意：【日志开启后首次调用会多耗时120–300ms，上线前务必删除该配置】。
从本地文件读取结构化日志
适用于离线分析、关键词批量检索或配合grep/awk做自动化筛选的场景，日志文件按日期归档，当日内容写入qclaw-current.log。
第一步：确认QClaw运行用户身份——普通用户日志在~/.qclaw/logs/，systemd服务则在/var/log/qclaw/；
第二步：进入对应logs目录，用ls -lt查看最新文件，重点关注qclaw-current.log；
第三步：执行tail -n 50 qclaw-current.log | grep -i "error\|fail\|tool"，快速提取最近50行中含错误或工具关键词的日志片段；
第四步：若发现某次工具调用后紧跟exit code 137，说明被沙箱OOM killer终止，需检查tool_policy.yaml中memory_limit设置。
通过微信端快速获取错误摘要
当你正在开会、无法切换到电脑，又急需知道QClaw是否挂了，这个方法能在3秒内获得最近一次致命错误的精简描述。
在已绑定的微信对话中，直接发送文本：/log last error；
QClaw将在10秒内回复一条消息，格式为：[2026-06-15 21:48:33] ERROR tool_call file_search.py: Permission denied: /home/user/Downloads/report.pdf；
该指令不触发完整日志输出，仅提取最近一条ERROR级别记录，【不依赖本地网络，只要微信通道畅通即可生效】。
