diff --git a/docs/clawdhub.md b/docs/clawdhub.md deleted file mode 100644 index 1319304a410..00000000000 --- a/docs/clawdhub.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -summary: "ClawHub skills registry overview and moderation" -read_when: - - You want to understand how ClawHub works - - You are publishing or moderating skills - - You need the ClawHub security model -title: "ClawHub" ---- - -# ClawHub - -ClawHub is the OpenClaw skills registry. It is the shared catalog where skills -are published, discovered, versioned, and moderated. - -## What ClawHub is - -- A public registry for OpenClaw skills. -- A versioned store of skill bundles and metadata. -- A discovery surface for search, tags, and usage signals. - -## How it works - -1. A user publishes a skill bundle (files + metadata). -2. ClawHub stores the bundle, parses metadata, and assigns a version. -3. The registry indexes the skill for search and discovery. -4. Users browse, download, and install skills in OpenClaw. - -## What you can do - -- Publish new skills and new versions of existing skills. -- Discover skills by name, tags, or search. -- Download skill bundles and inspect their files. -- Report skills that are abusive or unsafe. -- If you are a moderator, hide, unhide, delete, or ban. - -## Skill system overview - -A skill is a versioned bundle of files that teaches OpenClaw how to perform a -specific task. Each publish creates a new version, and the registry keeps a -history of versions so users can audit changes. - -A typical skill includes: - -- A `SKILL.md` file with the primary description and usage. -- Optional configs, scripts, or supporting files used by the skill. -- Metadata such as tags, summary, and install requirements. - -ClawHub uses metadata to power discovery and safely expose skill capabilities. -The registry also tracks usage signals (such as stars and downloads) to improve -ranking and visibility. - -## Security and moderation - -ClawHub is open by default. Anyone can upload skills, but a GitHub account must -be at least one week old to publish. This helps slow down abuse without blocking -legitimate contributors. - -Reporting and moderation: - -- Any signed in user can report a skill. -- Report reasons are required and recorded. -- Each user can have up to 20 active reports at a time. -- Skills with more than 3 unique reports are auto hidden by default. -- Moderators can view hidden skills, unhide them, delete them, or ban users. -- Abusing the report feature can result in account bans. - -Want to help moderate? Ask in the OpenClaw Discord and contact a moderator or -maintainer. diff --git a/docs/tools/clawhub.md b/docs/tools/clawhub.md index 0143db5d801..1b8867cad30 100644 --- a/docs/tools/clawhub.md +++ b/docs/tools/clawhub.md @@ -11,7 +11,28 @@ title: "ClawHub" ClawHub is the **public skill registry for OpenClaw**. It is a free service: all skills are public, open, and visible to everyone for sharing and reuse. A skill is just a folder with a `SKILL.md` file (plus supporting text files). You can browse skills in the web app or use the CLI to search, install, update, and publish skills. -Site: [clawhub.com](https://clawhub.com) +Site: [clawhub.ai](https://clawhub.ai) + +## What ClawHub is + +- A public registry for OpenClaw skills. +- A versioned store of skill bundles and metadata. +- A discovery surface for search, tags, and usage signals. + +## How it works + +1. A user publishes a skill bundle (files + metadata). +2. ClawHub stores the bundle, parses metadata, and assigns a version. +3. The registry indexes the skill for search and discovery. +4. Users browse, download, and install skills in OpenClaw. + +## What you can do + +- Publish new skills and new versions of existing skills. +- Discover skills by name, tags, or search. +- Download skill bundles and inspect their files. +- Report skills that are abusive or unsafe. +- If you are a moderator, hide, unhide, delete, or ban. ## Who this is for (beginner-friendly) @@ -50,6 +71,22 @@ By default, the CLI installs skills into `./skills` under your current working d For more detail on how skills are loaded, shared, and gated, see [Skills](/tools/skills). +## Skill system overview + +A skill is a versioned bundle of files that teaches OpenClaw how to perform a +specific task. Each publish creates a new version, and the registry keeps a +history of versions so users can audit changes. + +A typical skill includes: + +- A `SKILL.md` file with the primary description and usage. +- Optional configs, scripts, or supporting files used by the skill. +- Metadata such as tags, summary, and install requirements. + +ClawHub uses metadata to power discovery and safely expose skill capabilities. +The registry also tracks usage signals (such as stars and downloads) to improve +ranking and visibility. + ## What the service provides (features) - **Public browsing** of skills and their `SKILL.md` content. @@ -60,6 +97,24 @@ For more detail on how skills are loaded, shared, and gated, see - **Moderation** hooks for approvals and audits. - **CLI-friendly API** for automation and scripting. +## Security and moderation + +ClawHub is open by default. Anyone can upload skills, but a GitHub account must +be at least one week old to publish. This helps slow down abuse without blocking +legitimate contributors. + +Reporting and moderation: + +- Any signed in user can report a skill. +- Report reasons are required and recorded. +- Each user can have up to 20 active reports at a time. +- Skills with more than 3 unique reports are auto hidden by default. +- Moderators can view hidden skills, unhide them, delete them, or ban users. +- Abusing the report feature can result in account bans. + +Interested in becoming a moderator? Ask in the OpenClaw Discord and contact a +moderator or maintainer. + ## CLI commands and parameters Global options (apply to all commands):