OpenClaw 技能开发入门指南

3.3 编写 index.js

这是技能的核心逻辑：

// skills/my-first-skill/index.js
module.exports = {
  name: 'my-first-skill',
  description: '我的第一个技能',
  // 执行函数
  async execute(context, params) {
    const name = params.name || '朋友';
    const greetings = [
      `你好呀，${name}！👋`,
      `嘿，${name}，今天过得怎么样？`,
      `哈喽${name}，有什么可以帮你的吗？`
    ];
    // 随机选一句问候
    const randomGreeting = greetings[Math.floor(Math.random() * greetings.length)];
    return { success: true, message: randomGreeting };
  }
};

3.4 注册技能

在工作区的配置文件中添加技能路径，或者在会话中加载：

# 在 OpenClaw 中加载技能
openclaw skill load ./skills/my-first-skill

3.5 测试技能

现在跟你的 AI 助手说你好，看看它会不会调用你的技能！

四、实战：开发一个天气查询技能

光说 Hello World 太没意思了，咱们来做个实用的天气查询技能！

4.1 选择天气 API

推荐使用 wttr.in，因为它：

• 免费，不需要 API 密钥
• 支持中文
• 返回格式简单

4.2 创建技能目录

mkdir -p skills/weather-skill
cd skills/weather-skill

4.3 编写 SKILL.md

# weather-skill
## 描述
查询指定城市的天气信息。
## 触发条件
当用户询问天气、温度、预报时触发。
## 输入参数
- city: 城市名称（必填）
## 输出
返回当前天气状况、温度、湿度等信息。
## 示例
- 用户：北京天气怎么样？
- AI：调用 weather-skill，city=北京

4.4 编写 index.js

// skills/weather-skill/index.js
const https = require('https');

module.exports = {
  name: 'weather-skill',
  description: '查询城市天气',
  async execute(context, params) {
    const city = params.city;
    if (!city) {
      return { success: false, message: '请告诉我你想查询哪个城市的天气～' };
    }

    // 调用 wttr.in API
    return new Promise((resolve, reject) => {
      const url = `https://wttr.in/${encodeURIComponent(city)}?format=j1`;
      let data = '';
      https.get(url, (res) => {
        res.on('data', chunk => data += chunk);
        res.on('end', () => {
          try {
            const weather = JSON.parse(data);
            const current = weather.current_condition[0];
            const result = {
              success: true,
              data: {
                city: city,
                temp: current.temp_C + '°C',
                weather: current.weatherDesc[0].value,
                humidity: current.humidity + '%',
                windSpeed: current.windspeedKmph + 'km/h'
              }
            };
            resolve(result);
          } catch (e) {
            resolve({ success: false, message: '天气查询失败，请稍后再试～' });
          }
        });
      }).on('error', reject);
    });
  }
};

4.5 测试效果

用户：北京天气怎么样？

AI：北京今天晴，气温 25°C，湿度 45%，风速 12km/h。适合出门哦！☀️

五、技能开发最佳实践

5.1 错误处理要完善

技能执行可能会失败，一定要处理异常情况：

try {
  // 执行逻辑
} catch (error) {
  return { success: false, message: '出错了：' + error.message };
}

5.2 返回格式要统一

建议统一返回格式，方便 AI 处理：

{
  "success": true/false,
  "data": { ... },
  "message": "..."
}

5.3 技能描述要清晰

SKILL.md 写得越清楚，AI 越知道什么时候调用这个技能。包括：

• 触发条件
• 输入参数
• 输出格式
• 使用示例

5.4 敏感操作要谨慎

涉及以下操作时要特别注意：

• 删除文件/数据
• 发送外部消息
• 访问私密信息

建议加一层确认机制，或者需要用户明确授权。

六、技能发布与分享

6.1 本地技能

放在工作区的 skills/ 目录下，仅当前工作区可用。

6.2 全局技能

安装到全局，所有工作区都能用：

npm install -g openclaw-skill-xxx

6.3 分享技能

可以把技能发布到 GitHub、npm 等平台，供他人使用。

七、进阶：调用外部 API

很多技能需要调用第三方 API，提供一个通用模板：

const axios = require('axios');

async function callExternalAPI(endpoint, params, apiKey) {
  try {
    const response = await axios.get(endpoint, {
      params: params,
      headers: { 'Authorization': `Bearer ${apiKey}` }
    });
    return response.data;
  } catch (error) {
    throw new Error('API 调用失败：' + error.message);
  }
}

常用 API 推荐：

• 天气：wttr.in、OpenWeatherMap
• 汇率：exchangerate-api.com
• 新闻：newsapi.org
• 翻译：Google Translate API

结语

总结一下：

1. 技能让 AI 从会聊变会干
2. 开发技能需要 JS 基础
3. 从简单开始，逐步迭代
4. 错误处理和文档很重要