OpenClaw技能调试日志需通过五种方式启用：一、终端执行claw logs --level DEBUG --follow实时跟踪；二、按技能名过滤如claw logs -s github --level DEBUG；三、导出JSONL格式日志用于离线分析；四、桌面端Logs界面图形化筛选；五、修改~/.openclaw/config.yaml永久启用DEBUG日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在调试 OpenClaw 技能插件时无法获取执行细节，或技能看似无响应但未报错，则很可能是调试日志未启用或未正确查看。以下是开启并查看 OpenClaw 技能调试日志的多种方法：
一、启用 DEBUG 级别日志并实时跟踪
默认日志级别为 INFO，不显示详细执行路径与变量状态；将日志等级设为 DEBUG 可捕获技能初始化、参数绑定、工具调用前后的完整上下文，适用于深度排障。
1、在终端中执行命令：claw logs --level DEBUG --follow
2、该命令将持续输出包含调试信息的日志流，含函数入口、参数快照、中间状态标记等。
3、若仅需观察某次触发过程，可在另一终端中执行技能调用（如通过 WebUI 发送请求），此时 DEBUG 日志将同步刷新。
二、按技能名称精准过滤调试日志
当系统加载多个技能时，全量 DEBUG 日志易被干扰；通过技能标识符（skill name）限定范围，可隔离目标插件的全部生命周期日志，包括加载、注册、调用、异常回滚等阶段。
1、确认目标技能名称，例如 github 或 agent-browser，可通过 claw list skills 查看已注册列表。
2、执行命令：claw logs -s github --level DEBUG
3、如需限定时间窗口（如最近5分钟内触发），追加参数：--since 5m
三、导出结构化 DEBUG 日志供离线分析
JSON 格式日志保留完整字段结构（如 event、tool_name、input、error_stack、duration_ms），便于使用脚本或可视化工具定位耗时瓶颈或参数异常，尤其适合对比多次调用差异。
1、执行命令：claw logs -s todozi --level DEBUG --json > todozi_debug_$(date +%Y%m%d_%H%M%S).jsonl
2、导出文件为 JSONL（每行一个 JSON 对象），可用文本编辑器或 jq 工具逐行解析。
3、提取所有含错误堆栈的记录：jq 'select(.error_stack != null)' todozi_debug_20260320_233000.jsonl
四、桌面端启用并筛选调试日志
OpenClaw 桌面应用内置日志面板支持图形化切换日志级别，无需记忆命令，适合非 CLI 用户快速启用调试模式并交互式过滤。
1、启动 OpenClaw 桌面端，点击左侧菜单栏的「Logs」进入日志界面。
2、在顶部筛选区依次设置：Level → DEBUG，Skill → 选择目标技能，Time → 自定义起止时间。
3、勾选「自动刷新」后，日志列表将实时显示匹配的调试条目；点击任一条目可展开查看嵌套的 input 参数与 error 堆栈详情。
五、修改配置永久启用技能调试输出
若需长期保留技能级 DEBUG 日志（如开发环境持续集成），可通过配置文件全局提升日志粒度，避免每次手动指定参数。
1、打开 OpenClaw 配置目录：~/.openclaw/config.yaml
2、在 logging 节点下添加或修改字段：level: DEBUG 与 skills: ["github", "todozi"]（指定需调试的技能白名单）。
3、保存后重启 OpenClaw 服务：openclaw restart，此后所有匹配技能的调用均自动记录 DEBUG 级别日志。
