OpenClaw v2026.3.22起必须使用ClawHub插件市场,禁用npm安装方式,否则插件无法加载、技能调用失败且安全机制自动禁用;需确认版本≥v2026.3.22,配置plugins.source为clawhub,安装命令须带clawhub:前缀,旧npm插件全部失效不可降级。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在OpenClaw v2026.3.22中正确使用ClawHub插件中心,而不是继续沿用旧版npm安装方式,否则插件将无法加载、技能调用直接失败,且部分安全防护机制会因插件签名不匹配而自动禁用。
确认当前版本并强制升级
打开终端,执行openclaw --version,输出必须为v2026.3.22或更高(如v2026.3.31)。若低于此版本,立即运行:openclaw update --force。
这一步不可跳过——v2026.3.22起所有插件校验逻辑绑定新签名体系,旧版本即使手动安装ClawHub插件也会被拒绝加载。
ClawHub插件市场启用与源配置
方法一:一键启用官方源(推荐)
执行:openclaw plugins source set clawhub。
方法二:手动检查并修正配置文件
打开~/.openclaw/config.yaml,确认plugins.source字段值为clawhub,不是npm或空值。【空值会导致插件安装时静默回退到npm,但新版已移除npm兼容层,结果必报错】
方法三:临时覆盖源(调试用)
安装单个插件时指定源:openclaw plugins install clawhub:sonoscli。注意语法必须含clawhub:前缀,漏掉冒号会触发旧路径解析器并失败。
插件安装与技能管理全流程
第一步:搜索可用技能
执行:openclaw skills search "飞书流式输出"。返回结果包含技能ID、描述、作者、ClawHub评分及兼容性标记(如✅ v2026.3.22+)。
第二步:安装指定技能
复制搜索结果中的ID(例如feishu-stream-v2),运行:openclaw skills install feishu-stream-v2。系统自动从ClawHub拉取、校验签名、解压并注册到本地Memory模块。
第三步:验证是否生效
执行:openclaw skills list --active,确认新技能状态为enabled且last_sync时间戳在当前分钟内。若显示pending或failed,说明ClawHub证书链未信任,需运行openclaw doctor --fix tls修复。
这一步操作起来很简单,直接把文件拖进去就行。
旧插件迁移与兼容性处理
旧版通过npm install -g openclaw-plugin-xxx安装的插件全部失效,无法自动转换。
必须由开发者完成迁移:将原插件代码重构为openclaw/plugin-sdk/v3规范,添加clawhub.json元数据文件,并提交至ClawHub审核队列。用户端无替代方案。
如果你正在运行企业私有化部署,且依赖某款未上架ClawHub的旧插件,请立即联系该插件作者索取v3 SDK适配版;【等待期间该插件功能将完全不可用,无降级兼容选项】。











