README

!ClawHub banner

ClawHub


  
  
  


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 Template packages.


  ClawHub ·
  Vision ·
  Docs ·
  Contributing ·
  Support ·
  Discord


For questions and help, visit official OpenClaw support.

 What you can do with it

- Browse skills + render their SKILL.md.
- Publish new skill versions with changelogs + tags (including latest).
- Rename an owned skill without breaking old links or installs.
- Merge duplicate owned skills into one canonical slug.
- Search via embeddings (vector index) instead of brittle keywords.
- Star + comment; admins/mods can curate and approve skills.
- Pin local skill installs so updates and force reinstalls cannot overwrite frozen copies.
- Browse OpenClaw packages with family/trust/capability metadata.
- Publish native code plugins and bundle plugins through /packages APIs and CLI flows.
- Host, discover, and resolve exact artifacts for experimental whole-agent Template packages.

 How it works (high level)

- Web app: TanStack Start (React, Vite/Nitro).
- Backend: Convex (DB + file storage + HTTP actions) + Convex Auth (GitHub OAuth).
- Search: OpenAI embeddings (text-embedding-3-small) + Convex vector search.
- API schema + routes: packages/schema (clawhub-schema).

 CLI

Common CLI flows:

- Auth: clawhub login, clawhub whoami
- Remote/headless auth: clawhub login --device
- Discover: clawhub search ..., clawhub explore
- Browse unified catalog (skills + plugins): clawhub package explore, clawhub package inspect 
- Manage local installs: clawhub install @openclaw/demo, clawhub pin , clawhub unpin , clawhub uninstall , clawhub list, clawhub update --all
- Inspect without installing: clawhub inspect @openclaw/demo
- Publish skills: clawhub skill publish 
- Publish plugins: clawhub package publish 
- Code-plugin manifests must include openclaw.compat.pluginApi and openclaw.build.openclawVersion; see docs/cli.md for a minimal example.
- Canonicalize owned skills: clawhub skill rename  , clawhub skill merge  

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

 Removal permissions

- clawhub uninstall  only removes a local install on your machine.
- Uploaded registry skills use soft-delete/restore (clawhub delete  / clawhub undelete  or API equivalents).
- Soft-delete/restore is allowed for the skill or package owner, publisher owner/admin, moderators, and admins.
- Packages use clawhub package delete  / clawhub package undelete .
- Hard delete is admin-only (management tools / ban flows).
- Owner rename keeps the old slug as a redirect alias.
- Owner merge hides the source listing and redirects the old slug to the canonical target.

 Telemetry

ClawHub tracks minimal install telemetry (to compu