ClawHub

ClawHub is OpenClaw's public Skills registry. It is a free service: all Skills are public, open, and anyone can view, share, and reuse them. A Skill is a folder containing an SKILL.md file (and auxiliary text files). You can browse Skills in the web application, or use the CLI to search, install, update, and publish Skills. Website: clawhub.com

Position in OpenClaw

By default, the CLI installs Skills to ./skills under the current working directory. If an OpenClaw workspace has been configured, clawhub falls back to that workspace unless overridden by --workdir (or CLAWHUB_WORKDIR). OpenClaw loads workspace Skills from <workspace>/skills, which take effect in the next session. If you are already using ~/.openclaw/skills or built-in Skills, workspace Skills have higher priority. For more details on Skills loading, sharing, and permission control, please refer to Skills.

Target Audience (Beginner Friendly)

If you want to add new features to your OpenClaw agent, ClawHub is the simplest way to find and install Skills. You don't need to understand how the backend works. You can:

• Search Skills using natural language.
• Install Skills to your workspace.
• Update Skills with one command later.
• Back up your own Skills by publishing them.

Install CLI

Original ClawHub CLI (International Users)

Choose one:

npm i -g clawhub
pnpm add -g clawhub

Log In to ClawHub Account

Why Log In

Although ClawHub allows non-logged-in users to search and install Skills, logging in has important benefits:

• ✅ Avoid Rate Limiting: Non-logged-in users may encounter download rate limits
• ✅ Access Full Features: Some advanced features require login
• ✅ Publish Skills: Only logged-in users can publish their own Skills
• ✅ Favorites and Comments: Can favorite Skills and leave comments
• ✅ Usage Statistics: View your usage situation

Login Steps

Method 1: Log in via GitHub (Recommended)

This is the simplest and most secure login method.

1.1 Visit ClawHub Official Website

Open in browser: https://clawhub.com

1.2 Click Login

Click the "Login" button in the upper right corner of the page:

1.3 Select GitHub Login

On the login page, click "Sign in with GitHub".

1.4 Authorize Access

After successful authorization, you will be automatically redirected back to ClawHub, showing the logged-in status.

Method 2: Log in using Token

If you cannot log in via GitHub, you can use the Token method.

2.1 Log in to Account

First, follow the steps in Method 1 to log in to ClawHub official website via GitHub.

2.2 Go to Settings Page

After logging in, click your avatar in the upper right corner and select "Settings":

2.3 Create API Token

On the settings page, find the "API Tokens" section and click "Create token":

2.4 Copy Token

The system will generate a new API Token. Click the copy button to copy this Token:

⚠️ Important Note:

• Token is only displayed once. Please be sure to copy and save it properly
• Do not share the Token with others
• You can delete the Token anytime in the settings page

2.5 Log in in Terminal

Open the terminal and run the following command (replace your Token with the Token you just copied):

xxxxxxxxxx
clawhub login --token your Token

Note: There is a space after --token, then paste your Token.

Common Issues

Issue 1: Login Prompt Token Invalid

Error Message:

xxxxxxxxxx
Error: Invalid token

Possible Causes:

• Token copy incomplete
• Token has expired or been deleted
• Extra spaces or characters during input

Solutions:

1. Recreate and copy Token
2. Ensure no extra spaces when copying
3. Check if Token is complete

Issue 2: GitHub Login Failed

Possible Causes:

• Network connection issue
• GitHub account email not verified
• Browser blocked redirect

Solutions:

1. Check network connection
2. Confirm GitHub account has verified email
3. Try other browsers or incognito mode

Issue 3: Still Rate Limited After Login

Possible Causes:

• Login not effective
• Using wrong CLI (clawhub vs skillhub)

Solutions:

1. Run clawhub whoami to confirm login status
2. Confirm using correct CLI command
3. Log in again

Quick Start

Using Original ClawHub

1. Install CLI (see previous section).

2. Search for what you need (domestic users may need VPN/proxy):

   xxxxxxxxxx
   clawhub search "find"
   

   

3. Install a Skill:

   Syntax: clawhub install <skill-slug>

   xxxxxxxxxx
   clawhub install find
   

4. Start a new OpenClaw session to load new Skills.

Common Agent Workflows

Search Skills

xxxxxxxxxx
clawhub search "postgres backups"

Or use SkillHub:

xxxxxxxxxx
skillhub search "postgres backups"

Download New Skills

xxxxxxxxxx
clawhub install my-skill-pack

Or use SkillHub:

xxxxxxxxxx
skillhub install my-skill-pack

Update Installed Skills

xxxxxxxxxx
clawhub update --all

Or use SkillHub:

xxxxxxxxxx
skillhub update --all

Back up Your Skills (Publish or Sync)

For a single Skills folder:

xxxxxxxxxx
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

Scan and back up multiple Skills at once:

xxxxxxxxxx
clawhub sync --all

CLI Commands and Parameters

Global options (apply to all commands):

• --workdir <dir>: Working directory (default: current directory; falls back to OpenClaw workspace).
• --dir <dir>: Skills directory, relative to the working directory (default: skills).
• --site <url>: Website base URL (browser login).
• --registry <url>: Registry API base URL.
• --no-input: Disable prompts (non-interactive mode).
• -V, --cli-version: Print CLI version.

Authentication:

• clawhub login (browser flow) or clawhub login --token <token>
• clawhub logout
• clawhub whoami

Options:

• --token <token>: Paste API token.
• --label <label>: Label for browser login token storage (default: CLI token).
• --no-browser: Do not open browser (requires --token).

Search:

• clawhub search "query"
• --limit <n>: Maximum number of results.

Install:

• clawhub install <slug>
• --version <version>: Install specified version.
• --force: Overwrite if folder already exists.

Update:

• clawhub update <slug>
• clawhub update --all
• --version <version>: Update to specified version (single slug only).
• --force: Force overwrite when local files don't match any published version.

List:

• clawhub list (reads .clawhub/lock.json)

Publish:

• clawhub publish <path>
• --slug <slug>: Skills identifier.
• --name <name>: Display name.
• --version <version>: Semantic version number.
• --changelog <text>: Changelog text (can be empty).
• --tags <tags>: Comma-separated tags (default: latest).

Delete/Restore (owner/admin only):

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

Sync (scan local Skills + publish new/updated Skills):

• clawhub sync
• --root <dir...>: Additional scan root directories.
• --all: Upload all without prompts.
• --dry-run: Show what will be uploaded.
• --bump <type>: Version number increment type for updates patch|minor|major (default: patch).
• --changelog <text>: Changelog for non-interactive updates.
• --tags <tags>: Comma-separated tags (default: latest).
• --concurrency <n>: Registry check concurrency (default: 4).

Environment Variables

• CLAWHUB_SITE: Override website URL.
• CLAWHUB_REGISTRY: Override registry API URL.
• CLAWHUB_CONFIG_PATH: Override where CLI stores tokens/config.
• CLAWHUB_WORKDIR: Override default working directory.
• CLAWHUB_DISABLE_TELEMETRY=1: Disable telemetry for sync.

For more content about ClawHub, please refer to: ClawHub - OpenClaw