OpenClaw提供四类日志排查方式：一、用openclaw logs命令实时查看；二、通过config.yaml配置持久化文件日志；三、设OPENCLAW_DEBUG=1启用全量调试日志；四、检查logs目录下按日期归档的历史日志文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要排查openclaw运行异常、技能未触发或会话中断等问题，则需实时查看其内部运行日志。openclaw提供多种日志访问方式，覆盖命令行即时输出、配置化持久记录及环境级底层调试三类路径。以下是具体操作步骤：一、使用openclaw logs命令查看实时日志流
该方式直接调用OpenClaw内置日志接口，无需修改任何配置文件，启动后立即生效，适用于快速定位当前会话中的错误、模型调用、工具执行等关键事件。
1、在终端中确保OpenClaw服务正在运行（可通过openclaw status确认）。
2、输入命令查看最近50行日志：openclaw logs --lines 50。
3、如需持续监听新增日志，添加--follow参数：openclaw logs --lines 50 --follow。
4、默认日志级别为INFO，仅显示关键事件；若需查看模型推理、上下文构建等详细过程，先执行openclaw config set log.level debug，再运行openclaw logs --follow即可看到含DEBUG标签的追踪信息。
二、通过配置文件启用日志持久化存储
当需要长期保留运行记录用于复盘或审计时，可修改OpenClaw配置，将日志自动写入本地文件系统，支持按天轮转与大小限制，避免磁盘空间被单个日志文件占满。
1、编辑配置文件：nano ~/.openclaw/config.yaml（Linux/macOS）或使用记事本打开%USERPROFILE%\.openclaw\config.yaml（Windows）。
2、在logging节点下添加以下内容：
file: true
path: ./logs/openclaw.log
maxSize: 10485760
maxBackups: 5
3、保存后重启OpenClaw服务：openclaw restart。
4、日志将按配置写入指定路径，可用tail -f ./logs/openclaw.log实时跟踪。
三、通过环境变量激活全量调试日志
当配置命令不可用（如权限受限、配置层被锁定）或需捕获HTTP请求原始体、模型推理耗时统计等隐藏信息时，可绕过配置系统，直接设置系统级环境变量启用底层日志能力。
1、在Linux/macOS中，启动前执行：export OPENCLAW_DEBUG=1。
2、在Windows PowerShell中，启动前执行：$env:OPENCLAW_DEBUG="1"。
3、随后运行openclaw start，所有调试日志将输出至控制台，包括完整HTTP请求头/体、工具执行耗时、向量检索原始得分等。
4、若需同时输出到文件，可组合使用：OPENCLAW_DEBUG=1 openclaw logs --follow > debug.log 2>&1。
四、检查日志目录中的历史归档文件
OpenClaw在启用文件日志后，默认按日期和大小自动归档旧日志，便于回溯特定时间段的运行状态，尤其适用于故障发生后无法实时连接终端的场景。
1、进入OpenClaw工作目录：cd ~/.openclaw（Linux/macOS）或cd %USERPROFILE%\.openclaw（Windows）。
2、列出日志子目录内容：ls -la logs/（Linux/macOS）或dir logs\（Windows）。
3、识别带日期后缀的压缩包（如openclaw-2026-04-03.log.gz），使用对应解压工具提取。
4、用文本编辑器打开解压后的日志文件，搜索关键词如ERROR、timeout、rejected快速定位异常段落。
