16. ClawHub 插件生态与自定义插件

本节目标：搞懂 ClawHub 是什么、在上面能淘到什么、怎么安全地装，以及想自己写一个插件时的大致路径。

一句话定义

ClawHub 是 OpenClaw 的官方技能与插件市场。

你在第 13 章认识的 Skill（技能），以及更重一些的 Plugin（插件），大多都能在 ClawHub 上找到并一键安装。它有点像手机上的应用商店，只是装的不是 App，而是 AI 的新本领。

Note

OpenClaw 本身是 MIT 协议、自托管的开源项目。ClawHub 是它官方运营的分发渠道，社区开发者把做好的技能和插件往上面传，你按需取用。

技能和插件，别再混

在 ClawHub 上你会同时看到两类东西，要分清：

技能（Skills）：一份 SKILL.md 说明书，轻量，教 AI 怎么做事。装好即生效。
插件（Plugins）：带代码的扩展包，能注册新工具、新模型提供商、钩子（hooks）等。能力更强，也更重。

日常八成需求，一个技能就解决了。只有要”给 AI 接一个新工具、新模型源”时，才需要插件。

去哪找、怎么装

最常用的入口就是命令行。找技能和找插件是两条命令：

# 在 ClawHub 上搜技能
openclaw skills search "calendar"

# 安装一个技能
openclaw skills install @owner/<slug>

# 在 ClawHub 上搜插件
openclaw plugins search "calendar"

# 从 ClawHub 装一个插件（注意 clawhub: 前缀）
openclaw plugins install clawhub:<package>

Tip

技能默认装进当前工作区的 skills/；加 --global 就装到共享目录 ~/.openclaw/skills，所有智能体都能用。插件同理。

npm 也是一个备用的安装来源。但 ClawHub 才是官方主推的发现与分发面，大多数社区作品首选在那上面发布。

安全：第三方包要设防

装来路不明的包，等于让一段别人的代码跑在你机器上。OpenClaw 在这一点上有明确的分级：

恶意或已被封禁的发布，直接拒绝安装。
有风险的发布（扫描不干净、处在非阻断的审核态），会弹出警告，需要你显式确认才继续。
官方和内置来源跳过这个确认，因为它们本来就受信任。

# 确认过风险后，非交互安装社区包
openclaw skills install @owner/<slug> --acknowledge-clawhub-risk

Warning

这条 --acknowledge-clawhub-risk 是”我看过警告、愿意承担”的意思。别在脚本里无脑加它。装第三方东西前，最好先去 ClawHub 页面看作者、看评分、看是否官方认证。

装完之后，例行更新也要走信任检查：

openclaw skills update --all
openclaw plugins update --all

自定义插件：从脚手架开始

现成的不够用，想自己写一个？OpenClaw 给了脚手架，不要求你从零搭框架。

先生成一个最小 TypeScript 工具插件：

openclaw plugins init stock-quotes --name "Stock Quotes"
cd stock-quotes
npm run plugin:build
npm run plugin:validate

plugins init 会帮你建好目录、package.json 脚本和元数据文件。你只要往里填自己的工具逻辑。

构建和校验：

openclaw plugins build      # 生成 openclaw.plugin.json 等元数据
openclaw plugins validate   # 检查元数据与导出是否一致

想接的不只是工具，而是”新的模型提供商”？用另一种脚手架：

openclaw plugins init acme-models --name "Acme Models" --type provider

Note

自定义插件属于工程活，涉及写代码、配清单、处理凭据。本教程只点到”从脚手架起步、构建、校验”这一层思路，不展开完整工程。真要动手，以官方插件开发文档为准。

发布出去给别人用

写好了，可以发到 ClawHub，让社区也能装：

# 先装独立的发布 CLI
npm i -g clawhub
clawhub login

# 发布一个技能文件夹
clawhub skill publish ./skills/review-helper

# 发布一个插件包
clawhub package publish ./my-plugin

发布后别人就能用 openclaw skills install @你的名/<slug> 装到。日常维护还有 clawhub sync --all 一键扫描本地、把新的或改过的作品同步上去。

Tip

打算长期维护一个插件？在发布前把占位用的 API 地址、模型目录、说明文案都换成真实的，再跑一遍 validate，省得别人装了跑不起来。

小结

ClawHub 让”能力”变成了可以买卖/分享的商品：

找能力 → openclaw skills/plugins search
装能力 → install（第三方注意信任分级）
造能力 → plugins init 起手，写好再 clawhub publish

生态再热闹，安全那条线别松：官方源放心用，社区源看清楚再装。下一章我们看另一类”让它自己干活”的机制——自动化。