OpenClaw 技能生态：ClawHub 5700+ 插件全指南

ClawHub：龙虾的技能市场

如果说 OpenClaw 是龙虾的身体，那 ClawHub 上的 5700+ 技能就是龙虾的装备库。每个技能（Skill）是一个独立的能力模块，让 Agent 获得新的工具和能力。

类比一下：

npm 之于 Node.js = ClawHub 之于 OpenClaw
App Store 之于 iPhone = ClawHub 之于 OpenClaw
Chrome 插件商店之于 Chrome = ClawHub 之于 OpenClaw

技能插件架构

技能结构

一个 OpenClaw 技能的标准目录结构：

my-skill/
├── SKILL.md          # 技能定义文件（必需）
├── tools/
│   ├── search.js     # 工具实现
│   └── format.js
├── assets/
│   └── template.html
├── examples/
│   └── usage.md
└── package.json      # 元数据

SKILL.md 格式

---
name: weather-pro
version: 1.2.0
author: "claw-community"
description: "专业天气查询技能，支持全球城市、7天预报、历史天气"
categories: ["开源生态"]
permissions:
  - "network:read"     # 需要网络读权限
capabilities:
  - weather_query
  - weather_forecast
  - weather_history
hooks:
  on_load: "initCache"
  on_unload: "cleanup"
  on_error: "fallback"
config:
  default_unit: "celsius"
  cache_ttl: 300
---

## 工具

### get_weather
查询指定城市当前天气。

参数：
- city (string, 必需): 城市名称
- unit (string, 可选): "celsius" | "fahrenheit"

返回：
```json
{
  "city": "北京",
  "temp": 32,
  "condition": "晴",
  "humidity": 45,
  "wind": "东南风3级"
}

get_forecast

获取7天天气预报。

参数：

city (string, 必需): 城市名称


### 工具实现

```javascript
// tools/search.js
module.exports = {
  name: "get_weather",
  description: "查询指定城市当前天气",
  parameters: {
    city: { type: "string", required: true },
    unit: { type: "string", enum: ["celsius", "fahrenheit"], default: "celsius" }
  },
  
  async execute({ city, unit }, context) {
    const response = await fetch(
      `https://api.weather.com/v1/current?city=${encodeURIComponent(city)}`
    );
    const data = await response.json();
    
    return {
      city: data.location.name,
      temp: unit === "fahrenheit" ? data.temp_f : data.temp_c,
      condition: data.condition,
      humidity: data.humidity,
      wind: data.wind_desc
    };
  }
};

排名	技能名	类别	评分	安装量	描述
1	web-search	工具	4.9	98K	多搜索引擎集成搜索
2	file-manager	工具	4.9	87K	文件增删改查、批量操作
3	cron-scheduler	效率	4.8	76K	定时任务和提醒
4	email-pro	集成	4.8	65K	邮件收发管理
5	code-runner	工具	4.7	58K	代码执行沙箱
6	web-scraper	工具	4.7	52K	网页抓取和解析
7	telegram-bot	集成	4.7	48K	Telegram 接入
8	pdf-toolkit	工具	4.6	45K	PDF 读写、合并、拆分
9	calendar-sync	集成	4.6	42K	日历同步管理
10	image-gen	创意	4.6	39K	AI 图像生成
11	github-assistant	集成	4.5	35K	GitHub 仓库管理
12	translate-pro	工具	4.5	33K	多语言翻译
13	data-analyzer	工具	4.5	31K	数据分析和可视化
14	meeting-notes	效率	4.4	28K	会议纪要自动生成
15	smart-home	集成	4.4	25K	IoT 设备控制
16	legal-assistant	行业	4.3	22K	法律文书辅助
17	finance-tracker	行业	4.3	20K	财务记账分析
18	video-editor	创意	4.2	18K	视频编辑处理
19	social-media	集成	4.2	16K	社媒自动发布
20	voice-tts	创意	4.1	15K	语音合成播报

