第21讲：Skills技能系统，开发自定义工具扩展OpenClaw

大家好，我是正在实战各种AI项目的程序员晚枫。

今天学习Skills技能系统，这是OpenClaw的插件机制。通过开发Skill，你可以为AI添加任意自定义能力。

什么是Skill？

Skill是OpenClaw的扩展模块，可以：

添加新的工具函数
集成第三方服务
封装业务逻辑
复用和分享功能

Skill vs 内置工具

特性	内置工具	Skill
来源	OpenClaw自带	用户开发/社区贡献
安装	开箱即用	需要安装
功能	通用操作	特定场景
更新	随版本更新	独立维护

Skill目录结构

my-skill/
├── SKILL.md          # Skill说明文档
├── index.js          # 主入口文件
├── package.json      # 依赖配置
├── tools/            # 工具实现
│   ├── search.js
│   └── calculate.js
└── assets/           # 静态资源
    └── logo.png

开发第一个Skill

步骤1：创建目录

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

步骤2：编写SKILL.md

# My First Skill

## 描述
我的第一个OpenClaw Skill，提供天气查询功能。

## 工具

### get_weather
获取指定城市的天气信息。

参数：
- city (string): 城市名称
- date (string, optional): 日期，默认为今天

返回：
- temperature: 温度
- condition: 天气状况
- humidity: 湿度

步骤3：实现工具

创建 tools/weather.js：

const axios = require('axios');

async function get_weather({ city, date = 'today' }) {
  const response = await axios.get(
    `https://api.weather.com/v1/current?city=${encodeURIComponent(city)}`
  );
  
  return {
    temperature: response.data.temp,
    condition: response.data.condition,
    humidity: response.data.humidity
  };
}

module.exports = { get_weather };

步骤4：注册Skill

创建 index.js：

const { get_weather } = require('./tools/weather');

module.exports = {
  name: 'my-first-skill',
  version: '1.0.0',
  description: '天气查询Skill',
  author: 'your-name',
  
  tools: {
    get_weather: {
      handler: get_weather,
      description: '获取城市天气',
      parameters: {
        city: { type: 'string', required: true },
        date: { type: 'string', required: false }
      }
    }
  }
};

步骤5：启用Skill

{
  "skills": {
    "enabled": ["my-first-skill"],
    "directory": "~/.openclaw/skills"
  }
}

使用Skill

安装后，AI会自动识别并使用Skill中的工具：

你：北京今天天气怎么样？

AI：我来查一下北京的天气。
🔧 Using tool: get_weather (from my-first-skill)
   city: 北京
   
📤 Result:
   温度: 8°C
   天气: 晴
   湿度: 45%

北京今天晴天，温度8°C，湿度45%，适合出行！

分享与安装Skill

分享给他人

1
2
3

# 打包Skill
cd ~/.openclaw/skills/my-first-skill
tar czf my-first-skill.tar.gz .

安装社区Skill

# 从GitHub安装
openclaw skills install https://github.com/user/my-skill

# 从本地安装
openclaw skills install ./my-skill.tar.gz

# 列出已安装Skills
openclaw skills list

# 卸载Skill
openclaw skills uninstall my-skill