search [query...] | Optional query; omit it to browse the default ClawHub search feed. |
search --limit <n> | Caps returned results. |
install git:owner/repo[@ref] | Installs a Git skill. Branch refs may contain slashes, such as git:owner/repo@feature/foo. |
install ./path/to/skill | Installs a local directory whose root contains SKILL.md. |
install --as <slug> | Overrides the inferred slug for Git and local directory installs. |
install --version <version> | Applies only to ClawHub skill refs. |
install --force | Overwrites an existing workspace skill folder for the same slug. |
install/update --force-install | Installs a pending GitHub-backed ClawHub skill before ClawHub’s scan completes. |
--global | Targets the shared managed skills directory; cannot combine with --agent <id>. |
--agent <id> | Targets one configured agent workspace; overrides current working directory inference. |
update @owner/<slug> | Updates a single tracked skill. Add --global to target the shared managed skills directory instead of the workspace. |
update --all | Updates tracked ClawHub installs in the selected workspace, or the shared managed skills directory with --global. |
verify @owner/<slug> | Prints ClawHub’s clawhub.skill.verify.v1 JSON envelope by default. There is no --json flag because JSON is already the default. Bare slugs are accepted for compatibility when the skill is already installed or unambiguous; owner-qualified refs avoid publisher ambiguity. |
verify provenance | When ClawHub returns server-resolved source provenance, verify JSON also includes a commit-pinned openclaw.verifiedSourceUrl. Unavailable or self-declared source URLs stay only in the raw provenance envelope and are not promoted. |
verify version selector | verify uses .clawhub/origin.json for installed ClawHub skills, so it verifies the installed version against the registry it came from. --version and --tag override the version selector but keep that installed registry when origin metadata exists. |
verify --card | Prints the generated Skill Card Markdown instead of JSON. Exits non-zero when ClawHub returns ok: false or decision: "fail"; unsigned signatures are informational unless ClawHub policy changes. |
| Skill Card fingerprint | Installed ClawHub bundles can include a generated skill-card.md. OpenClaw treats verification as a ClawHub server decision and does not reject an installed skill just because that generated card changes the bundle fingerprint. |
check --agent <id> | Checks the selected agent’s workspace and reports which ready skills are actually visible to that agent’s prompt or command surface. |
list | Default action when no subcommand is provided. |
list/info/check output | Rendered output goes to stdout. With --json, the machine-readable payload stays on stdout for pipes and scripts. |
