ClawHub 技能市场
文档信息
本文全面介绍 ClawHub 技能市场,包括插件分类浏览、安装方法、自定义开发流程以及评分机制等核心内容。
关键词速览
| 关键词 | 说明 |
|---|---|
| ClawHub | OpenClaw 官方技能市场 |
| 插件市场 | 3200+ 插件供选择 |
| 插件分类 | 按功能领域分类浏览 |
| 插件安装 | 一键安装与配置 |
| 自定义开发 | 开发自己的插件 |
| 插件评分 | 用户评价与推荐 |
| 插件市场 | 插件发现与搜索 |
| 依赖管理 | 插件版本与依赖 |
| 打包发布 | 插件打包与上传 |
| 社区贡献 | 插件开发指南 |
一、ClawHub 概述
1.1 什么是 ClawHub
ClawHub 是 OpenClaw 官方的技能市场(Plugin Marketplace),为 OpenClaw 用户提供丰富的插件扩展选择。截至 2026 年 4 月,ClawHub 已收录超过 3200+ 插件,涵盖生产力、开发工具、信息检索、娱乐等多个领域。
核心理念:
“一个插件市场,让你的 AI 助手无所不能。“
1.2 市场数据概览
| 指标 | 数据 |
|---|---|
| 插件总数 | 3200+ |
| 活跃开发者 | 500+ |
| 下载总量 | 500万+ |
| 平均评分 | 4.2/5.0 |
| 分类数量 | 15 大类 |
| 周更新量 | 100+ 插件 |
1.3 ClawHub 的价值
┌─────────────────────────────────────────────────────────────┐
│ ClawHub 生态系统 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 用户 │ │ 开发者 │ │ OpenClaw│ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌─────────────────────────────────────┐ │
│ │ ClawHub Marketplace │ │
│ │ - 浏览插件 - 安装插件 - 评分插件 │ │
│ └─────────────────────────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ │
│ │ 插件生态 │◄──│ 贡献插件 │ │
│ └──────────┘ └──────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
二、插件分类体系
2.1 大类总览
| 类别 | 插件数量 | 说明 |
|---|---|---|
| 生产力 | 500+ | 日程、邮件、任务、提醒 |
| 开发工具 | 400+ | Git、代码、API、部署 |
| 信息检索 | 600+ | 搜索、新闻、天气、股票 |
| 数据分析 | 300+ | CSV、JSON、可视化 |
| 媒体处理 | 250+ | 图像、音频、视频 |
| 通信 | 200+ | 短信、邮件、通知 |
| 系统工具 | 200+ | 文件、进程、网络 |
| AI/ML | 400+ | 图像生成、翻译、OCR |
| 娱乐 | 300+ | 游戏、音乐、段子 |
| 社交 | 150+ | Twitter、Reddit、Discord |
| 电商 | 100+ | 价格追踪、订单管理 |
| 金融 | 150+ | 投资、预算、发票 |
| 健康 | 80+ | 运动、饮食、冥想 |
| 教育 | 120+ | 学习、记忆、测验 |
| 其他 | 200+ | 未分类插件 |
2.2 热门分类详解
2.2.1 生产力类(500+ 插件)
| 插件名 | 功能 | 下载量 |
|---|---|---|
notion-sync | Notion 笔记同步 | 50万+ |
calendar-manager | 日历管理 | 45万+ |
email-processor | 邮件智能处理 | 40万+ |
task-tracker | 任务跟踪 | 38万+ |
reminder-plus | 智能提醒 | 35万+ |
pomodoro-timer | 番茄钟 | 30万+ |
meeting-notes | 会议纪要 | 28万+ |
2.2.2 开发工具类(400+ 插件)
| 插件名 | 功能 | 下载量 |
|---|---|---|
github-actions | GitHub Actions 管理 | 60万+ |
docker-manager | Docker 容器管理 | 55万+ |
code-reviewer | 代码审查助手 | 45万+ |
api-tester | API 测试工具 | 40万+ |
db-manager | 数据库管理 | 35万+ |
deploy-bot | 一键部署 | 30万+ |
logs-analyzer | 日志分析 | 25万+ |
2.2.3 信息检索类(600+ 插件)
| 插件名 | 功能 | 下载量 |
|---|---|---|
web-search | 多引擎搜索 | 80万+ |
news-aggregator | 新闻聚合 | 65万+ |
weather-pro | 天气查询增强 | 55万+ |
stock-tracker | 股票追踪 | 50万+ |
wiki-search | 维基百科搜索 | 45万+ |
arxiv-reader | 学术论文搜索 | 40万+ |
product-hunt | 产品发现 | 35万+ |
2.3 插件元数据结构
{
"name": "github-actions",
"display_name": "GitHub Actions Manager",
"version": "2.3.1",
"author": {
"name": "devteam",
"github": "https://github.com/devteam",
"rating": 4.8
},
"description": "Manage GitHub Actions workflows from OpenClaw",
"category": "development",
"tags": ["github", "ci-cd", "automation", "devops"],
"downloads": 602341,
"rating": 4.7,
"review_count": 1284,
"license": "MIT",
"homepage": "https://github.com/openclaw-plugins/github-actions",
"source": "https://pypi.org/project/openclaw-github-actions/",
"requirements": ["PyGithub>=1.58"],
"compatibility": {
"openclaw": ">=2.0.0",
"python": ">=3.9"
},
"permissions": ["github_repo", "github_workflow"],
"changelog": [...]
}三、插件浏览与搜索
3.1 命令行浏览
# 列出热门插件
openclaw plugin list --sort=downloads --limit=20
# 按分类浏览
openclaw plugin browse --category productivity
# 搜索插件
openclaw plugin search "github actions"
# 查看插件详情
openclaw plugin info github-actions
# 查看同类推荐
openclaw plugin recommend github-actions3.2 Web UI 浏览
ClawHub 提供网页界面,访问地址:https://clawhub.openclaw.dev
界面功能:
- 分类导航
- 关键词搜索
- 筛选排序(下载量、评分、新发布)
- 插件详情预览
- 用户评价查看
- 一键安装
3.3 搜索语法
# 基础搜索
openclaw plugin search "email"
# 精确搜索
openclaw plugin search "notion-sync" --exact
# 多关键词
openclaw plugin search "github workflow ci"
# 按标签搜索
openclaw plugin search --tag automation --tag github
# 按作者搜索
openclaw plugin search --author devteam
# 组合搜索
openclaw plugin search "productivity" --category productivity --min-rating 4.03.4 搜索结果示例
$ openclaw plugin search "github actions"
Found 47 results for "github actions":
┌─────────────────────────┬────────────────┬───────────┬─────────┐
│ Plugin Name │ Version │ Downloads │ Rating │
├─────────────────────────┼────────────────┼───────────┼─────────┤
│ ⭐ github-actions │ 2.3.1 │ 602,341 │ 4.7/5.0 │
│ GitHub Actions workflow manager │ │ │
├─────────────────────────┼────────────────┼───────────┼─────────┤
│ ⭐ github-ci-validator │ 1.2.0 │ 125,432 │ 4.5/5.0 │
│ Validate CI/CD configurations │ │ │
├─────────────────────────┼────────────────┼───────────┼─────────┤
│ ⭐ actions-runner │ 3.0.0 │ 98,765 │ 4.6/5.0 │
│ Self-hosted runner management │ │ │
└─────────────────────────┴────────────────┴───────────┴─────────┘
[1-3 of 47] Press 'n' for next page, 'q' to quit.
四、插件安装
4.1 一键安装
# 安装单个插件
openclaw plugin install github-actions
# 安装多个插件
openclaw plugin install notion-sync weather-pro email-pro
# 安装指定版本
openclaw plugin install github-actions==2.3.0
# 从 URL 安装
openclaw plugin install https://github.com/user/my-plugin4.2 交互式安装
# 启动交互式安装向导
openclaw plugin install --interactive
# 流程:
# 1. 选择分类或搜索
# 2. 浏览插件列表
# 3. 查看插件详情
# 4. 确认安装
# 5. 配置插件参数
# 6. 完成安装4.3 配置文件安装
# config.yaml
plugins:
# 从市场安装
install:
- name: github-actions
version: "2.3.1"
config:
github_token: "${GITHUB_TOKEN}"
default_repo: "my-org/my-repo"
- name: notion-sync
version: "latest"
config:
api_key: "${NOTION_API_KEY}"
database_id: "xxx"
- name: weather-pro
config:
default_location: "Beijing"
units: "celsius"
- name: email-processor
config:
imap_server: "imap.gmail.com"
smtp_server: "smtp.gmail.com"
email: "${GMAIL_EMAIL}"
password: "${GMAIL_PASSWORD}"4.4 安装后配置
# 查看已安装插件
openclaw plugin list
# 查看插件配置
openclaw plugin config github-actions
# 更新插件
openclaw plugin update github-actions
# 更新所有插件
openclaw plugin update --all
# 卸载插件
openclaw plugin uninstall github-actions
# 查看插件日志
openclaw plugin logs github-actions --tail 50五、自定义插件开发
5.1 插件项目结构
my-custom-plugin/
├── openclaw_plugin.json # 插件元数据
├── pyproject.toml # Python 项目配置
├── src/
│ └── my_plugin/
│ ├── __init__.py
│ ├── plugin.py # 主插件类
│ ├── tools/ # 工具定义
│ │ ├── __init__.py
│ │ └── my_tool.py
│ └── handlers/ # 事件处理器
│ ├── __init__.py
│ └── my_handler.py
├── tests/
│ └── test_plugin.py
├── README.md
└── LICENSE
5.2 插件元数据
// openclaw_plugin.json
{
"schema_version": "2.0",
"name": "my-custom-plugin",
"display_name": "My Custom Plugin",
"version": "1.0.0",
"description": "A custom plugin for OpenClaw",
"author": {
"name": "Your Name",
"email": "you@example.com",
"github": "https://github.com/you"
},
"category": "productivity",
"tags": ["custom", "example"],
"license": "MIT",
"homepage": "https://github.com/you/my-custom-plugin",
"source": {
"type": "git",
"url": "https://github.com/you/my-custom-plugin"
},
"requirements": [
"requests>=2.28.0",
"pydantic>=2.0.0"
],
"compatibility": {
"openclaw": ">=2.0.0",
"python": ">=3.9"
},
"permissions": [],
"configuration": {
"api_key": {
"type": "string",
"required": true,
"description": "API key for the service"
},
"mode": {
"type": "enum",
"options": ["production", "development"],
"default": "production"
}
}
}5.3 插件主类实现
# src/my_plugin/plugin.py
from openclaw.plugins import OpenClawPlugin
from openclaw.core import Tool, ToolResult
from typing import List, Dict
import asyncio
class MyCustomPlugin(OpenClawPlugin):
"""我的自定义插件"""
name = "my-custom-plugin"
version = "1.0.0"
description = "A custom plugin demonstrating OpenClaw plugin development"
def __init__(self, api_key: str, mode: str = "production"):
self.api_key = api_key
self.mode = mode
async def on_load(self, app) -> None:
"""插件加载时调用"""
self.app = app
self.logger = app.logger
# 初始化客户端
self.client = await self._init_client()
self.logger.info(f"MyCustomPlugin loaded in {self.mode} mode")
async def on_unload(self) -> None:
"""插件卸载时调用"""
if hasattr(self, 'client'):
await self.client.close()
self.logger.info("MyCustomPlugin unloaded")
def get_tools(self) -> List[Tool]:
"""返回插件提供的工具"""
return [
MyCustomTool(self.client),
AnotherTool(self.client),
]
def get_commands(self) -> List[Dict]:
"""返回插件提供的命令"""
return [
{
"name": "my-plugin-status",
"description": "Check plugin status",
"handler": self._cmd_status
},
{
"name": "my-plugin-config",
"description": "Show plugin configuration",
"handler": self._cmd_config
}
]
async def _cmd_status(self, args: List[str]) -> str:
"""状态命令处理器"""
return f"Plugin status: {self.mode}, API connected: {self.client is not None}"
async def _cmd_config(self, args: List[str]) -> str:
"""配置命令处理器"""
return f"API Key: {self.api_key[:4]}****, Mode: {self.mode}"
async def _init_client(self):
"""初始化 API 客户端"""
# 实现客户端初始化逻辑
pass5.4 工具定义
# src/my_plugin/tools/my_tool.py
from openclaw.core import Tool, ToolResult
from typing import Dict, Any
import asyncio
class MyCustomTool(Tool):
"""自定义工具"""
name = "my_custom_action"
description = "Perform a custom action with the API"
params = ["action_type", "data"]
def __init__(self, client):
self.client = client
async def execute(
self,
action_type: str,
data: Dict[str, Any],
**kwargs
) -> ToolResult:
"""执行工具"""
try:
if action_type == "create":
result = await self._create(data)
elif action_type == "update":
result = await self._update(data)
elif action_type == "delete":
result = await self._delete(data)
else:
return ToolResult(
success=False,
error=f"Unknown action type: {action_type}"
)
return ToolResult(
success=True,
output=result,
metadata={"action": action_type}
)
except Exception as e:
return ToolResult(
success=False,
error=f"Tool execution failed: {str(e)}"
)
async def _create(self, data: Dict) -> Dict:
"""创建资源"""
return await self.client.create(data)
async def _update(self, data: Dict) -> Dict:
"""更新资源"""
return await self.client.update(data)
async def _delete(self, data: Dict) -> Dict:
"""删除资源"""
return await self.client.delete(data)5.5 事件处理器
# src/my_plugin/handlers/my_handler.py
from typing import Dict, Any
class MyEventHandler:
"""事件处理器"""
def __init__(self, plugin):
self.plugin = plugin
async def on_message_created(
self,
message: Dict[str, Any]
) -> None:
"""消息创建事件"""
# 检查是否需要特殊处理
content = message.get("content", "")
if "specific keyword" in content.lower():
# 执行特定操作
await self._handle_special_case(message)
async def on_tool_executed(
self,
tool_name: str,
result: Any
) -> None:
"""工具执行事件"""
# 记录工具执行日志
self.plugin.logger.info(
f"Tool executed: {tool_name}, success: {result.success}"
)
async def _handle_special_case(self, message: Dict) -> None:
"""处理特殊案例"""
# 实现特殊处理逻辑
pass5.6 打包与发布
# 1. 安装打包工具
pip install build
# 2. 构建包
python -m build
# 3. 发布到 PyPI
pip install twine
python -m twine upload dist/*
# 4. 或发布到 ClawHub
openclaw plugin publish --path ./dist/my-custom-plugin-1.0.0.tar.gz
# 5. 提交到 ClawHub 市场审核
openclaw plugin submit my-custom-plugin --marketplace六、插件评分系统
6.1 评分机制
| 维度 | 权重 | 说明 |
|---|---|---|
| 功能性 | 30% | 插件是否按预期工作 |
| 易用性 | 25% | 安装和配置的难易程度 |
| 文档质量 | 20% | README 和使用文档 |
| 性能 | 15% | 响应速度和资源消耗 |
| 支持 | 10% | 开发者响应和问题解决 |
6.2 评分展示
{
"plugin": "github-actions",
"rating": {
"overall": 4.7,
"functionality": 4.8,
"ease_of_use": 4.6,
"documentation": 4.5,
"performance": 4.7,
"support": 4.6
},
"stats": {
"total_reviews": 1284,
"five_star": 892,
"four_star": 256,
"three_star": 98,
"two_star": 28,
"one_star": 10
},
"trends": {
"last_30_days": "+0.1",
"last_90_days": "+0.2"
}
}6.3 评价示例
## 用户评价
### ⭐⭐⭐⭐⭐ 出色 (By @developer123)
**日期**: 2026-03-15
"这个插件极大提升了我的 GitHub 工作流效率!安装简单,
配置直观,文档清晰。强烈推荐!"
### ⭐⭐⭐⭐ 很好 (By @devops_engineer)
**日期**: 2026-03-10
"功能完整,性能稳定。有个小建议:希望能支持更多的
GitHub Enterprise 功能。"
### ⭐⭐⭐ 中等 (By @newbie)
**日期**: 2026-02-28
"插件不错,但对于新手来说初始配置有点复杂。建议
作者添加更详细的视频教程。"七、插件发现与推荐
7.1 智能推荐算法
# 推荐算法考虑因素
recommendation_factors = {
# 用户历史
"installed_plugins": [...], # 已安装插件
"usage_patterns": {...}, # 使用模式
"ratings_given": [...], # 历史评分
# 插件特征
"similar_users_installed": [...], # 相似用户安装
"category_relevance": {...}, # 分类相关性
"complementary": [...], # 互补插件
# 质量指标
"rating": 4.7, # 评分
"downloads": 600000, # 下载量
"recent_updates": True, # 近期更新
"active_development": True # 活跃开发
}7.2 推荐命令
# 获取个性化推荐
openclaw plugin recommend
# 基于已安装插件推荐
openclaw plugin recommend --similar-to "github-actions"
# 特定场景推荐
openclaw plugin recommend --use-case "devops"
openclaw plugin recommend --use-case "productivity"
openclaw plugin recommend --use-case "data-analysis"
# 趋势插件
openclaw plugin trending --category development
# 新发布插件
openclaw plugin new --category productivity八、相关文档
- OpenClaw完整指南 - OpenClaw 完整指南
- OpenClaw插件开发 - 插件开发详解
- OpenClaw配置详解 - 配置指南
- OpenClaw安装部署 - 安装部署
- OpenClaw高级用法 - 高级用法
文档更新于 2026年4月18日