MoltHub

MoltHub（https://molthub.com）是 Moltbot（原 Clawdbot）的官方公共技能注册表，用于发布、版本控制和发现基于文本的智能体技能。每个技能由一个 SKILL.md 文件及其可选支持文件组成，专为轻量、可审计、CLI 友好而设计。

与之配套的是 onlycrabs.ai（https://onlycrabs.ai），一个专注于 系统背景设定（SOUL.md）的注册表，允许用户以与技能相同的方式发布和共享 AI 助手的“人格”或上下文身份。

两者共同构成了 Moltbot 智能体生态的内容分发基础设施。

核心功能

MoltHub（技能注册表）

• 浏览与渲染：在线查看任意技能的 SKILL.md，支持 Markdown 渲染
• 版本管理：发布新版本时可附带变更日志与标签（如 v1.2.0、latest）
• 向量搜索：基于 OpenAI text-embedding-3-small 的嵌入向量索引，替代传统关键词匹配，提升相关性
• 社区互动：支持点赞、评论，管理员可策展并审核技能
• CLI 集成：通过 npx clawdhub install <skill> 直接安装，无缝对接本地 Moltbot

onlycrabs.ai（SOUL 注册表）

• 专注 SOUL.md：仅接受纯 SOUL.md 文件（无额外资源），确保轻量与一致性
• 双入口设计：
  • 访问 onlycrabs.ai → 默认展示“灵魂”内容
  • 访问 molthub.com/souls → 同样可浏览所有灵魂
• 用途：定义助手的角色、语气、知识边界、记忆风格等系统级上下文

💡 提示：SOUL.md 类似于 AI 的“人格配置文件”，而 SKILL.md 是其“能力插件”。

技术架构

• 前端：TanStack Start（React + Vite/Nitro）
• 后端：Convex（提供数据库、文件存储、HTTP 动作）
• 认证：Convex Auth + GitHub OAuth
• 搜索：OpenAI 嵌入向量 + Convex 原生向量搜索
• API 规范：通过 packages/schema 共享类型与路由，确保 CLI 与 Web 应用一致

隐私与遥测

MoltHub 在用户登录后执行 molthub sync 时，会收集最小化遥测数据（仅用于统计技能安装次数）。用户可通过环境变量完全禁用：

export MOLTHUB_DISABLE_TELEMETRY=1

详细策略见项目文档：docs/telemetry.md。

开发者指南

本地开发

# 前提：Bun + Convex CLI
bun install
cp .env.local.example .env.local

# 终端 A：启动 Web 应用
bun run dev

# 终端 B：启动 Convex 后端
bunx convex dev

身份验证配置

需创建 GitHub OAuth App，并运行：

bunx auth --deployment-name <name> --web-server-url http://localhost:3000

该命令将生成 JWT 密钥并写入部署环境，同时输出供 .env.local 使用的值。

关键环境变量

项目结构

src/                # TanStack Start 前端
convex/             # Convex 后端逻辑（查询/动作/HTTP 路由）
packages/schema/    # 共享 API 类型与规范
docs/spec.md        # 产品与实现规范（推荐先读）