【前言】
OpenClaw作为一款本地优先、可自托管的AI自动化代理工具,其强大的扩展能力来自于"Skill"机制。每个Skill就像手机上的App,赋予AI完成特定任务的能力。
今天这篇文章,将带你从零开始,学会编写和制作自己的Skill。
【一、什么是Skill?】
Skill是OpenClaw的最小功能执行单元,用于定义AI Agent如何完成特定任务。
主要特点:
• 原子性:一个Skill只负责一项具体任务
• 可复用性:可被多个Agent调用
• 自主性:具备一定独立执行能力
• 标准化接口:遵循统一规范,便于集成
【二、Skill目录结构】
一个标准的Skill是一个文件夹,基本结构如下:
my-skill/
├── skill.yaml(技能配置文件,必需)
├── README.md(说明文档)
├── prompt.md(AI执行指令,核心)
├── tools/(工具脚本目录)
│ └── example.js
└── assets/(静态资源)
【三、编写Skill详细步骤】
第一步:创建skill.yaml
这是Skill的"身份证",定义基本信息:
name: my-first-skill
version: 1.0.0
description: 这是我的第一个Skill示例
author: your-name
触发条件:
帮我做XXX
执行XXX任务
依赖项:
node >= 16
第二步:编写prompt.md(核心)
这是告诉AI"怎么做"的指令文件:
任务说明:
当用户请求执行此任务时,请按以下步骤操作:
执行步骤:
首先确认用户的具体需求
调用相关工具获取必要信息
按照模板格式输出结果
将结果保存到指定位置
输出格式:请以JSON格式返回结果,包含status状态和data数据字段。
第三步:编写工具脚本(可选)
如需调用外部API或执行复杂逻辑,可创建JavaScript脚本文件,实现execute函数处理业务逻辑并返回JSON结果。
【四、安装与测试】
本地安装:将Skill文件夹放到OpenClaw的skills目录
通过对话安装:把打包好的zip文件发给OpenClaw,让它自行安装
测试Skill:直接在对话中输入触发词,观察AI是否按预期执行
【五、发布到ClawHub】
想让更多人使用你的Skill?可以发布到官方社区:
访问 https://clawhub.ai
注册并登录账号
点击"发布Skill"
上传打包好的Skill文件
填写描述、标签等信息
提交审核
【六、实战案例:天气查询Skill】
配置示例:
name: weather-query
description: 查询指定城市天气
triggers:
查天气
今天天气怎么样
执行说明:当用户询问天气时,提取城市名,调用天气API获取数据,以友好格式返回天气信息。
【总结】
编写OpenClaw Skill的核心流程:
创建目录 → 编写skill.yaml → 编写prompt.md → 添加工具脚本 → 测试 → 发布
掌握Skill编写,你就能让AI完成任何自定义任务,真正成为你的"数字员工"。
互动话题:你希望开发一个什么样的Skill?欢迎留言讨论!
夜雨聆风