OpenClaw技能开发入门：为Qwen3-32B编写天气查询插件

OpenClaw技能开发入门为Qwen3-32B编写天气查询插件1. 为什么需要自定义技能去年冬天我发现自己每天早晨都要重复同样的动作打开天气APP查看温度然后根据天气决定穿什么衣服。作为一个懒人程序员我开始思考——能不能让我的OpenClaw助手自动完成这个任务这就是自定义技能的用武之地。OpenClaw的核心优势在于它的可扩展性通过开发技能Skill我们可以让AI助手具备处理特定任务的能力。不同于简单的脚本调用技能可以通过自然语言交互触发整合到更复杂的工作流中复用OpenClaw已有的基础设施如认证、日志、错误处理2. 开发环境准备2.1 基础工具链在开始前确保你已经具备运行中的OpenClaw实例我使用的是v2.3.1Node.js 18环境技能开发主要使用JavaScript/TypeScript一个可用的Qwen3-32B模型端点我使用的是本地部署的RTX4090D优化版# 验证环境 node -v npm -v openclaw --version2.2 创建技能项目使用OpenClaw官方脚手架快速初始化项目npx openclaw/create-skill weather-query cd weather-query这会生成以下目录结构weather-query/ ├── manifest.json # 技能元数据 ├── package.json ├── src/ │ ├── index.ts # 主逻辑入口 │ └── types.ts # 类型定义 └── test/ # 测试用例3. 核心开发步骤3.1 定义技能清单(manifest.json)这个文件相当于技能的身份证我的配置如下{ id: weather-query, name: 天气查询, description: 查询实时天气信息, version: 0.1.0, author: 你的名字, entry: dist/index.js, events: [message], permissions: [http], dependencies: { openclaw/sdk: ^2.3.0 } }关键字段说明events: 声明技能监听的消息类型permissions: 声明需要的权限这里需要网络访问entry: 编译后的入口文件路径3.2 实现核心逻辑在src/index.ts中我们需要处理三个关键环节import { Skill, EventContext } from openclaw/sdk; // 1. 初始化技能实例 const skill new Skill(); // 2. 注册消息处理器 skill.on(message, async (ctx: EventContext) { const { content } ctx.payload; // 匹配天气查询意图 if (!content.includes(天气) !content.includes(weather)) { return; // 不是天气查询就跳过 } // 3. 提取查询城市 const city extractCity(content); // 简单的正则提取 try { // 调用天气API const weatherData await fetchWeather(city); // 格式化响应 const reply formatWeather(weatherData); // 返回结果 await ctx.reply(reply); } catch (err) { await ctx.reply(查询失败: ${err.message}); } }); // 启动技能 skill.start();3.3 对接天气API我选择使用和风天气的免费API需要先注册获取KEYasync function fetchWeather(city: string) { const API_KEY process.env.WEATHER_API_KEY; const url https://devapi.qweather.com/v7/weather/now?location${encodeURIComponent(city)}key${API_KEY}; const response await fetch(url); if (!response.ok) { throw new Error(API请求失败: ${response.status}); } return response.json(); }注意将API_KEY存储在环境变量中不要硬编码在代码里。3.4 结果格式化为了让Qwen3-32B生成的回复更友好我设计了这样的格式function formatWeather(data: any) { const { now, location } data; return 当前${location.name}天气 - 状况${now.text} - 温度${now.temp}℃ - 体感温度${now.feelsLike}℃ - 风向${now.windDir} - 风力${now.windScale}级 - 湿度${now.humidity}% - 降水量${now.precip}mm 更新时间${now.obsTime} .trim(); }4. 调试与部署4.1 本地测试使用OpenClaw CLI进行本地测试# 编译TypeScript npm run build # 本地运行技能 openclaw skill run ./dist然后在OpenClaw控制台发送北京天气如何应该能看到格式化的回复。4.2 常见问题排查我遇到的两个典型问题及解决方案API调用失败检查网络连接验证API_KEY是否正确确认城市名称是否被API支持中文乱码确保HTTP请求头包含Accept-Charset: utf-8检查终端/控制台的编码设置4.3 发布到ClawHub完成开发后可以发布到技能市场# 登录ClawHub clawhub login # 发布技能 clawhub publish --access public发布后其他用户可以通过clawhub install weather-query安装你的技能。5. 进阶优化方向在实际使用几周后我发现几个可以改进的点多城市查询修改正则表达式支持北京和上海天气这样的查询天气预报扩展API调用支持未来3天预报缓存机制对相同城市的查询结果缓存10分钟减少API调用单位转换根据用户偏好显示摄氏/华氏温度这些改进都可以通过迭代manifest.json和核心逻辑来实现。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。