OpenClaw中的Skill开发入门：从零构建你的第一个技能模块

1次阅读

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

OpenClaw 是一个面向智能交互场景的开发平台，而 Skill 模块则是实现具体功能的核心单元。简单来说，每个 Skill 就像一个小型应用，可以处理用户请求、调用外部服务、管理对话状态等。开发者通过创建 Skill 来扩展平台能力，比如查天气、订餐、控制智能家居等场景都可以通过 Skill 实现。

Docker 环境准备
安装 Docker Desktop（官网下载链接）
拉取 OpenClaw 基础镜像：docker pull openclaw/dev:3.8-python
VS Code 配置
安装 Remote-Containers 扩展
用容器打开项目文件夹，自动加载开发环境
验证环境
运行 python --version 确认 Python 3.8+
执行 pip list 检查基础依赖包

一个标准的 Skill 项目应包含以下结构：

my_weather_skill/
├── __init__.py
├── manifest.yaml    # 技能元数据
├── requirements.txt # 依赖声明
├── src/
│   ├── handlers.py  # 事件处理器
│   └── utils.py     # 工具函数
└── tests/           # 单元测试

OpenClaw 采用事件驱动模型，主要处理三类事件：

消息事件（onMessage）
用户输入触发
包含文本、语音等原始数据
定时事件（onTimer）
周期性任务触发
适用于数据同步等场景
系统事件（onSystem）
平台状态变更触发
如技能激活 / 停用

name: weather_skill
version: 1.0.0
description: 天气预报查询技能
entry: src.handlers:WeatherHandler
configs:
  api_key: YOUR_WEATHER_API_KEY
  retry_times: 3

import httpx
from openclaw.skill import BaseSkill

class WeatherHandler(BaseSkill):
    async def on_start(self):
        # 初始化 HTTP 客户端
        self.client = httpx.AsyncClient(
            timeout=10.0,
            limits=httpx.Limits(max_connections=5)
        )
        self.retry_times = self.config.get('retry_times', 3)

    async def on_message(self, msg):
        # 解析用户意图
        if '天气' in msg.text:
            location = await self._parse_location(msg)
            if not location:
                return {'text': '请问您想查询哪个城市的天气？'}

            # 带重试的 API 调用
            weather = await self._get_weather_with_retry(location)
            return {'text': f'{location}天气：{weather}'}

    async def _get_weather_with_retry(self, location):
        for _ in range(self.retry_times):
            try:
                resp = await self.client.get(f'https://api.weather.com/v1?location={location}',
                    params={'key': self.config.api_key}
                )
                resp.raise_for_status()
                return resp.json()['weather']
            except Exception as e:
                self.logger.warning(f'天气查询失败：{str(e)}')
        raise Exception('天气服务暂时不可用')