技能安装与管理

命令行操作

# 搜索技能
openclaw skills search "weather"
openclaw skills search "文件管理" --category tools

# 安装技能
openclaw skills install weather-pro
openclaw skills install weather-pro@1.2.0  # 指定版本

# 批量安装
openclaw skills install web-search file-manager cron-scheduler

# 从配置文件安装
openclaw skills install --from package.yaml

# 查看已安装
openclaw skills list
# ┌────────────────┬─────────┬────────┬──────────┐
# │ Skill          │ Version │ Status │ Size     │
# ├────────────────┼─────────┼────────┼──────────┤
# │ web-search     │ 2.1.0   │ active │ 1.2 MB   │
# │ file-manager   │ 1.5.0   │ active │ 890 KB   │
# │ weather-pro    │ 1.2.0   │ active │ 450 KB   │
# │ cron-scheduler │ 3.0.1   │ active │ 1.1 MB   │
# └────────────────┴─────────┴────────┴──────────┘

# 更新技能
openclaw skills update weather-pro
openclaw skills update --all

# 卸载技能
openclaw skills uninstall weather-pro

# 查看技能详情
openclaw skills info weather-pro

热加载

技能支持热加载，无需重启 Agent：

# Agent 运行中安装技能
openclaw skills install pdf-toolkit

# 自动热加载
# [INFO] Installing pdf-toolkit@1.8.0...
# [INFO] Loading skill into running agent...
# [INFO] ✅ pdf-toolkit is now active!

// 编程式热加载
const agent = openclaw.getAgent();
await agent.skills.load("pdf-toolkit");
// 技能立即可用，无需重启

await agent.skills.unload("pdf-toolkit");
// 技能立即卸载

自定义技能开发

创建技能骨架

openclaw skills create my-skill
# ? 技能名称: my-awesome-skill
# ? 描述: 一个超棒的技能
# ? 类别: tools
# ? 需要哪些权限? network:read, file:write
# ✅ 技能骨架已创建: ./my-awesome-skill/

生成的目录：

my-awesome-skill/
├── SKILL.md
├── tools/
│   └── main.js      # 工具入口
├── package.json
└── README.md

编写工具

// tools/main.js
module.exports = {
  name: "my_tool",
  description: "执行自定义操作",
  parameters: {
    input: {
      type: "string",
      required: true,
      description: "输入内容"
    },
    mode: {
      type: "string",
      enum: ["fast", "thorough"],
      default: "fast"
    }
  },
  
  async execute({ input, mode }, context) {
    // context 包含 agent 状态、记忆、其他技能引用
    const { memory, skills, logger } = context;
    
    logger.info(`Processing input in ${mode} mode`);
    
    // 可以调用其他已安装的技能
    if (mode === "thorough") {
      const searchResults = await skills.call("web-search", {
        query: input
      });
      return { searchResults };
    }
    
    return { result: input.toUpperCase() };
  }
};

技能配置

# SKILL.md
---
name: my-awesome-skill
version: 1.0.0
author: "your-name"
description: "一个超棒的技能"
categories: ["开源生态"]
permissions:
  - "network:read"
capabilities:
  - custom_operation
config:
  default_mode: "fast"
  max_retries: 3
hooks:
  on_load: "init"
  on_unload: "cleanup"
---

本地测试

# 本地加载测试
openclaw skills load ./my-awesome-skill --test

# 模拟工具调用
openclaw skills test my-awesome-skill --tool my_tool --input '{"input":"hello"}'
# → { result: "HELLO" }

发布到 ClawHub

# 登录 ClawHub
openclaw skills login
# ? ClawHub 用户名: your-username
# ? API Token: xxxxxx

# 发布
openclaw skills publish
# [INFO] 打包技能...
# [INFO] 上传到 ClawHub...
# [INFO] 等待审核...
# [INFO] ✅ 已发布！等待社区审核通过后公开。

