clawhub README

The project's README from github.com/openclaw/clawhub. As one markdown file: README.md.

ClawHub

ClawHub banner

ClawHub

CI status Discord MIT License

ClawHub is the public skill registry for OpenClaw: publish, version, and search text-based agent skills (a SKILL.md plus supporting files). It's designed for fast browsing + a CLI-friendly API, with moderation hooks and vector search. It also exposes a native OpenClaw package catalog for code plugins, bundle plugins, and experimental whole-agent Claw packages.

ClawHub · Vision · Docs · Contributing · Discord

What you can do with it

How it works (high level)

CLI

Common CLI flows:

Docs: docs/quickstart.md, docs/cli.md.

Removal permissions

Telemetry

ClawHub tracks minimal install telemetry (to compute install counts) when you run clawhub install while logged in. Disable via:

export CLAWHUB_DISABLE_TELEMETRY=1

Details: docs/telemetry.md.

Repo layout

Local dev

Prereqs: Bun (Convex runs via bunx, no global install needed). The detached worktree path also requires Worktrunk (wt).

bun install
cp .env.local.example .env.local
# edit .env.local — see CONTRIBUTING.md for local Convex values

# terminal A: local Convex backend
bunx convex dev

# terminal B: web app (port 3000)
bun run dev

# detached/Codex worktree preview
bun run setup:worktree
bun run dev:worktree
wt --yes url

# seed local QA fixtures and the public corpus
bun run seed:dev

bun run seed:dev waits for the local Convex deployment, runs the dev fixture seed, and refreshes global stats. The fixtures are owned by @local and are safe to rerun after fixture or schema changes. For reset/manual commands and full setup instructions (env vars, GitHub OAuth, JWT keys, database seeding), see CONTRIBUTING.md.

Environment

Nix plugins (nixmode skills)

ClawHub can store a nix-clawdbot plugin pointer in SKILL frontmatter so the registry knows which Nix package bundle to install. A nix plugin is different from a regular skill pack: it bundles the skill pack, the CLI binary, and its config flags/requirements together.

Add this to SKILL.md:

---
name: peekaboo
description: Capture and automate macOS UI with the Peekaboo CLI.
metadata:
  {
    "clawdbot":
      {
        "nix":
          {
            "plugin": "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo",
            "systems": ["aarch64-darwin"],
          },
      },
  }
---

Install via nix-clawdbot:

programs.clawdbot.plugins = [
  { source = "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo"; }
];

You can also declare config requirements + an example snippet:

---
name: padel
description: Check padel court availability and manage bookings via Playtomic.
metadata:
  {
    "clawdbot":
      {
        "config":
          {
            "requiredEnv": ["PADEL_AUTH_FILE"],
            "stateDirs": [".config/padel"],
            "example": "config = { env = { PADEL_AUTH_FILE = \\\"/run/agenix/padel-auth\\\"; }; };",
          },
      },
  }
---

To show CLI help (recommended for nix plugins), include the cli --help output:

---
name: padel
description: Check padel court availability and manage bookings via Playtomic.
metadata: { "clawdbot": { "cliHelp": "padel --help\\nUsage: padel [command]\\n" } }
---

metadata.clawdbot is preferred, but metadata.clawdis and metadata.openclaw are accepted as aliases.

Skill metadata

Skills declare their runtime requirements (env vars, binaries, install specs) in the SKILL.md frontmatter. ClawHub's security analysis checks these declarations against actual skill behavior; medium review findings stay visible, and the suspicious filter is reserved for high-impact or malicious concerns.

Full reference: docs/skill-format.md

Quick example:

---
name: my-skill
description: Does a thing with an API.
metadata:
  openclaw:
    requires:
      env:
        - MY_API_KEY
      bins:
        - curl
    primaryEnv: MY_API_KEY
---

Scripts

bun run dev
bun run build
bun run test
bun run coverage
bun run lint

clawhub (openclaw/clawhub)

Searching Database…

9.5K ·GitHub
Clawhub
Что это такое?ClawHub — это публичный реестр навыков для OpenClaw: место, где можно публиковать, версионировать и искать текстовые навыки для агентов (файл SKILL.md плюс вспомогательные файлы), а также каталог кода OpenClaw и bundle-плагинов.
Это сайт, который я смотрю в браузере, или утилита для командной строки?И то и другое: веб-приложение для просмотра и отображения навыков, удобный для CLI API и сам clawhub CLI — чтобы искать, устанавливать и публиковать навыки прямо из терминала.
Как мне забрать оттуда навык?Войдите через clawhub login (на машинах без графического интерфейса — clawhub login --device), найдите навыки через clawhub search или clawhub explore, затем выполните clawhub install @openclaw/demo. Команды clawhub list и clawhub update --all управляют установленными копиями.
Мне нужен аккаунт GitHub, как и для npm?Да — вход идёт через GitHub OAuth и работает и в веб-приложении, и в CLI. Чтобы работать над самим ClawHub, нужен Bun как предварительное требование, а для собственного поиска на основе эмбеддингов понадобится API-ключ OpenAI.
Могу ли я удалить опубликованный навык, если передумаю?clawhub uninstall удаляет только копию на вашем компьютере. Загруженные в реестр навыки удаляются мягко и восстанавливаются через clawhub delete / clawhub undelete; безвозвратное удаление доступно только администраторам.
Установка навыка куда-то о мне сообщает?Только минимальная телеметрия установки: выполненный под вашей учётной записью clawhub install записывается для подсчёта числа установок, и её можно отключить — подробности в docs/telemetry.md.
Что я могу делать с навыками, которые мне уже принадлежат?Можно переименовать свой навык, не сломав старые ссылки и установки — старый slug остаётся как алиас для перенаправления — и объединить дубликаты в один канонический slug, который тоже перенаправляет.
Как работает поиск — просто по ключевым словам?Нет. ClawHub индексирует навыки с помощью эмбеддингов OpenAI (text-embedding-3-small) и векторного поиска Convex, поэтому вы ищете по смыслу, а не по хрупкому совпадению ключевых слов.
Опубликованные навыки проверяют на безопасность?Навыки декларируют требования к окружению (переменные среды, бинарники, спецификации установки) во frontmatter файла SKILL.md, а анализ безопасности ClawHub сверяет эти декларации с реальным поведением. Находки среднего уровня остаются видимыми, а пометка «подозрительный» reserved для серьёзных или злонамеренных проблем.
Можно публиковать не только навыки, но и плагины?Да — нативные кодовые плагины и bundle-плагины публикуются через API /packages и CLI-процессы. Манифесты кодовых плагинов должны декларировать openclaw.compat.pluginApi и openclaw.build.openclawVersion, а экспериментальные Claw-пакеты целых агентов тоже можно размещать.
What are similar projects?dsh-top100, hotdata-cli, qmd, xerj, ruflo, DSH-Plugins-Marketplace, gstack, awesome-deepseek-harness-plugins
Which topics is it in?directory, registry, plugins, vector-search, bun, semantic-search, embeddings, openclaw, search, oauth, skill, skills
Creator
openclaw
Size
349.2 MB
Stars
9.5K
Updated
CommitOct 18Releasev0.23.3Aug 04
Age
9mo
Commits · 90 Days