背景:

外部 Skill 生态鱼龙混杂,恶意插件如同”特洛伊木马”,一旦引入便可能危及内网安全。搭建 SkillHub 构建企业内部市场,为企业应用保驾护航。

快速安装SkiilHub

前置条件
Docker 20.10 或更高版本
Docker Compose v2.0 或更高版本

# 默认Centos机器安装的版本都很低,使用外部镜像源进行安装
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin
systemctl start docker

使用脚本一键安装skillhub

cd /tmp
curl -fsSL https://raw.githubusercontent.com/iflytek/skillhub/main/scripts/runtime.sh | sh -s -- up

部署后发现官网对应的脚本,无法匿名拉取SkillHub中公开的技能,更换版本为v0.1.0

# 卸载原SkillHub,安装新版本
docker-compose -f skillhub-runtime/compose.release.yml down -v
curl -fsSL https://github.com/iflytek/skillhub/blob/chore/release-v0.1.0/scripts/runtime.sh | sh -s -- up

脚本的超时比较激进,会直接出现超时停止,先配置管理员账号和密码
vi skillhub-runtime/.env.release

BOOTSTRAP_ADMIN_ENABLED=true
BOOTSTRAP_ADMIN_USER_ID=docker-admin
BOOTSTRAP_ADMIN_USERNAME=admin
BOOTSTRAP_ADMIN_PASSWORD=nmk@2026
BOOTSTRAP_ADMIN_DISPLAY_NAME=Platform Admin
BOOTSTRAP_ADMIN_EMAIL=admin@example.com

⚠️ 一定要设置BOOTSTRAP_ADMIN_ENABLED为true,并且配置BOOTSTRAP_ADMIN_PASSWORD,否则没有超管权限

通过docker compose安装启动

docker compose --env-file skillhub-runtime/.env.release -f skillhub-runtime/compose.release.yml up -d

浏览器访问

访问SkillHub的IP即可,默认端口为80

使用配置文件中的账号密码登陆

控制台页面,菜单可以看到有很多功能管理,这里只展示技能相关,其他不再赘述

发布技能

技能详情

审核页面

Openclaw接入SkillHub

在 OpenClaw 服务器配置私服:
临时生效

export CLAWHUB_REGISTRY=http://10.0.4.6:8080
export CLAWHUB_SKIP_SSL_VERIFY=true

永久生效

echo 'export CLAWHUB_REGISTRY=http://10.0.4.6:8080' >> ~/.bashrc
source ~/.bashrc

对于全局命名空间(@global)的公开技能(PUBLIC),无需登录即可下载。

搜索技能

[root@nmk ~]# clawhub search "weather"
weather v20260320.070944 weather (0.000)

获取技能信息

[root@nmk ~]# clawhub inspect "weather"
weather weather
Summary: Get current weather and forecasts (no API key required).
Created: 2026-03-20T07:09:44.720Z
Updated: 2026-03-20T07:09:44.758Z
Latest: 20260320.070944
License: MIT-0 (Free to use, modify, and redistribute. No attribution required.)

安装技能

[root@nmk ~]# clawhub install "weather"
✔ OK. Installed weather -> /root/.openclaw/workspace/skills/weather

查看已安装的技能

[root@nmk ~]# clawhub list
weather 20260320.070944

切换回公共 ClawHub

# 取消设置自定义 Registry,使用默认的公共注册中心
unset CLAWHUB_REGISTRY

可通过SkillHub的API来查看服务和技能是否正常

[root@nmk ~]# curl http://10.0.4.6:8080/api/v1/skills
{"items":[{"slug":"weather","displayName":"weather","summary":"Get current weather and forecasts (no API key required).","tags":{},"stats":{"downloads":1,"stars":0},"createdAt":0,"updatedAt":1773990584758,"latestVersion":{"version":"20260320.070944","createdAt":1773990584758,"changelog":"","license":null}}],"nextCursor":null}

参考文档:
https://zread.ai/iflytek/skillhub/2-quick-start
https://github.com/iflytek/skillhub/