自研第一个SKILL-openclaw入门

自研第一个SKILL-openclaw入门

构建好openclaw远非终点，真正让它“活”起来的秘诀在于使用。而SKILL，正是openclaw的灵魂所在，是驱动其发挥威力的内在核心能力。

因此，我打算逐步记录下学习openclaw SKILL开发的历程。

老话说得好，纸上得来终觉浅。对于知识的透彻理解，动手实践往往比单纯阅读更为重要。今天，我们就从一个简单的自研SKILL入手，在实践中深化对这套机制的理解。

如果你还不清楚SKILL究竟是什么，建议先阅读基础篇：

SKILL让openclaw起飞的内功-入门篇

抄一个还是改一个

学习写字从描红开始，开发程序也常以模仿为佳径。所谓“CV程序员”的称号，某种程度上也道出了学习的初期法门。

先来看下面这个例子：

openclaw作为国外开发的项目，其系统内置的SKILL自然多以国外服务为主。比如这个天气查询功能，我们先找到它自带的SKILL看看结构：

该SKILL位于系统内置的目录下：

/app/skills/weather/SKILL.md

其核心内容如下：

这是一个功能相对完整的天气查询SKILL，甚至考虑了主备服务。不过，它调用的都是国外接口，对国内用户来说难免有些“水土不服”。我们就以它为蓝本，动手改造出一个适配国内服务的简易版本。

改造后的完整代码如下：

我们来分解一下这个自制SKILL的各个部分：

名称 (name)： my-weather。这个标识需要在系统内保持唯一。

描述 (description)： 注意这里的 [DEBUG:ENABLED] 标记。当这个SKILL被激活调用时，该配置能让调试信息在对话中体现，对于排查问题非常方便。

工具 (tools)： 这里换用了国内免费的API服务方：uapis.cn。

操作步骤 (steps)： 定义执行逻辑。

输出格式 (output)： 规范返回结果。

麻雀虽小，五脏俱全。这个最简SKILL正好对应了上一篇中提到的所有核心组成部分，堪称一个完美的入门范例。

测试

将编写好的SKILL文件放置到用户工作区目录：

/root/.openclaw/workspace/skills/my-weather/SKILL.md

放置后，记得重启gateway服务使其生效。之后，就可以进行询问测试了：

看，成功返回了天气信息！万事大吉。

小结

这就是我们自研的第一个SKILL。功能虽不复杂，却非常实用。后续，完全可以再集成一个免费的国内天气接口作为备用，稍加完善，便能替代掉系统原生的天气SKILL。

学习之路，从简单开始，从模仿起步。逐渐熟悉后，便能挑战更复杂的SKILL开发，不断拓展openclaw的能力边界。

欢迎关注公众号：

自研第一个SKILL-openclaw入门