OpenClaw Skill 开发模板

来源类型： 开发指南 / 模板
日期： 2026-03
标签： skills, development, template, skel

核心论点

提供了一个可直接复制到工作区的 OpenClaw Skill 开发模板。基于官方 skill-creator 规范，结构固定。Skill 目录推荐放在 ~/.openclaw/workspace/skills/your-skill-name/，核心文件包括 SKILL.md（必需入口说明）、index.js（主入口，export async function run(context)）、package.json（可选依赖管理）。

关键结论

• Skill 目录结构：SKILL.md（必须）+ index.js（必须）+ package.json（建议）+ lib/（业务代码，可选）+ README.md（说明，可选）
• SKILL.md 格式：front matter（name/description/version/author/license）+ 功能概述 + 参数说明 + 示例调用 JSON
• index.js 核心模式：module.exports.run = async function(context)，通过 context.params 获取参数，context.tools 调用已注册工具
• 安装后 OpenClaw 自动扫描 workspace/skills/*/SKILL.md 发现新 Skill
• 发布到 ClawHub：在根目录执行 clawhub publish .（需先登录 ClawHub 账户）
• 常用模板类型：纯功能 Skill、CLI 包装、复杂业务（lib/目录拆分）、多语言（scripts/）、单元测试（tests/ + jest）
• 调试技巧：openclaw status 查看插件加载日志、openclaw exec 验证工具可用性