# 查看发布状态
openclaw skills status
# ┌────────────────────┬───────────┬──────────────┐
# │ my-awesome-skill   │ reviewing │ 2026-06-25   │
# └────────────────────┴───────────┴──────────────┘

版本管理

ClawHub 使用语义化版本（SemVer）：

MAJOR.MINOR.PATCH
1.2.3
│ │ └── 修复 bug
│ └──── 新功能，向后兼容
└────── 重大变更，可能不兼容

# 发布补丁版本
openclaw skills publish --bump patch   # 1.2.3 → 1.2.4

# 发布小版本
openclaw skills publish --bump minor   # 1.2.3 → 1.3.0

# 发布大版本
openclaw skills publish --bump major   # 1.2.3 → 2.0.0

技能可以声明依赖：

# SKILL.md
dependencies:
  web-search: ">=2.0.0"
  file-manager: "^1.5.0"

安装时自动解析依赖：

openclaw skills install my-awesome-skill
# [INFO] 安装 my-awesome-skill@1.0.0
# [INFO] 依赖: web-search@2.1.0 (已安装 ✅)
# [INFO] 依赖: file-manager@1.5.0 (需要安装)
# [INFO] 安装 file-manager@1.5.0...
# [INFO] ✅ 全部就绪

技能审核机制

ClawHub 有自动 + 人工的审核流程：

自动检查

安全扫描：检测恶意代码、硬编码密钥、危险操作
格式验证：SKILL.md 格式、参数定义完整性
依赖检查：依赖是否存在、版本是否兼容
大小限制：单技能 ≤ 50MB

人工审核

自动检查通过后进入人工审核队列
审核标准：功能可用性、文档质量、安全性
审核周期：通常 1-3 个工作日
审核通过后公开发布

安全等级

等级	说明	示例权限
🟢 低	只读操作，无网络	file:read
🟡 中	网络读取或文件写入	network:read, file:write
🟠 高	网络写入或命令执行	network:write, exec
🔴 极高	数据删除或系统操作	file:delete, system

用户在安装时会看到安全等级提示，橙色及以上需要确认。

技能推荐引擎

OpenClaw 会根据使用习惯推荐技能：

openclaw skills recommend
# 根据你的使用习惯，推荐以下技能：
#
# ┌──────────────────┬──────────────────────────────┐
# │ meeting-notes    │ 你经常用 calendar-sync，      │
# │                  │ 会议纪要技能可以配合使用       │
# ├──────────────────┼──────────────────────────────┤
# │ data-analyzer    │ 你用 code-runner 执行数据分析，│
# │                  │ 这个技能提供专业可视化         │
# └──────────────────┴──────────────────────────────┘

结语

5700+ 技能不是终点，而是一个不断增长的生态。ClawHub 的繁荣证明了 OpenClaw “社区驱动"的理念是正确的——当工具足够丰富、门槛足够低时，创作者自然会来。

无论你是技能的使用者还是创作者，ClawHub 都有你的一席之地。养虾的乐趣，一半在于龙虾本身，一半在于给它装配各种装备。

下一篇我们深入 OpenClaw 的记忆系统，看看龙虾如何记住你。🦞

加入讨论

这篇文章有姊妹讨论帖在硅基AGI论坛 — 全球首个碳基硅基认知交流平台。

碳基与硅基的智慧碰撞，认知差异创造无限可能。

ClawHub：龙虾的技能市场#

技能插件架构#

技能结构#

SKILL.md 格式#

get_forecast#

热门技能 TOP 20#

技能安装与管理#

命令行操作#

热加载#

自定义技能开发#

创建技能骨架#

编写工具#

技能配置#

本地测试#

发布到 ClawHub#

版本管理#

技能审核机制#

自动检查#

人工审核#

安全等级#

技能推荐引擎#

结语#

加入讨论#

📌 相关推荐