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

OpenClaw开源贡献指南：为nanobot镜像开发共享技能模块

news 2026/8/18 10:43:49

OpenClaw开源贡献指南：为nanobot镜像开发共享技能模块

1. 为什么需要社区贡献技能模块

去年夏天，当我第一次接触OpenClaw时，最让我惊喜的不是它强大的自动化能力，而是它开放的技能生态。作为一个长期在本地运行Qwen模型的开发者，我发现自己经常重复编写类似的脚本——从简单的天气查询到复杂的日志分析。直到有一天，我在ClawHub上发现了一个与我需求高度匹配的第三方技能模块，这让我意识到：共享才是开源生态的真正价值。

在nanobot这样的轻量级OpenClaw镜像中，社区贡献的技能模块尤为重要。由于镜像本身追求极简设计（比如内置的Qwen3-4B模型只有4B参数），通过技能扩展能力就成为最灵活的方案。想象一下：你开发的天气查询技能可能被另一位开发者用于他的自动化日报生成流程，而他的Markdown转换技能又可能成为别人工作流的关键组件——这就是生态共建的魔力。

2. 准备开发环境

2.1 基础环境配置

在开始开发前，我们需要确保本地环境与nanobot镜像兼容。我的MacBook Pro（M1芯片）上这样配置：

# 安装Node.js（建议v18+） brew install node@18 # 克隆nanobot示例仓库 git clone https://github.com/openclaw/nanobot-starter.git cd nanobot-starter # 安装依赖 npm install @openclaw/core clawhub-sdk

这里有个小插曲：最初我直接使用最新版Node.js（v20），结果发现与nanobot的chainlit界面存在兼容性问题。后来在社区Discord频道了解到，v18才是当前最稳定的选择——这提醒我们，即使是基础环境也要注意版本匹配。

2.2 技能开发工具包

OpenClaw提供了官方SDK来简化开发流程。在项目根目录创建skills/weather文件夹，然后初始化技能：

npx clawhub init-skill --name=weather --author=yourname

这会生成标准目录结构：

weather/ ├── package.json # 技能元数据 ├── src/ │ ├── index.ts # 主逻辑 │ └── schema.ts # 输入输出定义 └── test/ # 测试用例

特别要注意schema.ts中的输入输出定义，这决定了技能如何被OpenClaw调度。比如我们的天气查询技能需要这样定义：

// schema.ts export const inputSchema = z.object({ location: z.string().describe("城市名称，如'北京'"), unit: z.enum(['celsius', 'fahrenheit']).default('celsius') }); export const outputSchema = z.object({ temperature: z.number(), condition: z.string(), forecast: z.array(z.object({ date: z.string(), high: z.number(), low: z.number() })) });

3. 开发天气查询技能

3.1 对接天气API

我选择心知天气API作为数据源，因为它的免费套餐足够个人使用。在src/index.ts中实现核心逻辑：

import axios from 'axios'; export default async function execute(input: Input): Promise<Output> { const { location, unit } = input; // 从环境变量读取API密钥 const apiKey = process.env.WEATHER_API_KEY; if (!apiKey) throw new Error('Missing WEATHER_API_KEY'); const response = await axios.get(`https://api.seniverse.com/v3/weather/daily.json`, { params: { key: apiKey, location, days: 3, unit: unit === 'fahrenheit' ? 'f' : 'c' } }); const daily = response.data.results[0].daily; return { temperature: daily[0].high, // 当前最高温作为主温度 condition: daily[0].text_day, forecast: daily.map(day => ({ date: day.date, high: day.high, low: day.low })) }; }

这里有个值得分享的教训：最初我把API密钥硬编码在代码中，直到在GitHub安全扫描中收到警告才意识到问题。现在所有敏感信息都通过环境变量注入，这也是OpenClaw官方推荐的做法。

3.2 本地测试技能

在nanobot镜像中测试前，我们可以先用CLI工具验证：

# 设置环境变量 export WEATHER_API_KEY=your_key_here # 运行测试 npx clawhub test-skill ./skills/weather -i '{"location":"上海"}'

如果看到类似以下输出，说明技能运行正常：

{ "temperature": 28, "condition": "多云", "forecast": [ {"date": "2024-03-15", "high": 28, "low": 22}, {"date": "2024-03-16", "high": 26, "low": 20} ] }

4. 提交到开源社区

4.1 准备GitHub仓库

Fork官方nanobot示例仓库到你自己的GitHub账号
将你的技能模块提交到skills目录
确保包含完整的文档说明（至少要有README.md）

我的weather技能目录结构最终如下：

weather/ ├── README.md # 使用说明 ├── package.json ├── src/ │ ├── index.ts │ └── schema.ts ├── test/ │ └── index.test.ts └── .env.example # 环境变量模板

4.2 创建Pull Request

在GitHub界面操作：

从你的fork切换到new-feature分支
点击"Contribute" → "Open Pull Request"
按照模板填写信息，特别要说明：
- 技能的功能场景
- 必要的环境配置
- 测试覆盖情况

我的PR描述示例：

## 新增天气查询技能 ### 功能描述 提供未来3天天气预报查询，支持摄氏/华氏温度切换 ### 使用场景 - 自动化日报生成 - 出行计划提醒 - 智能家居联动 ### 测试验证 - [x] 单城市查询 - [x] 温度单位切换 - [x] 错误处理（无效城市/密钥）

4.3 通过CI检查

nanobot仓库配置了自动化检查，你的PR需要通过：

代码格式检查（ESLint）
类型检查（TypeScript）
单元测试覆盖率（至少80%）
安全扫描（包括敏感信息检测）

我第一次提交时就因为测试覆盖率只有78%被要求补充用例。通过这个流程，我学会了如何编写更完备的边界条件测试。

5. 技能被合并后的使用方式

当你的PR被合并后，其他用户可以通过两种方式使用你的技能：

5.1 通过CLI安装

clawhub install @community/weather

5.2 在nanobot对话中安装

用户只需对OpenClaw说：

安装天气查询技能

然后按照引导设置API密钥：

请设置天气API密钥：sk_xxxxxx

6. 开发进阶技巧

6.1 技能组合使用

真正强大的功能来自技能组合。比如我们可以创建一个"出行建议"技能，它内部调用了天气查询技能：

import { execute as weatherExecute } from '@community/weather'; export default async function execute(input: TravelInput) { const weather = await weatherExecute({ location: input.destination, unit: 'celsius' }); return { suggestion: weather.temperature > 30 ? "建议携带防晒用品" : "适合户外活动", weather: weather.condition }; }