OpenClaw技能开发实战：从零编写高效可靠的Skill模块

3次阅读

没有评论

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

在 OpenClaw 框架中，Skill 是完成特定任务的最小功能单元。一个典型的 Skill 包含以下核心要素：

输入规范：明确定义接收的数据格式和约束条件
处理逻辑：实现核心功能的业务代码
输出规范：规定返回数据的结构和类型
执行上下文：运行时的环境变量和状态信息

执行上下文 (Context) 是 Skill 运行时的重要环境对象，包含：

请求参数：客户端传入的原始数据
会话状态：当前对话的上下文信息
服务配置：预定义的参数和常量
日志工具：内置的日志记录器

处理用户输入时需要考虑：

数据验证：确保输入符合预期格式
数据清洗：去除无效或冗余信息
数据转换：将原始数据转换为内部表示

与外部服务交互时应注意：

接口协议设计（REST/GraphQL/gRPC）
超时和重试机制
认证和授权处理
响应数据解析

# -*- coding: utf-8 -*-
"""天气预报 Skill 示例"""
from openclaw.skill import BaseSkill
from openclaw.context import Context
from openclaw.exceptions import SkillError

class WeatherSkill(BaseSkill):
    """实现天气查询功能的 Skill"""
    def __init__(self):
        super().__init__(
            name='weather',
            version='1.0',
            description='查询城市天气信息'
        )

    async def execute(self, context: Context) -> dict:
        """
        执行天气查询逻辑

        Args:
            context: 执行上下文对象

        Returns:
            天气信息字典
        """
        try:
            # 1. 参数验证
            city = context.params.get('city')
            if not city:
                raise SkillError('缺少城市参数')

            # 2. 调用外部 API 获取天气数据
            weather_data = await self._get_weather(city)

            # 3. 构造响应数据
            return {
                'city': city,
                'temperature': weather_data['temp'],
                'condition': weather_data['condition'],
                'timestamp': context.timestamp
            }

        except Exception as e:
            context.logger.error(f'天气查询失败: {str(e)}')
            raise SkillError('天气查询服务暂时不可用') from e

    async def _get_weather(self, city: str) -> dict:
        """调用第三方天气 API"""
        # 这里应该是实际的 API 调用代码
        return {
            'temp': '25°C',
            'condition': '晴'
        }