openclaw skills异常需查gateway日志：一、实时跟踪含skills/loadskill等关键字；二、grep过滤error/warning级错误；三、重启gateway查看初始化日志；四、运行openclaw doctor定位skills checker模块问题；五、验证~/.openclaw/workspace/skills等路径下skill.md文件存在且结构合规。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试排查 OpenClaw AI Skills 运行异常或加载失败的问题，但无法定位具体错误来源，则很可能是未正确访问其结构化调试日志。OpenClaw 将 Skills 相关的初始化、加载、调用与执行错误统一归入 gateway 日志流，并通过特定关键字和上下文层级进行标记。以下是查看与解析这些日志的多种有效方法：
一、实时跟踪 gateway 日志流
OpenClaw 的 Skills 生命周期事件（如加载、注册、调用、报错）全部由 gateway 进程捕获并写入日志，启用实时流可即时观察 Skills 行为。该方式适用于调试安装后无响应、技能列表为空、调用时静默失败等场景。
1、在终端中执行以下命令启动实时日志监控：
2、在新消息或技能触发操作后，立即观察输出中是否出现包含 skills、loadSkill、registerSkill 或 executing skill 的行。
3、若发现含 failed to load skill 或 skill not found in path 的日志，则说明路径或元数据配置有误。
二、过滤 Skills 专属错误关键字
OpenClaw 日志量大，直接滚动查找效率低。通过管道组合 grep 可精准提取 Skills 相关错误上下文，避免遗漏隐式失败（如因缺少 skill.md 而跳过加载却无显式报错）。
1、执行以下命令筛选所有含 Skills 错误标识的日志行：
2、重点关注返回中带 ERROR 级别的条目，例如：[skills] failed to parse skill.md: ENOENT 或 [skills] missing required field 'id' in skill manifest。
3、对含 WARNING 的行也需检查，如 [skills] skipping directory without skill.md，该提示即表明目录结构不合规。
三、检查 Skills 初始化阶段独立日志
Skills 加载发生在 gateway 启动初期，此时日志尚未进入常规交互流。若 gateway 已运行但 Skills 始终未出现在 openclaw skills list 中，必须回溯启动瞬间的初始化快照。
1、先停止当前 gateway：
2、以非守护模式重新启动 gateway，强制日志直出到终端：
3、在启动输出中逐行查找以 [skills] 开头的初始化日志段，特别注意末尾是否出现 loaded X skills 或 0 skills loaded。
四、读取 Skills 子系统诊断报告
openclaw doctor 命令内置 Skills 专项检查模块，会主动扫描路径合法性、manifest 格式、依赖文件存在性及权限状态，并生成结构化诊断结果。该报告比原始日志更易定位根因，尤其适用于路径错误、权限不足、元数据缺失等高频问题。
1、运行完整诊断：
2、在输出中定位 [Skills Checker] 区块，查看其下每一项的状态标记（[OK] / [WARNING] / [ERROR]）。
3、若出现 ERROR: skill manifest validation failed for ./skills/xxx，则需打开对应 skill.md 文件校验 YAML 语法与必填字段。
五、验证 Skills 工作区路径与文件结构
OpenClaw 按固定优先级顺序扫描 Skills 目录：工作区（~/.openclaw/workspace/skills）→ 托管目录（~/.openclaw/skills）→ 内置技能。若日志中未见任何加载记录，极可能因路径未被识别或结构不满足规范。
1、确认当前生效的 Skills 主目录：
2、进入该目录后执行：
3、检查每个子目录内是否存在且仅存在一个 skill.md 文件；若缺失，OpenClaw 将完全忽略该目录，且不输出错误日志。
