古法编程

Appearance

本页介绍 ClawHub——OpenClaw 技能（Skills）和插件（Plugins）的公共注册中心。你可以用 openclaw skills search/install/update 直接搜索安装技能，用 openclaw plugins install clawhub:<package> 安装插件。需要发布、同步或管理注册认证时，安装独立的 clawhub CLI。网站：clawhub.ai

ClawHub ​

ClawHub 是 OpenClaw 技能（Skills）和插件（Plugins）的公共注册中心。

  • 使用原生 openclaw 命令搜索/安装/更新技能，以及从 ClawHub 安装插件。
  • 需要注册认证、发布、删除、恢复或同步工作流时，使用独立的 clawhub CLI。

网站：clawhub.ai

这里就是你的龙虾零件商城，缺什么技能，搜一搜就能装上。

原生 OpenClaw 命令流程 ​

技能操作：

bash
openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

插件操作：

bash
openclaw plugins install clawhub:<package>
openclaw plugins update --all

裸 npm 风格的插件规格也会先在 ClawHub 中查找，再尝试 npm：

bash
openclaw plugins install openclaw-codex-app-server

原生 openclaw 命令将技能安装到当前活跃 workspace，并持久化来源元数据，以便后续 update 命令继续从 ClawHub 获取更新。

插件安装时会校验 pluginApi 和 minGatewayVersion 兼容性，不兼容的包会提前失败而不是部分安装。

ClawHub 是什么 ​

  • OpenClaw 技能的公共注册中心。
  • 技能包和元数据的版本化存储。
  • 基于语义搜索、标签和使用信号的发现界面。

面向新手的快速入门 ​

如果你想为 OpenClaw Agent 添加新能力，ClawHub 是最简单的方式：

  1. 搜索你需要的功能：openclaw skills search "calendar"
  2. 安装技能：openclaw skills install <skill-slug>
  3. 启动新的 OpenClaw 会话，让 Agent 加载新技能。
  4. 如需发布或管理注册认证，还需安装独立的 clawhub CLI。

安装 ClawHub CLI ​

只有在需要注册认证相关工作流（发布/同步）时才需要安装：

bash
npm i -g clawhub
# 或
pnpm add -g clawhub

与 OpenClaw 的集成关系 ​

原生 openclaw skills install 将技能安装到当前 workspace 的 skills/ 目录下。openclaw plugins install clawhub:... 记录一次普通的托管插件安装以及 ClawHub 来源元数据，用于后续更新。

独立的 clawhub CLI 也会将技能安装到当前工作目录的 ./skills 下。如果配置了 OpenClaw workspace，clawhub 会回退到该 workspace（除非你用 --workdir 或 CLAWHUB_WORKDIR 覆盖）。OpenClaw 从 <workspace>/skills 加载 workspace 技能，下次会话时生效。若你已使用 ~/.openclaw/skills 或捆绑技能，workspace 技能优先级更高。

关于技能如何加载、共享和授权的更多细节，见 Skills。

技能系统概述 ​

技能是一个版本化的文件包，教 OpenClaw 如何执行特定任务。每次发布创建一个新版本，注册中心保留版本历史，供用户审计变更。

典型技能包含：

  • 包含主要描述和用法的 SKILL.md 文件。
  • 可选的配置文件、脚本或技能所用的支持文件。
  • 标签、摘要、安装要求等元数据。

ClawHub 利用元数据驱动发现，追踪使用信号（star 数和下载量）改善排名。

服务功能 ​

  • 公开浏览技能及其 SKILL.md 内容。
  • 语义搜索（向量搜索），不只是关键词匹配。
  • 版本控制：语义化版本、变更日志和标签（包括 latest）。
  • 按版本下载 zip 包。
  • Star 和评论，供社区反馈。
  • 审核钩子，支持审批和审计。
  • CLI 友好的 API，便于自动化和脚本集成。

安全与审核 ​

ClawHub 默认开放。任何人都可以上传技能，但 GitHub 账号需至少一周历史才能发布。

举报与审核：

  • 任何已登录用户都可以举报技能（最多 20 条活跃举报）。
  • 来自 3 个以上不同用户的举报会导致技能默认自动隐藏。
  • 管理员可查看隐藏技能、恢复、删除或封禁用户。
  • 滥用举报功能可能导致账号被封禁。

CLI 命令与参数 ​

全局选项（适用于所有命令）：

  • --workdir <dir>：工作目录（默认：当前目录；回退到 OpenClaw workspace）。
  • --dir <dir>：技能目录，相对于 workdir（默认：skills）。
  • --site <url>：网站基础 URL。
  • --registry <url>：注册中心 API 基础 URL。
  • --no-input：禁用提示（非交互模式）。

