OpenClaw技能创建入门指南：从零开始构建你的第一个技能

2次阅读

没有评论

共计 2538 个字符，预计需要花费 7 分钟才能阅读完成。

OpenClaw 是一个支持自定义技能开发的 AI 平台，其核心架构分为三层：

技能层：开发者编写的业务逻辑单元，响应特定用户请求
调度层：平台核心，负责请求路由和技能生命周期管理
接口层：统一的外部服务接入规范

一个技能通常包含三个基本要素：

技能元数据（名称 / 描述 / 适用场景）
事件处理器（处理用户输入的代码逻辑）
外部服务集成（可选 API 连接）

开始前需要准备：

Python 3.8+ 环境（推荐使用 virtualenv 隔离）
OpenClaw SDK 安装：
```
pip install openclaw-sdk==1.2.0
```
开发者账号申请（需在官网完成邮箱验证）

建议使用 VS Code 或 PyCharm 作为 IDE，安装官方插件可获得代码补全支持。

创建 skill_meta.json 文件定义基础信息：

{
  "skill_name": "weather_query",
  "version": "1.0",
  "description": "查询指定城市天气情况",
  "triggers": ["天气", "weather"],
  "timeout_ms": 3000
}

关键字段说明：

triggers：触发技能的关键词列表
timeout_ms：技能最大响应时间

创建主处理文件main.py：

from openclaw.skill import BaseSkill

class WeatherSkill(BaseSkill):
    async def handle_request(self, event):
        """
        event 结构示例：{
            "text": "北京天气怎么样",
            "user_id": "123456",
            "session": {}}
        """city = self._extract_city(event['text'])
        if not city:
            return {"error": "未识别城市名称"}

        # 调用天气 API（下一步实现）weather_data = await self._get_weather(city)
        return {"result": weather_data}

    def _extract_city(self, text):
        """简单提取城市名称（实际项目建议用 NLP 模型）"""
        for kw in ["天气", "weather"]:
            if kw in text:
                return text.split(kw)[0]
        return None

在类中添加 API 调用方法：

import aiohttp

async def _get_weather(self, city):
    async with aiohttp.ClientSession() as session:
        url = f"https://api.weather.com/v1/city?name={city}"
        async with session.get(url) as resp:
            if resp.status == 200:
                return await resp.json()
            return {"error": "天气服务不可用"}

整合后的完整技能代码：

# main.py
import aiohttp
from openclaw.skill import BaseSkill

class WeatherSkill(BaseSkill):
    async def handle_request(self, event):
        city = self._extract_city(event['text'])
        if not city:
            return {"error": "未识别城市名称"}

        weather_data = await self._get_weather(city)
        return {"response": f"{city}天气：{weather_data['condition']}",
            "details": weather_data
        }

    def _extract_city(self, text):
        # 简化的城市提取逻辑
        import re
        match = re.search(r"(.*?)(天气 |weather)", text)
        return match.group(1) if match else None

    async def _get_weather(self, city):
        """模拟天气 API 调用"""
        # 实际项目替换为真实 API 调用
        return {
            "city": city,
            "condition": "晴",
            "temperature": "25℃"
        }

# 技能入口函数
def create_skill():
    return WeatherSkill()

安装测试工具包：
```
pip install openclaw-testkit
```

创建测试脚本test_skill.py：

from main import WeatherSkill

skill = WeatherSkill()

def test_weather_query():
    test_event = {"text": "北京天气"}
    response = skill.handle_request(test_event)
    assert "response" in response
    print("测试通过！")