夜雨聆风
改朝换代:ClawHub上线,旧插件时代终结
上周，我像往常一样在终端输入了一条命令：
openclaw plugins install weather结果——它去 ClawHub 搜了一圈，告诉我「已在 ClawHub 找到同名插件，是否安装？」
我愣了两秒。什么？不是说好用 npm 装吗？
翻了一圈 changelog 才搞清楚：OpenClaw 在 3 月底做了一次伤筋动骨的大更新，插件生态正式从 npm 全面迁移到 ClawHub——这不是小修小补，是整个插件注册中心的大换血。
如果你最近发现装插件的方式变了，或者新装的插件不生效，这篇文章就是为你写的。
一、发生了什么：插件生态大迁移
背景：2026 年 3 月底，OpenClaw 推送了一个大版本（涵盖 v2026.3.22 及后续更新），核心变化之一是把插件分发渠道从 npm 全面迁移到 ClawHub。
发生了什么变化？
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
一句话总结： 以前装插件是从「杂货铺」（npm）里淘，现在是从「专营店」（ClawHub）里拿。
更重要的是：这次迁移伴随着 Plugin SDK 重构——旧路径是 openclaw/extension-api（巨石式导出），新路径是 openclaw/plugin-sdk/*（窄接口子路径）。如果你之前写过自定义插件，这次需要做适配迁移。
二、ClawHub到底是什么：为什么这次不一样
ClawHub（clawhub.ai）是 OpenClaw 官方维护的插件注册中心，可以理解为「OpenClaw 专属的 App Store」。
它解决什么问题？
问题一：信任问题
npm 上的包良莠不齐，任何人都可以上传，同名包可能被抢注或植入恶意代码。ClawHub 对每个插件做了基础审核上架，信任度更高。
问题二：发现体验差
用 npm 搜插件，出来一堆同名但功能完全不同的包，需要自己筛选。ClawHub 的插件描述、标签、截图都是针对 OpenClaw 定制的，找起来快很多。
问题三：版本碎片化
npm 上很多 OpenClaw 插件多年没更新，API 早已不兼容。ClawHub 有更新追踪机制，可以更清楚地看到哪些插件已过时。
三、迁移实操：新旧命令完整对照
第一步：安装 ClawHub CLI（如果你还没装）
|
|
|
|
第二步：登录 ClawHub
|
|
|
|
|---|---|---|
|
|
clawhub login |
|
|
|
clawhub login --token clh_xxx |
|
获取 Token：访问 https://clawhub.ai/cli/auth
第三步：核心命令对照
|
|
|
|
|---|---|---|
|
|
npm search openclaw-xxx |
clawhub search xxx |
|
|
openclaw plugins install xxx |
clawhub install xxx |
|
|
npm update -g xxx |
clawhub update |
|
|
npm uninstall -g xxx |
clawhub uninstall xxx |
|
|
openclaw skills list |
|
💡 重要提示：
openclaw plugins install xxx现在会优先查 ClawHub，未命中才回退 npm。已有插件不受影响，新装插件建议用 ClawHub。
OpenClaw 自带命令不受影响：
|
|
|
|---|---|
openclaw skills list |
|
openclaw skills info <name> |
|
openclaw skills check |
|
openclaw gateway restart |
|
四、三个踩坑实录与修复
坑一：Rate Limit（速率限制）
场景：连续快速安装多个插件，ClawHub 报「Rate limit exceeded」
原因：ClawHub 有匿名请求频率限制，短时间内大量请求会被临时封 IP
💡 方案一（推荐）：登录后再操作
登录后有更高的请求配额，大多数场景够用：
|
|
|
|
💡 方案二：使用 SkillHub（国内镜像）
如果 ClawHub 访问不稳定，可以换用国内镜像
skillhub.coze.cn，两者功能基本一致。
坑二：旧插件不兼容
场景：某个旧插件装上之后不生效，报错「extension-api 已弃用」
原因：插件使用了旧版 openclaw/extension-api，新版 SDK 已重构
💡 Step 1：检查插件是否已有新版本
|
|
💡 Step 2：如果官方没有更新，查看 ClawHub 是否有替代插件
|
|
💡 Step 3：反馈给插件作者
大多数插件维护者会在收到 issue 后尽快更新 SDK 版本。
坑三：npm 自定义 registry 冲突
场景：配置了公司内部 npm registry 后，clawhub install 行为异常
原因：ClawHub 有独立的解析逻辑，和 npm registry 配置可能产生冲突
💡 修复方案：显式指定 ClawHub 源，避免被 npm 配置干扰
|
|
💡 如果仍有问题，可以临时还原 registry 配置：
|
|
|
|
|
|
五、快速上手清单
☐ 第一步：安装 ClawHub CLI
|
|
|
|
☐ 第二步：登录（推荐）
|
|
☐ 第三步：搜索并安装插件
|
|
|
|
|
|
☐ 第四步：验证插件加载成功
|
|
|
|
☐ 附：推荐新手装的 5 个插件
|
|
|
|---|---|
self-improving-agent |
|
find-skills |
|
summarize |
|
agent-browser |
|
github |
|
我的总结：这次插件生态大迁移，本质上是 OpenClaw 从「用通用工具做专有事」转向「用专用工具做专有事」。ClawHub 不是 npm 的简单替代，而是一套为 AI Agent 插件量身定制的分发机制——更好的信任验证、更准的搜索、更干净的版本管理。对于普通用户：装完 ClawHub CLI，记住一条新命令就够了——
clawhub install。对于开发者：旧插件尽快适配新 SDK，别让用户等太久。
📚 如果文章对你有帮助，欢迎关注公众号「小龙虾踩坑指南」
第一时间收到我的实战经验、工具推荐和避坑总结，持续更新中：
