SkillHub

在 AI 智能体（Agent）爆发式增长的今天，企业和团队面临着新的挑战：如何安全、高效地在组织内部共享、管理和复用高质量的智能体技能（Skills）？ 公共注册中心无法满足数据主权和合规要求，而分散的文件共享又难以治理。

SkillHub 是一个专为自托管设计的企业级开源平台，让组织能够在防火墙后构建属于自己的私有技能市场。它提供了与公共注册中心一致的精致体验，同时确保所有专有技能、数据和治理流程完全掌握在自己手中。

核心特性：为 enterprise 而生

1. 完全自托管与数据主权

• 私有部署：一键部署在您自己的基础设施（Docker/K8s）上，数据不出内网。
• 防火墙友好：专为本地环境构建，无需连接外部服务即可运行完整的发布、发现和安装流程。
• 灵活存储：开发环境使用本地文件系统，生产环境无缝切换至 S3、MinIO 等对象存储。

2. 全生命周期管理

• 语义化版本控制：支持 beta, stable 标签及自动 latest 跟踪，确保团队始终使用可靠版本。
• 团队命名空间：按部门或项目组隔离技能（如 finance/tax-calc, hr/onboarding），每个空间拥有独立的成员角色（Owner/Admin/Member）和发布策略。
• 审核与治理：内置工作流，团队管理员可审核命名空间内的技能，平台管理员控制向全局范围的推广。所有操作均记录审计日志，满足合规需求。

3. 强大的发现与社交

• 全文搜索：支持按名称、描述、标签、下载量、评分等多维度筛选。
• 可见性控制：基于角色的访问控制（RBAC），确保用户只能看到有权访问的技能。
• 社区互动：支持收藏、评分、评论，围绕最佳实践构建内部开发者社区。

4. CLI 优先与广泛集成

• 原生 CLI 支持：提供 REST API 及兼容 ClawHub 风格的命令行工具，方便 CI/CD 集成和脚本化操作。
• 生态兼容：完美适配 OpenClaw, AstronClaw, Loomy, astron-agent 等主流智能体框架。
  • 示例：npx clawhub install finance/tax-calc 即可从私有库安装技能。
• 多身份合并：支持将多个 OAuth 身份和 API Token 整合到单一账户，简化管理。

快速开始：5 分钟搭建私有技能市场

SkillHub 提供了极简的一键启动脚本，支持国内阿里云镜像加速。

1. 本地开发/测试模式

# 清理旧环境并启动最新稳定版
rm -rf /tmp/skillhub-runtime
curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up

# 访问地址
# Web UI: http://localhost:3000
# API: http://localhost:8080
# 默认账号: admin / ChangeMe!2026

2. 生产环境部署（推荐）

配置公网访问地址，确保 CLI 和 Agent 能正确连接。

# 使用阿里云镜像（国内推荐）
curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up \
  --aliyun \
  --public-url https://skillhub.your-company.com \
  --home /opt/skillhub-data

⚠️ 安全提示：生产环境务必修改默认密码！validate-release-config.sh 会自动检测并拒绝默认凭证。

3. Kubernetes 部署

kubectl apply -f deploy/k8s/
# Helm 支持即将推出

生态集成：让技能流动起来

SkillHub 不仅仅是一个仓库，它是智能体生态的枢纽。

配置示例 (OpenClaw):

# 指向私有 SkillHub
export CLAWHUB_REGISTRY=https://skillhub.your-company.com

# 登录并安装
clawhub login --token YOUR_API_TOKEN
npx clawhub install hr/onboarding-bot

技术架构

SkillHub 采用现代化的分层架构，确保高性能与可维护性：

• 前端：React + i18next (多语言支持)
• 后端：Spring Boot (Java/Kotlin)
• 数据库：PostgreSQL (业务数据) + Redis (缓存/会话)
• 存储：可插拔设计 (Local FS / S3 / MinIO)
• 设计模式：
  • DDD (领域驱动设计)：清晰的业务边界。
  • CQRS：读写分离优化性能。
  • 事件溯源：完整的审计追踪。

为什么企业需要 SkillHub？

1. 保护知识产权：核心业务逻辑封装在技能包中，绝不泄露给第三方云服务商。
2. 统一治理标准：通过审核流程和版本控制，避免“野生技能”带来的安全和稳定性风险。
3. 加速创新复用：打破部门墙，让 A 团队开发的优秀技能能被 B 团队一键发现和使用，避免重复造轮子。
4. 合规审计：所有技能的发布、更新、下载均有据可查，满足金融、医疗等行业的严格监管要求。