可通过五种方式获取QClaw后台运行日志：一、命令行启动并实时输出；二、检查默认日志文件路径；三、启用JSON格式结构化日志并重定向；四、通过systemd的journalctl查看；五、修改配置文件启用详细调试日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QClaw过程中遇到异常行为或功能失效，需定位具体原因，则可通过查看其后台运行日志获取调试信息与错误线索。以下是获取QClaw后台运行日志的多种操作方式：
一、通过命令行启动并实时输出日志
该方法适用于在终端中手动启动QClaw的场景，可直接捕获标准输出与标准错误流，便于即时观察运行状态与报错内容。
1、打开终端（Linux/macOS）或命令提示符/PowerShell（Windows）。
2、切换至QClaw可执行文件所在目录，例如：cd /opt/qclaw。
3、执行带调试参数的启动命令：./qclaw --log-level debug（Linux/macOS）或qclaw.exe --log-level debug（Windows）。
4、保持终端窗口开启，所有日志将实时打印在当前界面，关键错误行通常包含ERROR或panic字样。
二、检查默认日志文件路径
QClaw在后台静默运行时，默认会将日志写入预设的文件路径，该路径由内置配置决定，无需额外参数即可持久化记录。
1、确认QClaw运行用户身份，例如普通用户或systemd服务账户。
2、根据操作系统查找对应日志文件：~/.qclaw/logs/qclaw.log（Linux/macOS普通用户）、%APPDATA%\QClaw\logs\qclaw.log（Windows用户）、或/var/log/qclaw/qclaw.log（Linux系统级服务）。
3、使用文本查看工具读取日志内容，例如：tail -n 100 ~/.qclaw/logs/qclaw.log 或用记事本打开Windows日志文件。
三、启用JSON格式结构化日志并重定向输出
当需要对接日志分析工具或筛选特定字段（如时间戳、模块名、错误码）时，可强制QClaw输出JSON格式日志，并将其保存至指定文件以便解析。
1、停止当前正在运行的QClaw进程，确保无冲突写入。
2、执行启动命令并重定向输出：./qclaw --log-format json > /tmp/qclaw_debug.json 2>&1。
多模态论文可视化引擎，自动从 PDF 或纯文本生成学术插图，支持全篇扫描识别可图化内容、双编码器架构图/算法流程图/动机图生成、自校核、LaTeX/Word 图注输出、Matplotlib 精确绘图，并提供独立 PDF→Text 提取工具。
3、在另一终端中持续监控该文件变化：watch -n 1 'jq -r ".level + \" \" + .msg" /tmp/qclaw_debug.json 2>/dev/null | tail -n 5'。
四、通过systemd服务查看journald日志（仅Linux系统服务部署）
若QClaw以systemd服务方式运行，则其stdout/stderr会被journalctl自动捕获，无需依赖本地日志文件，且支持按时间、优先级精确过滤。
1、确认服务名称，通常为qclaw.service，可通过systemctl list-units | grep qclaw验证。
2、执行日志查询命令：journalctl -u qclaw.service -n 200 -o short-precise，显示最近200条带毫秒精度的日志。
3、如需仅查看错误级别日志，追加过滤参数：journalctl -u qclaw.service -p err --since "2024-01-01"。
五、修改配置文件启用详细调试日志
QClaw支持通过配置文件全局控制日志行为，修改后重启服务即可生效，适合长期调试或生产环境问题复现。
1、定位主配置文件，常见路径为：~/.qclaw/config.yaml 或 /etc/qclaw/config.yaml。
2、使用编辑器打开该文件，在logging节下添加或修改以下字段：
level: debug
file: /var/log/qclaw/debug_full.log
max_size: 104857600
3、保存文件后重启QClaw服务：systemctl restart qclaw 或重新执行可执行文件。
