OpenClaw 自定义Skills 添加指南

OpenClaw 自定义Skills 添加指南：扩展你的智能助手能力

在开源智能助手框架OpenClaw的生态中，Skills是实现功能扩展的核心模块。无论是集成第三方服务、自动化日常任务，还是定制专属的助手功能，都可以通过编写自定义Skills来实现。本文将通过详细的步骤讲解，带你快速掌握在OpenClaw中添加自定义Skills的完整流程，适合开发者和自动化爱好者参考学习。

一、先了解OpenClaw的Skills目录结构

OpenClaw的Skills默认存储在~/.openclaw/skills目录下，每一个独立的Skills都是一个单独的文件夹，文件夹名称即为该Skill的唯一标识。官方已经内置了不少示例Skills，比如用于查询天气的weather、控制Sonos音箱的sonoscli等，你可以先通过命令ls ~/.openclaw/skills查看已有的内置Skills，了解标准的目录结构和文件格式。

每个标准的Skill文件夹中，至少包含一个SKILL.md说明文件，用于描述该Skill的功能、依赖和使用方法，部分复杂的Skill还会附带对应的脚本文件或配置文件。

二、创建自定义Skill文件夹

首先我们需要在Skills目录下创建一个新的文件夹作为自定义Skill的根目录。建议文件夹名称使用小写字母和连字符的规范格式，比如my-first-skill，避免使用中文或特殊字符，防止出现兼容性问题。
可以通过以下命令快速创建：

1
mkdir -p ~/.openclaw/skills/my-first-skill

执行完成后，你就拥有了一个空的Skill容器，接下来就可以往里面添加功能代码和说明文件了。

三、编写SKILL.md说明文件

SKILL.md是每个Skill的核心说明文件，相当于该Skill的“说明书”，OpenClaw会通过这个文件识别Skill的基本信息和使用方式。一个标准的SKILL.md需要包含以下几个部分：

  1. Skill名称：简短清晰的名称，比如“我的第一个自定义Skill”
  2. 功能描述：详细说明该Skill可以实现什么功能，适合哪些使用场景
  3. 依赖环境：列出运行该Skill需要提前安装的系统包、npm包或其他依赖
  4. 使用方法：说明如何调用该Skill，比如支持的命令格式、参数说明等

一个简单的示例SKILL.md内容如下：

1
2
3
4
5
6
7
# SKILL.md - 我的第一个OpenClaw Skill
## 功能描述
这是一个测试用的自定义Skill，用于向用户输出自定义问候语
## 依赖环境
无需额外依赖
## 使用方法
直接执行命令`my-first-skill`即可触发问候语输出

四、编写功能代码

接下来我们需要为Skill添加实际的功能代码。我们可以选择bash、Python、Node.js等任意熟悉的编程语言来编写。比如我们编写一个简单的bash脚本，用于输出自定义问候语：

  1. 在Skill文件夹中创建main.sh文件：
    1
    touch ~/.openclaw/skills/my-first-skill/main.sh
  2. 编辑文件内容：
    1
    2
    3
    #!/bin/bash
    echo "🎉 欢迎使用我的第一个OpenClaw自定义Skill！"
    echo "当前时间：$(date)"
  3. 赋予脚本执行权限：
    1
    chmod +x ~/.openclaw/skills/my-first-skill/main.sh

五、加载并测试自定义Skill

完成代码编写后，我们需要让OpenClaw加载新的Skill。最简单的方式是重启OpenClaw的Agent服务：

1
systemctl restart openclaw

重启完成后，你可以通过以下命令查看已加载的Skills列表，确认你的自定义Skill已经被识别：

1
openclaw skills list

如果列表中出现了my-first-skill，说明加载成功。你可以直接在终端中运行该Skill的命令，测试功能是否正常：

1
my-first-skill

如果终端中输出了我们预设的问候语和当前时间，那么你的第一个自定义Skill就成功运行了！

六、常见问题与调试技巧

如果你的Skill没有正常加载，可以通过以下方式排查问题：

  1. 查看日志文件：OpenClaw的日志默认存储在~/.openclaw/logs目录下，查看最新的日志可以找到加载失败的错误信息
  2. 手动运行脚本：直接在终端中运行Skill的主脚本，排查代码本身的语法错误或依赖问题
  3. 检查文件权限：确保脚本文件拥有执行权限，并且文件夹和文件的所有者符合OpenClaw运行的用户权限

总结

通过以上步骤，你已经掌握了在OpenClaw中添加自定义Skills的完整流程。从创建目录、编写说明文件，到添加功能代码和测试运行，整个过程并不复杂。你可以基于这个基础，尝试集成更多的第三方服务，比如接入钉钉机器人、查询股票行情、自动化文件处理等，让你的OpenClaw助手变得更加强大。如果你觉得自己的Skill很实用，还可以将其发布到ClawHub社区，和更多的开发者分享你的成果。