OpenClaw技能开发教程：SKILL.md编写与自定义技能安装

日期：2026-08-14 | 分类：AI工具教程

项目简介

OpenClaw技能（Skills）是扩展AI Agent能力的模块化知识包。每个技能以SKILL.md为核心文件，AI通过三级加载机制自动发现和应用技能。同一SKILL.md可在Claude Code、Gemini CLI、Cursor、GitHub Copilot通用。

技能目录结构

my-skill/
├── SKILL.md          # 唯一必需文件
├── scripts/          # 辅助脚本
│   ├── deploy.sh
│   └── setup.py
├── templates/        # 模板文件
│   └── config.yaml
├── references/       # 参考资料
│   └── api-docs.md
└── examples/         # 示例
    └── demo.js

SKILL.md编写

---
name: my-deploy-skill
description: 自动部署Node.js应用到Vercel。触发词：部署、deploy、发布到vercel
---

# Vercel部署技能

## 部署流程
1. 检查package.json是否存在
2. 运行 `npm run build`
3. 执行 `npx vercel --prod`
4. 返回部署URL

## 注意事项
- 确保.vercel目录存在或已登录
- 构建失败时不继续部署
- 保留.env文件中的环境变量

YAML Frontmatter字段

字段必填说明
name是技能唯一标识，小写+短横线
description是技能描述+触发词，AI据此判断是否激活

三级加载机制

级别加载内容Token消耗
始终加载name+description（~100 tokens）极低
按需加载SKILL.md正文中等
深度加载scripts/templates/references按需

安装技能到Agent

# 方式1：放到项目目录
mkdir -p .openclaw/skills
cp -r my-skill/ .openclaw/skills/

# 方式2：全局安装
cp -r my-skill/ ~/.openclaw/skills/

# 方式3：通过Skill Workshop创建
# 在OpenClaw对话中使用 skill_workshop 工具

自动触发示例

# 用户说"帮我部署到Vercel"
# AI检测到description中的触发词"部署"
# 自动加载SKILL.md正文
# 按流程执行部署

# 也可手动触发：
# "用my-deploy-skill技能部署"

开发最佳实践

相关阅读

📚 常见问题

OpenClaw技能开发是什么？

OpenClaw技能（Skills）是扩展AI Agent能力的模块化知识包。每个技能以SKILL.md为核心文件，AI通过三级加载机制自动发现和应用技能。同一SKILL.md可在Claude Code、Gemini CLI、Cursor、GitHub Copilot通用。

如何上手OpenClaw技能开发？

description写清楚触发词，AI靠这个判断是否激活