乐于分享
好东西不私藏

手把手教你编写OpenClaw Skill:从零到发布全攻略

手把手教你编写OpenClaw Skill:从零到发布全攻略


【前言】

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?欢迎留言讨论!