playbooks

home / skills / openclaw / openclaw / clawhub

clawhub skill

/skills/clawhub

This skill helps you discover, install, update, and publish agent skills using the ClawHub CLI, keeping skills current.

This is most likely a fork of the vassili-clawhub-cli skill from openclaw
npx playbooks add skill openclaw/openclaw --skill clawhub

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
1.6 KB
---
name: clawhub
description: Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["clawhub"] },
        "install":
          [
            {
              "id": "node",
              "kind": "node",
              "package": "clawhub",
              "bins": ["clawhub"],
              "label": "Install ClawHub CLI (npm)",
            },
          ],
      },
  }
---

# ClawHub CLI

Install

```bash
npm i -g clawhub
```

Auth (publish)

```bash
clawhub login
clawhub whoami
```

Search

```bash
clawhub search "postgres backups"
```

Install

```bash
clawhub install my-skill
clawhub install my-skill --version 1.2.3
```

Update (hash-based match + upgrade)

```bash
clawhub update my-skill
clawhub update my-skill --version 1.2.3
clawhub update --all
clawhub update my-skill --force
clawhub update --all --no-input --force
```

List

```bash
clawhub list
```

Publish

```bash
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
```

Notes

- Default registry: https://clawhub.com (override with CLAWHUB_REGISTRY or --registry)
- Default workdir: cwd (falls back to OpenClaw workspace); install dir: ./skills (override with --workdir / --dir / CLAWHUB_WORKDIR)
- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set

Overview

This skill integrates the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. It lets you fetch new skills on the fly, keep installed skills synced to specific or latest versions, and publish skill folders using the npm-installed clawhub tool. The workflow is cross-platform and designed for local workdirs or OpenClaw workspaces.

How this skill works

The skill wraps the clawhub CLI to perform registry operations: search queries the remote index, install pulls a skill into a local skills directory, update compares local file hashes and upgrades to a matching or newer version, and publish pushes a local skill folder with metadata. Environment variables and CLI flags let you override the registry URL, workdir, and install directory. Authentication is handled by clawhub login for publishing actions.

When to use it

  • You need to quickly add a new agent skill from clawhub.com to your local assistant.
  • You want to pin an installed skill to a specific version or upgrade to the latest release.
  • You must sync multiple skills at once or force-upgrade broken installs.
  • You are ready to publish a new or updated skill from a local folder to the ClawHub registry.
  • You need to script skill management in CI using environment variables for registry and workdir.

Best practices

  • Install the CLI globally with npm i -g clawhub and confirm login via clawhub whoami before publishing.
  • Use a dedicated workdir (or set CLAWHUB_WORKDIR) and keep skills in a ./skills folder to avoid cluttering the project root.
  • When updating, prefer version pinning for critical skills; use --force only for recovery or scripted overrides.
  • Automate bulk updates with clawhub update --all --no-input --force in controlled CI pipelines.
  • Override the registry with CLAWHUB_REGISTRY or --registry when testing against private or staging registries.

Example use cases

  • Search the registry for a backup utility: clawhub search "postgres backups" and install the best match.
  • Install a specific version: clawhub install my-skill --version 1.2.3 to maintain reproducible behavior.
  • Upgrade all installed skills on a developer machine: clawhub update --all followed by testing.
  • Publish a new skill folder: clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs".
  • Recover a corrupted local skill by forcing an update: clawhub update my-skill --force.

FAQ

How do I change the registry or workdir?

Set environment variables CLAWHUB_REGISTRY or CLAWHUB_WORKDIR, or pass --registry and --workdir/--dir flags to the CLI.

What does the update command do with local changes?

Update hashes local files to find a matching remote version and will upgrade to latest unless you specify --version. Use --force to override matches.