OpenClaw Hub
OpenClaw Hub 指南：公共技能注册表 + CLI 工作流程
OpenClaw Hub 是 ''OpenClaw 的公共技能注册表''。这是一项免费服务：所有技能都是公开、开放且对所有人可见，用于共享和重用。技能只是一个包含 ''SKILL.md'' 文件（加上支持文本文件）的文件夹。您可以在 Web 应用中浏览技能，或使用 CLI 搜索、安装、更新和发布技能。
网站：''openclawhub.com''
适用对象（适合初学者）
如果您想为 OpenClaw 代理添加新功能，OpenClaw Hub 是查找和安装技能的最简单方法。您不需要了解后端如何工作。您可以：
- 使用自然语言搜索技能。
- 将技能安装到您的工作区。
- 稍后使用一个命令更新技能。
- 通过发布技能来备份您自己的技能。
快速入门（非技术性）
1. 安装 CLI（见下一节）。
2. 搜索您需要的内容：
- ''openclaw-hub search "calendar"''
3. 安装技能：
- ''openclaw-hub install <skill-slug>''
4. 启动新的 OpenClaw 会话以获取新技能。
安装 CLI
选择一个：
npm i -g openclaw-hub
pnpm add -g openclaw-hub
如何融入 OpenClaw
默认情况下，CLI 将技能安装到当前工作目录下的 ''./skills''。如果配置了 OpenClaw 工作区，''openclaw-hub'' 会回退到该工作区，除非您覆盖 ''--workdir''（或 ''OPENCLAW_HUB_WORKDIR''）。OpenClaw 从 ''<workspace>/skills'' 加载工作区技能，并将在''下一个''会话中获取它们。如果您已经使用 ''~/.openclaw/skills'' 或捆绑技能，工作区技能优先。
有关如何加载、共享和限制技能的更多详细信息，请参阅
''技能''。
服务提供的功能
- ''公开浏览''技能及其 ''SKILL.md'' 内容。
- 搜索由嵌入（向量搜索）驱动，不仅仅是关键词。
- ''版本控制''带有语义版本、变更日志和标签（包括 ''latest''）。
- 下载每个版本的 zip 文件。
- 星标和评论用于社区反馈。
- 审核钩子用于审批和审计。
- CLI 友好的 API用于自动化和脚本编写。
CLI 命令和参数
全局选项（适用于所有命令）：
- ''--workdir <dir>''：工作目录（默认：当前目录；回退到 OpenClaw 工作区）。
- ''--dir <dir>''：技能目录，相对于 workdir（默认：''skills''）。
- ''--site <url>''：站点基础 URL（浏览器登录）。
- ''--registry <url>''：注册表 API 基础 URL。
- ''--no-input''：禁用提示（非交互式）。
- ''-V, --cli-version''：打印 CLI 版本。
认证：
- ''openclaw-hub login''（浏览器流程）或 ''openclaw-hub login --token <token>''
- ''openclaw-hub logout''
- ''openclaw-hub whoami''
选项：
- ''--token <token>''：粘贴 API 令牌。
- ''--label <label>''：为浏览器登录令牌存储的标签（默认：''CLI token''）。
- ''--no-browser''：不打开浏览器（需要 ''--token''）。
搜索：
- ''openclaw-hub search "query"''
- ''--limit <n>''：最大结果数。
安装：
- ''openclaw-hub install <slug>''
- ''--version <version>''：安装特定版本。
- ''--force''：如果文件夹已存在则覆盖。
更新：
- ''openclaw-hub update <slug>''
- ''openclaw-hub update --all''
- ''--version <version>''：更新到特定版本（仅限单个 slug）。
- ''--force''：当本地文件与任何已发布版本不匹配时覆盖。
列表：
- ''openclaw-hub list''（读取 ''.openclaw-hub/lock.json''）
发布：
- ''openclaw-hub publish <path>''
- ''--slug <slug>''：技能 slug。
- ''--name <name>''：显示名称。
- ''--version <version>''：语义版本。
- ''--changelog <text>''：变更日志文本（可以为空）。
- ''--tags <tags>''：逗号分隔的标签（默认：''latest''）。
删除/取消删除（仅限所有者/管理员）：
- ''openclaw-hub delete <slug> --yes''
- ''openclaw-hub undelete <slug> --yes''
同步（扫描本地技能 + 发布新/更新）：
- ''openclaw-hub sync''
- ''--root <dir...>''：额外的扫描根目录。
- ''--all''：无提示上传所有内容。
- ''--dry-run''：显示将要上传的内容。
- ''--bump <type>''：''patch|minor|major'' 用于更新（默认：''patch''）。
- ''--changelog <text>''：非交互式更新的变更日志。
- ''--tags <tags>''：逗号分隔的标签（默认：''latest''）。
- ''--concurrency <n>''：注册表检查（默认：4）。
代理的常见工作流程
#
搜索技能
openclaw-hub search "postgres backups"
#
下载新技能
openclaw-hub install my-skill-pack
#
更新已安装的技能
openclaw-hub update --all
#
备份您的技能（发布或同步）
对于单个技能文件夹：
openclaw-hub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
要一次扫描并备份多个技能：
openclaw-hub sync --all
高级详细信息（技术性）
#
版本控制和标签
- 每次发布都会创建一个新的 ''语义版本'' ''SkillVersion''。
- 标签（如 ''latest''）指向一个版本；移动标签可以让您回滚。
- 变更日志附加到每个版本，同步或发布更新时可以为空。
#
本地更改与注册表版本
更新使用内容哈希将本地技能内容与注册表版本进行比较。如果本地文件与任何已发布版本不匹配，CLI 会在覆盖前询问（或在非交互式运行中需要 ''--force''）。
#
同步扫描和回退根目录
''openclaw-hub sync'' 首先扫描您当前的 workdir。如果未找到技能，它会回退到已知位置（例如 ''~/.openclaw/skills''）。
#
存储和锁定文件
- 已安装的技能记录在您 workdir 下的 ''.openclaw-hub/lock.json'' 中。
- 认证令牌存储在 OpenClaw Hub CLI 配置文件中（通过 ''OPENCLAW_HUB_CONFIG_PATH'' 覆盖）。
#
遥测（安装计数）
当您在登录状态下运行 ''openclaw-hub sync'' 时，CLI 会发送最小快照来计算安装计数。您可以完全禁用此功能：
export OPENCLAW_HUB_DISABLE_TELEMETRY=1
环境变量
- ''OPENCLAW_HUB_SITE''：覆盖站点 URL。
- ''OPENCLAW_HUB_REGISTRY''：覆盖注册表 API URL。