OpenClawAI日志未启用导致Skills加载失败等问题无法排查，可通过五种方式开启调试日志：一、CLI命令实时跟踪；二、YAML配置提升日志级别；三、非守护模式启动捕获初始化日志；四、启用Text格式并指定输出路径；五、环境变量临时提升日志详细度。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 OpenClawAI，但无法查看 Skills 加载失败、调用异常或 Gateway 启动问题的具体原因，则很可能是日志记录功能未启用或配置不完整。以下是开启并有效捕获调试日志的多种方法：
一、使用内置 CLI 命令实时跟踪日志流
OpenClaw 提供了 openclaw logs --follow 命令，可直接连接到 gateway 进程的标准输出与日志文件，实现无配置、零延迟的日志观测。该方式适用于快速验证当前运行状态及即时响应技能触发行为。
1、在终端中执行：openclaw logs --follow
2、保持该终端窗口打开，在 Web UI 或 API 中触发任意 Skill 调用。
3、观察输出中是否出现以 [skills]、[gateway] 或 ERROR 开头的行，例如 executing skill: web_search 或 failed to load skill: missing skill.md。
二、通过 YAML 配置文件启用详细日志级别
OpenClaw 的日志行为由 logger 模块控制，其详细程度可通过修改 config.yaml 中的 log_level 与 handlers 设置来提升。此方式确保所有组件（包括 Skills 初始化、Agent 决策链、消息路由）均生成可追溯的结构化日志。
1、定位 OpenClaw 配置目录，通常为：~/.openclaw/config.yaml（Linux/macOS）或 %USERPROFILE%\.openclaw\config.yaml（Windows）。
2、用文本编辑器打开该文件，在 logger: 区块下添加或修改以下字段：
3、保存文件后，重启 gateway：执行 openclaw gateway stop && openclaw gateway start。
三、以非守护模式启动 gateway 获取初始化快照
Skills 加载仅发生在 gateway 启动初期，若采用守护进程（daemon）模式运行，这部分关键日志会被重定向至后台文件而难以即时捕获。通过禁用守护模式，可强制所有日志直出终端，完整保留从加载路径扫描到技能注册完成的全过程。
1、先停止当前运行的 gateway：openclaw gateway stop
2、使用 --no-daemon 参数启动：openclaw gateway start --no-daemon
3、在终端输出中逐行查找以 [skills] loaded X skills 或 [skills] skipping directory without skill.md 开头的行，确认 Skills 是否被识别及加载数量是否符合预期。
四、启用 Text 格式日志并指定独立输出路径
默认日志可能混入系统 journal 或标准错误流，不利于长期归档与关键词检索。启用 Text 格式可生成纯文本日志文件，并配合自定义路径实现权限隔离与集中管理，特别适用于生产环境审计需求。
1、编辑 config.yaml，在 logger.handlers.file: 下设置：
2、确保目标目录存在且当前用户具有写入权限，例如 Linux 下执行：mkdir -p /var/log/openclaw && chmod 700 /var/log/openclaw
3、重启 gateway 后，日志将稳定写入指定路径，如：/var/log/openclaw/gateway.log。
五、通过环境变量临时提升日志详细度
无需修改配置文件即可快速启用调试级日志，适用于临时诊断场景。环境变量优先级高于 YAML 配置，可覆盖已有设置，且仅对当前终端会话生效，避免影响全局行为。
1、在启动 gateway 前，设置环境变量：export OPENCLAW_LOG_LEVEL=DEBUG
2、同时启用文本格式输出：export OPENCLAW_LOG_FORMAT=text
3、执行：openclaw gateway start --no-daemon，此时终端将输出包含函数调用栈、参数快照及内部状态变更的完整调试信息。
