当前位置：首页 > news >正文

OpenClaw技能开发：为nanobot镜像制作专属的自动化插件

news 2026/7/13 20:40:41

OpenClaw技能开发：为nanobot镜像制作专属的自动化插件

1. 为什么需要自定义OpenClaw技能

上周我在整理个人工作流时，发现每天要重复做三件事：查看天气决定通勤方式、检查日程安排、收集行业资讯。特别是天气查询这个动作，需要先打开浏览器，再输入城市名称，最后才能看到预报信息。作为一个技术极客，这种低效操作让我难以忍受。

于是我开始研究如何用OpenClaw实现自动化天气查询。nanobot镜像内置的Qwen3-4B模型已经具备基础的自然语言理解能力，但缺少直接对接天气API的功能。这正是OpenClaw技能生态的价值所在——通过开发专用插件，我们可以把任何重复性工作变成一句自然语言指令就能完成的自动化任务。

2. 开发环境准备

2.1 基础环境配置

我的开发机是M1芯片的MacBook Pro，已经安装好以下组件：

# 验证Node.js环境 node -v # v18.12.0 npm -v # 9.8.1 # 安装ClawHub CLI工具 npm install -g clawhub@latest

2.2 创建技能脚手架

使用官方工具初始化项目结构：

clawhub create weather-query --template=basic-skill cd weather-query

生成的项目包含关键文件：

weather-query/ ├── package.json # 技能元数据 ├── skill.json # 技能注册声明 ├── src/ │ ├── index.js # 主逻辑 │ └── api/ # 第三方服务封装 └── templates/ # 响应模板

3. 核心功能开发

3.1 定义技能元数据

首先在skill.json中声明技能的基本信息：

{ "name": "weather-query", "description": "实时天气查询技能", "version": "0.1.0", "triggers": { "intents": ["查询天气", "weather"] }, "permissions": ["http"] }

特别注意permissions字段声明了需要网络访问权限，这是调用天气API的前提。

3.2 对接天气API

我选择心知天气作为数据源，在src/api/weather.js封装请求逻辑：

const axios = require('axios'); class WeatherAPI { constructor(apiKey) { this.client = axios.create({ baseURL: 'https://api.seniverse.com/v3', timeout: 5000 }); this.key = apiKey; } async getCurrent(city) { const { data } = await this.client.get('/weather/now.json', { params: { key: this.key, location: city, language: 'zh-Hans' } }); return data.results[0]; } } module.exports = WeatherAPI;

3.3 设计意图识别规则

在src/index.js中实现意图识别与任务分发：

const { BaseSkill } = require('clawhub-sdk'); const WeatherAPI = require('./api/weather'); class WeatherSkill extends BaseSkill { async init() { this.weatherAPI = new WeatherAPI(process.env.WEATHER_API_KEY); } async execute(ctx) { const { text } = ctx.payload; const city = this.extractCity(text); // 实现城市提取逻辑 try { const data = await this.weatherAPI.getCurrent(city); return this.render('current', data); } catch (err) { return this.render('error', { error: err.message }); } } extractCity(text) { // 使用正则提取城市名 const match = text.match(/(?:查询|查看)(.*?)的?天气/); return match ? match[1].trim() : '北京'; // 默认返回北京 } } module.exports = WeatherSkill;

4. 交互体验优化

4.1 设计响应模板

在templates/current.md中创建Markdown格式的响应模板：

{{city}}当前天气： - 天气现象：{{text}} - 温度：{{temperature}}℃ - 体感温度：{{feels_like}}℃ - 风向：{{wind_direction}} - 风力：{{wind_scale}}级 - 更新时间：{{last_update}} > 温馨提示：{{#gt temperature 30}}记得防晒{{else}}{{#lt temperature 10}}注意保暖{{else}}适宜外出{{/gt}}

4.2 添加多模态支持

为了让响应更生动，我增加了天气图标显示逻辑：

// 在render方法中添加图标映射 getIcon(weatherCode) { const icons = { '晴': '☀️', '多云': '⛅', '阴': '☁️', // 其他天气代码映射... }; return icons[weatherCode] || ''; }

5. 测试与调试

5.1 本地测试方法

在项目根目录创建测试脚本test/local.js：

const WeatherSkill = require('./src'); const skill = new WeatherSkill(); (async () => { await skill.init(); console.log(await skill.execute({ payload: { text: "查询北京的天气" } })); })();

运行测试时需要先设置API密钥：

export WEATHER_API_KEY=your_key_here node test/local.js

5.2 集成到nanobot

将技能链接到OpenClaw运行环境：

# 在nanobot容器内执行 clawhub link /path/to/weather-query openclaw gateway restart

测试时可以直接在Chainlit界面输入："今天上海天气怎么样？"

6. 发布到社区

6.1 打包技能

首先确保package.json包含完整的元数据：

{ "name": "@yourname/weather-query", "version": "0.1.0", "description": "OpenClaw天气查询技能", "keywords": ["openclaw", "weather", "automation"], "clawhub": { "type": "skill", "runtime": ["nodejs"] } }

然后发布到ClawHub：