OpenClaw 日志排查需区分 Application 与 Session 两类：CLI 实时查看用 openclaw logs --follow；过滤警告/错误用 --level warn/error；JSON 结构化分析配合 jq；openclaw doctor 执行健康诊断；Session 日志存于 ~/.openclaw/agents/main/sessions/ 下 JSONL 文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试排查 OpenClaw 运行异常、AI 响应错误或工具调用失败等问题，日志是唯一可信赖的原始依据。OpenClaw 将系统行为与 AI 决策分离记录，需明确区分两类日志来源及其访问路径。以下是查看 OpenClaw 日志的具体方法：
一、使用 CLI 实时查看 Application 日志
Application 日志反映 OpenClaw 核心服务（Gateway、Agent 初始化、插件加载、HTTP 请求处理等）的运行状态，适合快速确认服务是否启动、端口是否监听、配置是否加载成功。
1、在终端中执行命令：openclaw logs --follow
2、该命令将持续输出最新日志，包含时间戳、模块名、日志等级及消息体。
3、如需中断输出，按 Ctrl+C 即可退出实时流。
二、筛选高优先级日志（警告与错误）
当日志量过大、INFO 级别信息干扰判断时，可通过日志等级过滤机制聚焦问题线索，避免人工扫描海量输出。
1、执行命令：openclaw logs --level warn
2、该命令仅显示 level 为 WARN 或 ERROR 的日志条目。
3、若需进一步限定为仅 ERROR，可改用：openclaw logs --level error
三、以 JSON 格式导出并结构化分析
JSON 输出便于程序解析与字段筛选，适用于需要定位特定会话 ID、工具名称、错误堆栈或响应耗时等结构化字段的场景。
1、执行命令：openclaw logs --json
2、配合 jq 工具提取含错误信息的完整日志对象：openclaw logs --json | jq 'select(.level == "ERROR")'
3、若要查看某次会话中所有工具调用记录，可筛选字段：openclaw logs --json | jq 'select(.event == "tool_call")'
四、运行诊断命令自动识别常见问题
doctor 命令不直接输出日志，而是基于日志上下文与系统状态执行多维度健康检查，将潜在隐患转化为可读性高的诊断报告。
1、执行基础诊断：openclaw doctor
2、该命令会检测 Docker 守护进程状态、Gateway 端口占用、配置文件完整性、关键目录权限等。
3、如需自动修复部分可恢复项（如缺失配置模板、目录权限异常），追加 --fix 参数。
五、直接读取 Session 日志文件
Session 日志是 AI 调用过程的“黑匣子”，以 JSONL 格式存储每次对话的完整输入、推理步骤、工具调用参数与返回结果，路径固定且可预测，适用于深度回溯单次交互失败原因。
1、进入默认 Agent 的 sessions 目录：cd ~/.openclaw/agents/main/sessions/
2、列出最近生成的会话文件：ls -t *.jsonl | head -n 5
3、用 cat 或 less 查看最新会话内容：cat $(ls -t *.jsonl | head -n1)
