openclaw服务异常时应通过日志定位原因：用openclaw logs --follow实时查看，或查本地日志文件（路径由openclaw config get log.file指定，默认~/.openclaw/logs/openclaw.log）；遇功能异常需启用debug日志；大日志可用grep、--since、--json等命令过滤导出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw本地部署后无法判断服务是否正常启动、AI响应卡顿或技能调用失败，必须通过运行日志定位真实原因，而不是靠重启或猜配置。
用CLI命令实时查看日志流
这一步操作起来很简单，直接在终端执行命令就能看到最新输出，适合刚启动服务时快速验证。
确保 OpenClaw gateway 已运行（可通过 openclaw status 确认），然后执行：
openclaw logs --follow
该命令会持续打印新日志，包含时间戳、模块名和错误堆栈；按 Ctrl+C 可退出。
如果日志刷屏太快看不清重点，加 --level error 只显示错误：
openclaw logs --level error
【注意：--follow 和 --level 不能同时使用，否则报错】
定位并打开本地日志文件
当 CLI 命令不可用（比如 gateway 进程已崩溃）或需要离线分析完整上下文时，必须找到磁盘上的日志文件。
第一步：查配置指定路径
执行 openclaw config get log.file，若返回非空路径，直接跳到第三步。
第二步：确认默认路径
Linux/macOS 默认为 ~/.openclaw/logs/openclaw.log；Windows 默认为 C:\Users\用户名\.openclaw\logs\openclaw.log。
注意：部分版本会按日期滚动生成 /tmp/openclaw/openclaw-2026-07-28.log，优先检查该目录。
第三步：验证文件是否可读
Linux/macOS 执行：ls -l ~/.openclaw/logs/ → 看文件是否存在且大小不为 0；
Windows 执行：dir C:\Users\用户名\.openclaw\logs\ → 若提示“找不到路径”，说明尚未生成日志，需先启动服务。
第四步：用文本工具打开
Linux/macOS：cat ~/.openclaw/logs/openclaw.log | tail -n 50 查最后 50 行；
Windows：type C:\Users\用户名\.openclaw\logs\openclaw.log（推荐用 VS Code 或 Notepad++ 打开，避免记事本乱码）。
启用调试日志获取更详细信息
默认日志只记录 ERROR 和 WARN，遇到“没报错但功能异常”的情况，必须开启 DEBUG 模式。
方法一：临时环境变量启动（推荐）
Linux/macOS：DEBUG=openclaw:* LOG_LEVEL=debug npm start；
Windows PowerShell：$env:DEBUG="openclaw:*"; $env:LOG_LEVEL="debug"; npm start。
方法二：修改配置文件
编辑 ~/.openclaw/openclaw.json，在 logging 节点下添加："level": "debug"，保存后重启服务。
【DEBUG 日志体积极大，排查完务必改回 info 或 warn 级别】
快速过滤和导出关键日志
当 error.log 文件过大（超过 10MB），手动翻找效率极低，要用命令精准提取。
① 提取所有 ERROR 行（含堆栈）：grep -A 5 "ERROR" ~/.openclaw/logs/openclaw.log（-A 5 表示匹配行后额外显示 5 行上下文）
② 导出最近 1 小时的日志：openclaw logs --since 1h > recent.log
③ 按技能名称筛选（如排查 email 技能）：openclaw logs --json | jq 'select(.skill == "email_fetcher")'
④ 清除旧日志释放空间：openclaw logs clear（该操作不可逆，慎用）
