日志是定位openclaw小龙虾运行异常等问题的关键依据，具体包括：一、启用实时日志；二、配置日志级别为debug；三、启用开发者模式；四、通过环境变量强制开启调试通道；五、查看特定组件日志文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试调试OpenClaw小龙虾运行异常、消息未响应或网关失联等问题，日志是定位问题根源的关键依据。以下是启用日志调试与开启开发者模式的具体操作步骤：
一、启用实时日志查看
OpenClaw内置openclaw logs命令可直接输出运行时日志流，适用于快速捕捉错误、会话建立、技能触发等事件。该方式无需修改配置文件，立即生效，适合临时诊断。
1、打开终端（Windows使用CMD/PowerShell，macOS/Linux使用Terminal）。
2、确保OpenClaw服务已启动，执行：openclaw gateway start（若尚未运行）。
3、输入命令查看最近50行日志：openclaw logs --lines 50。
4、如需持续跟踪新增日志，添加--follow参数：openclaw logs --lines 50 --follow。
二、配置日志级别为DEBUG
默认日志级别为INFO，仅显示关键事件；启用DEBUG级别可输出模型调用、工具执行、上下文构建等详细过程，适用于深度排查逻辑链路中断问题。
1、执行命令设置日志等级：openclaw config set logging.level debug。
2、重启网关使配置生效：openclaw gateway restart。
3、再次运行openclaw logs --follow，即可看到包含DEBUG标签的详细追踪信息。
三、启用开发者模式（含调试端口与控制台）
开发者模式不仅开放内部API端点，还启用Web控制台与热重载支持，允许实时检查会话状态、注入测试消息、查看技能执行栈，是高级调试必备环境。
1、在配置中启用开发者开关：openclaw config set developer.enabled true。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
2、指定开发者控制台监听地址与端口（默认为localhost:8080）：openclaw config set developer.port 8080。
3、重启网关：openclaw gateway restart。
4、浏览器访问http://127.0.0.1:8080，进入可视化开发者控制台界面。
四、通过环境变量强制开启调试通道
当配置命令不可用（如权限受限或配置层被锁定）时，可绕过配置系统，直接通过系统环境变量激活底层调试能力，包括HTTP请求全量打印、模型推理耗时统计等隐藏日志。
1、在启动前设置环境变量（Linux/macOS）：export OPENCLAW_DEBUG=1。
2、Windows系统请执行：set OPENCLAW_DEBUG=1（CMD）或$env:OPENCLAW_DEBUG="1"（PowerShell）。
3、随后运行网关：openclaw gateway start。
4、日志中将出现[DEBUG] HTTP request:、[TRACE] Skill execution:等高密度调试输出。
五、查看特定组件日志文件
除终端流式日志外，OpenClaw将结构化日志持久化至本地文件，便于归档分析与多时段比对。各模块日志独立存储，路径统一位于用户工作区.openclaw/logs/子目录下。
1、进入日志目录：cd ~/.openclaw/logs（Windows为%USERPROFILE%\.openclaw\logs）。
2、列出全部日志文件：ls -lt（macOS/Linux）或dir /o:d（Windows）。
3、查看网关主日志最新内容：tail -n 30 gateway.log（macOS/Linux）或Get-Content gateway.log -Tail 30（PowerShell）。
