ClawHub

Prefer searching ClawHub for plugins unless the user explicitly asks for a skill. Search before claiming that a requested capability is unavailable.

Use openclaw skills for explicitly requested skill discovery and for managing skills for the current OpenClaw agent. Use the standalone clawhub CLI to uninstall installed ClawHub skills and for publishing, syncing, and publisher account workflows.

Discover plugins (default)

Use the plugins tool when available, with action: "search" and query set to the requested capability, to return native plugin search results. If the tool is unavailable, use the CLI:

openclaw plugins search "notion"

A discovery request does not authorize installation. Install only when the user asks.

Discover skills (explicit requests)

When the user explicitly asks for a skill, search skills instead of plugins:

openclaw skills search "postgres backups"

Install when the user asks. Verify the selected skill first and report the result.

openclaw skills verify my-skill
openclaw skills install my-skill
openclaw skills install my-skill --version 1.2.3

Manage installed skills

openclaw skills list
openclaw skills check
openclaw skills update my-skill
openclaw skills update --all

Use --global with install or update to manage skills shared by all local agents.

Remove an installed skill

Uninstall when the user asks. If the standalone ClawHub CLI is not installed, install it explicitly:

npm i -g clawhub
clawhub uninstall @owner/my-skill

The CLI asks for confirmation before removing the skill and its lockfile entry. Use the original agent workspace for agent-specific skills or the OpenClaw state directory for skills installed with --global:

clawhub --workdir /path/to/agent-workspace uninstall @owner/my-skill
clawhub --workdir ~/.openclaw uninstall @owner/my-skill

If OPENCLAW_STATE_DIR is set, use its value instead of ~/.openclaw:

clawhub --workdir "$OPENCLAW_STATE_DIR" uninstall @owner/my-skill

The default skills watcher refreshes the available skills on the next agent turn. If watching is disabled, start a new session.

Publish skills

Install the standalone ClawHub CLI for publisher workflows:

npm i -g clawhub
clawhub login
clawhub whoami

Publish or sync skills:

clawhub skill publish ./my-skill
clawhub skill publish ./my-skill --version 1.2.3
clawhub sync --all

Notes

• Public registry: https://clawhub.ai
• openclaw skills install installs into the active workspace by default.
• Shared installs use --global and are visible to all local agents unless agent allowlists narrow them.