ClawHub 技能市场

文档信息

本文全面介绍 ClawHub 技能市场,包括插件分类浏览、安装方法、自定义开发流程以及评分机制等核心内容。


关键词速览

关键词说明
ClawHubOpenClaw 官方技能市场
插件市场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/ML400+图像生成、翻译、OCR
娱乐300+游戏、音乐、段子
社交150+Twitter、Reddit、Discord
电商100+价格追踪、订单管理
金融150+投资、预算、发票
健康80+运动、饮食、冥想
教育120+学习、记忆、测验
其他200+未分类插件

2.2 热门分类详解

2.2.1 生产力类(500+ 插件)

插件名功能下载量
notion-syncNotion 笔记同步50万+
calendar-manager日历管理45万+
email-processor邮件智能处理40万+
task-tracker任务跟踪38万+
reminder-plus智能提醒35万+
pomodoro-timer番茄钟30万+
meeting-notes会议纪要28万+

2.2.2 开发工具类(400+ 插件)

插件名功能下载量
github-actionsGitHub Actions 管理60万+
docker-managerDocker 容器管理55万+
code-reviewer代码审查助手45万+
api-testerAPI 测试工具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-actions

3.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.0

3.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-plugin

4.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 客户端"""
        # 实现客户端初始化逻辑
        pass

5.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:
        """处理特殊案例"""
        # 实现特殊处理逻辑
        pass

5.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

八、相关文档


文档更新于 2026年4月18日