掌握OpenClaw Skills需遵循五步路径：一、理解Skills是封装知识、逻辑与说明的模块，须置于~/.openclaw/workspace/skills/下且含合规SKILL.md；二、创建规范目录结构并编写SKILL.md；三、在scripts/下编写同步JS脚本并赋权；四、重启OpenClaw自动加载并测试；五、通过日志与路径权限排查加载失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望为 OpenClaw AI 助理扩展特定领域的能力，但不确定如何定义、安装或调用功能模块，则可能是由于未正确理解 Skills 的结构与加载机制。以下是掌握 OpenClaw Skills 的具体路径：
一、理解 Skills 的本质与组成
Skills 是 OpenClaw 中封装专业能力的模块化知识包，其核心是将领域知识、执行逻辑和使用说明三者结构化绑定，使 AI 能在匹配意图后自动触发并安全执行。每个 Skill 必须包含 SKILL.md 文件作为行为说明书，并可选配脚本、工具定义及参考资料。
1、确认当前 workspace 路径是否已初始化：~/.openclaw/workspace 是默认开发根目录，所有自定义技能必须置于该路径下的 skills/ 子目录中。
2、检查目标技能目录是否具备最低必要文件：SKILL.md 文件必须存在且格式合法，否则 OpenClaw 启动时将跳过该技能加载。
3、验证 SKILL.md 内容是否包含三项强制字段：## 功能说明、## 使用场景、## 工具列表，缺失任一将导致技能无法被意图识别系统匹配。
二、创建并初始化一个基础 Skill
新建 Skill 需严格遵循目录规范与元数据约定，确保 OpenClaw 在启动阶段能完成自动发现与注册。该过程不依赖外部构建工具，纯手工结构即可生效。
1、进入 workspace 技能目录：cd ~/.openclaw/workspace/skills。
2、创建唯一命名的技能子目录：mkdir my-first-skill。
3、进入该目录并建立标准结构：mkdir -p scripts references。
4、在根目录下创建 SKILL.md 文件，写入符合 Markdown 格式的说明内容，其中 ## 工具列表 下需明确列出可调用的工具名称，如 `get-time`: 返回当前系统时间。
三、编写可执行的工具脚本
脚本是 Skill 的执行引擎，由 OpenClaw 在匹配成功后调用。脚本输出将被直接注入模型上下文，因此必须保证返回结构清晰、无副作用、无交互等待。
1、在 scripts/ 目录下创建对应工具名的 JS 文件：touch scripts/get-time.js。
2、编辑该文件，仅保留同步执行逻辑：console.log(JSON.stringify({ time: new Date().toISOString() }));。
监控一个或多个 GitCode 仓库的 PR，通过 OpenClaw Gateway 自动执行 AI 审查，发布 PR 评论，并发送钉钉和企业微信通知。
3、赋予执行权限（Linux/macOS）：chmod +x scripts/get-time.js。
4、验证脚本独立运行结果：node scripts/get-time.js 应输出合法 JSON 字符串，且无报错或额外空行。
四、注册并启用 Skill
OpenClaw 不通过命令行手动安装 Skill，而是依赖启动时对 workspace/skills/ 下所有子目录的静态扫描。启用即意味着让目录结构可见且内容合规，无需额外注册命令。
1、确认 OpenClaw 进程未运行：pkill -f openclaw 或关闭相关终端会话。
2、重新启动 OpenClaw：openclaw --workspace ~/.openclaw/workspace。
3、观察启动日志中是否出现类似 "Loaded skill: my-first-skill" 的提示行。
4、向 AI 发送测试指令，例如“现在几点”，若返回时间 JSON 数据，则表明 Skill 已成功参与意图匹配与执行链路。
五、调试 Skill 加载失败问题
当 Skill 未出现在日志或无法响应时，常见原因包括路径错误、文件缺失、权限不足或语法违规。OpenClaw 对加载失败采取静默忽略策略，不会中断启动流程，因此需主动排查。
1、检查目录是否位于 ~/.openclaw/workspace/skills/ 下，而非 ~/.openclaw/skills/ 或其他任意路径。
2、确认 SKILL.md 中的工具名与 scripts/ 下文件名（不含扩展名）完全一致，包括大小写与连字符。
3、运行 ls -l scripts/ 查看脚本是否具有可执行位，Windows 用户需确认 scripts/ 下为 .bat 或 .ps1 文件且配置了对应 runner。
4、打开开发者控制台或查看 ~/.openclaw/logs/openclaw.log，搜索关键词 “failed to load skill” 或 “invalid SKILL.md” 定位具体错误位置。