认证：

bash
clawhub login             # 浏览器流程
clawhub login --token <token>  # 直接粘贴 token
clawhub logout
clawhub whoami

搜索：

bash
clawhub search "query"
clawhub search "query" --limit 20

安装：

bash
clawhub install <slug>
clawhub install <slug> --version 1.2.0
clawhub install <slug> --force   # 已存在时覆盖

更新：

bash
clawhub update <slug>
clawhub update --all
clawhub update <slug> --version 2.0.0
clawhub update --all --force

列出已安装：

bash
clawhub list   # 读取 .clawhub/lock.json

发布技能：

bash
clawhub skill publish <path> \
  --slug my-skill \
  --name "My Skill" \
  --version 1.0.0 \
  --changelog "Initial release" \
  --tags latest

发布插件（从 GitHub 仓库）：

bash
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
clawhub package publish https://github.com/your-org/your-plugin
clawhub package publish your-org/your-plugin --dry-run   # 仅预检，不上传
clawhub package publish your-org/your-plugin --json      # 机器可读输出（CI 用）

插件的 package.json 必须包含 OpenClaw 元数据：

json
{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    }
  }
}

删除/恢复（仅所有者/管理员）：

bash
clawhub delete <slug> --yes
clawhub undelete <slug> --yes

同步（扫描本地技能 + 批量发布）：

bash
clawhub sync
clawhub sync --all          # 不提示直接上传所有内容
clawhub sync --dry-run      # 仅预览，不实际执行
clawhub sync --bump minor   # 更新时版本号 bump 类型（patch/minor/major）
clawhub sync --changelog "Bug fixes" --tags latest
clawhub sync --concurrency 8  # 注册中心检查并发数

Agent 常用工作流 ​

搜索并安装：

bash
clawhub search "postgres backups"
clawhub install postgres-backup-skill

备份技能到 ClawHub：

bash
# 单个技能
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

# 批量备份
clawhub sync --all

发布插件：

bash
clawhub package publish your-org/your-plugin --dry-run   # 先预检
clawhub package publish your-org/your-plugin              # 确认后发布

高级细节 ​

版本控制与标签 ​

  • 每次发布创建新的语义化版本 SkillVersion。
  • 标签（如 latest）指向某个版本，移动标签可以回滚。
  • 变更日志按版本附加，同步或发布更新时可为空。

本地变更 vs 注册中心版本 ​

更新时，CLI 通过内容哈希将本地技能与注册中心版本对比。若本地文件与任何已发布版本不匹配，CLI 会在覆盖前询问（非交互式运行需要 --force）。

同步扫描与回退目录 ​

clawhub sync 先扫描当前 workdir。若未找到技能，回退到旧版位置（~/openclaw/skills、~/.openclaw/skills）。

存储与锁定文件 ​

  • 已安装技能记录在 workdir 下的 .clawhub/lock.json 中。
  • Auth token 存储在 ClawHub CLI 配置文件中（通过 CLAWHUB_CONFIG_PATH 覆盖）。

环境变量 ​

  • CLAWHUB_SITE：覆盖网站 URL。
  • CLAWHUB_REGISTRY：覆盖注册中心 API URL。
  • CLAWHUB_CONFIG_PATH：覆盖 CLI 存储 token/配置的位置。
  • CLAWHUB_WORKDIR：覆盖默认 workdir。
  • CLAWHUB_DISABLE_TELEMETRY=1：禁用 sync 时的遥测（安装计数统计）。

常见问题 ​

Q: openclaw skills install 和 clawhub install 有什么区别？

A: openclaw skills install 是原生命令，直接安装到当前 OpenClaw workspace 并记录 ClawHub 来源元数据，后续可用 openclaw skills update --all 更新。clawhub install 是独立 CLI，安装到当前工作目录的 ./skills，功能更全（支持指定版本、列出已安装等），但需要额外安装 clawhub 包。日常使用推荐原生命令。

Q: 我发布的技能被举报了会怎样？

A: 收到 3 个以上不同用户的举报后，技能会被自动隐藏（不会立即删除），管理员可以查看并决定后续处理。你可以在 OpenClaw Discord 联系维护者说明情况。举报者如果滥用举报功能（如恶意举报）也会被封禁。

Q: 如何为发布的插件指定兼容的 OpenClaw 版本？

A: 在 package.json 的 openclaw.compat 字段中设置 pluginApi 和 minGatewayVersion，使用 semver 范围（如 >=2026.3.24-beta.2）。OpenClaw 在安装时会校验兼容性，版本不符合的插件会提前报错而不是部分安装。

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 古法编程 | 蜀ICP备2021007188号 | 关于本站 | 隐私政策