From 192a6ee8700615da107fcd4c52e22a1fdbe1c117 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 30 Jan 2026 21:02:06 +0100
Subject: [PATCH] chore: remove legacy clawdhub files

---
 docs/tools/clawdhub.md   | 201 ---------------------------------------
 skills/clawdhub/SKILL.md |  53 -----------
 2 files changed, 254 deletions(-)
 delete mode 100644 docs/tools/clawdhub.md
 delete mode 100644 skills/clawdhub/SKILL.md

diff --git a/docs/tools/clawdhub.md b/docs/tools/clawdhub.md
deleted file mode 100644
index 9be5b04105..0000000000
--- a/docs/tools/clawdhub.md
+++ /dev/null
@@ -1,201 +0,0 @@
----
-summary: "ClawdHub guide: public skills registry + CLI workflows"
-read_when:
-  - Introducing ClawdHub to new users
-  - Installing, searching, or publishing skills
-  - Explaining ClawdHub CLI flags and sync behavior
----
-
-# ClawdHub
-
-ClawdHub 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: [clawdhub.com](https://clawdhub.com)
-
-## Who this is for (beginner-friendly)
-
-If you want to add new capabilities to your OpenClaw agent, ClawdHub is the easiest way to find and install skills. You do not need to know how the backend works. You can:
-
-- Search for skills by plain language.
-- Install a skill into your workspace.
-- Update skills later with one command.
-- Back up your own skills by publishing them.
-
-## Quick start (non-technical)
-
-1) Install the CLI (see next section).
-2) Search for something you need:
-   - `clawdhub search "calendar"`
-3) Install a skill:
-   - `clawdhub install <skill-slug>`
-4) Start a new OpenClaw session so it picks up the new skill.
-
-## Install the CLI
-
-Pick one:
-
-```bash
-npm i -g clawdhub
-```
-
-```bash
-pnpm add -g clawdhub
-```
-
-## How it fits into OpenClaw
-
-By default, the CLI installs skills into `./skills` under your current working directory. If a OpenClaw workspace is configured, `clawdhub` falls back to that workspace unless you override `--workdir` (or `CLAWDHUB_WORKDIR`). OpenClaw loads workspace skills from `<workspace>/skills` and will pick them up in the **next** session. If you already use `~/.openclaw/skills` or bundled skills, workspace skills take precedence.
-
-For more detail on how skills are loaded, shared, and gated, see
-[Skills](/tools/skills).
-
-## What the service provides (features)
-
-- **Public browsing** of skills and their `SKILL.md` content.
-- **Search** powered by embeddings (vector search), not just keywords.
-- **Versioning** with semver, changelogs, and tags (including `latest`).
-- **Downloads** as a zip per version.
-- **Stars and comments** for community feedback.
-- **Moderation** hooks for approvals and audits.
-- **CLI-friendly API** for automation and scripting.
-
-## CLI commands and parameters
-
-Global options (apply to all commands):
-
-- `--workdir <dir>`: Working directory (default: current dir; falls back to OpenClaw workspace).
-- `--dir <dir>`: Skills directory, relative to workdir (default: `skills`).
-- `--site <url>`: Site base URL (browser login).
-- `--registry <url>`: Registry API base URL.
-- `--no-input`: Disable prompts (non-interactive).
-- `-V, --cli-version`: Print CLI version.
-
-Auth:
-
-- `clawdhub login` (browser flow) or `clawdhub login --token <token>`
-- `clawdhub logout`
-- `clawdhub whoami`
-
-Options:
-
-- `--token <token>`: Paste an API token.
-- `--label <label>`: Label stored for browser login tokens (default: `CLI token`).
-- `--no-browser`: Do not open a browser (requires `--token`).
-
-Search:
-
-- `clawdhub search "query"`
-- `--limit <n>`: Max results.
-
-Install:
-
-- `clawdhub install <slug>`
-- `--version <version>`: Install a specific version.
-- `--force`: Overwrite if the folder already exists.
-
-Update:
-
-- `clawdhub update <slug>`
-- `clawdhub update --all`
-- `--version <version>`: Update to a specific version (single slug only).
-- `--force`: Overwrite when local files do not match any published version.
-
-List:
-
-- `clawdhub list` (reads `.clawdhub/lock.json`)
-
-Publish:
-
-- `clawdhub publish <path>`
-- `--slug <slug>`: Skill slug.
-- `--name <name>`: Display name.
-- `--version <version>`: Semver version.
-- `--changelog <text>`: Changelog text (can be empty).
-- `--tags <tags>`: Comma-separated tags (default: `latest`).
-
-Delete/undelete (owner/admin only):
-
-- `clawdhub delete <slug> --yes`
-- `clawdhub undelete <slug> --yes`
-
-Sync (scan local skills + publish new/updated):
-
-- `clawdhub sync`
-- `--root <dir...>`: Extra scan roots.
-- `--all`: Upload everything without prompts.
-- `--dry-run`: Show what would be uploaded.
-- `--bump <type>`: `patch|minor|major` for updates (default: `patch`).
-- `--changelog <text>`: Changelog for non-interactive updates.
-- `--tags <tags>`: Comma-separated tags (default: `latest`).
-- `--concurrency <n>`: Registry checks (default: 4).
-
-## Common workflows for agents
-
-### Search for skills
-
-```bash
-clawdhub search "postgres backups"
-```
-
-### Download new skills
-
-```bash
-clawdhub install my-skill-pack
-```
-
-### Update installed skills
-
-```bash
-clawdhub update --all
-```
-
-### Back up your skills (publish or sync)
-
-For a single skill folder:
-
-```bash
-clawdhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
-```
-
-To scan and back up many skills at once:
-
-```bash
-clawdhub sync --all
-```
-
-## Advanced details (technical)
-
-### Versioning and tags
-
-- Each publish creates a new **semver** `SkillVersion`.
-- Tags (like `latest`) point to a version; moving tags lets you roll back.
-- Changelogs are attached per version and can be empty when syncing or publishing updates.
-
-### Local changes vs registry versions
-
-Updates compare the local skill contents to registry versions using a content hash. If local files do not match any published version, the CLI asks before overwriting (or requires `--force` in non-interactive runs).
-
-### Sync scanning and fallback roots
-
-`clawdhub sync` scans your current workdir first. If no skills are found, it falls back to known legacy locations (for example `~/openclaw/skills` and `~/.openclaw/skills`). This is designed to find older skill installs without extra flags.
-
-### Storage and lockfile
-
-- Installed skills are recorded in `.clawdhub/lock.json` under your workdir.
-- Auth tokens are stored in the ClawdHub CLI config file (override via `CLAWDHUB_CONFIG_PATH`).
-
-### Telemetry (install counts)
-
-When you run `clawdhub sync` while logged in, the CLI sends a minimal snapshot to compute install counts. You can disable this entirely:
-
-```bash
-export CLAWDHUB_DISABLE_TELEMETRY=1
-```
-
-## Environment variables
-
-- `CLAWDHUB_SITE`: Override the site URL.
-- `CLAWDHUB_REGISTRY`: Override the registry API URL.
-- `CLAWDHUB_CONFIG_PATH`: Override where the CLI stores the token/config.
-- `CLAWDHUB_WORKDIR`: Override the default workdir.
-- `CLAWDHUB_DISABLE_TELEMETRY=1`: Disable telemetry on `sync`.
diff --git a/skills/clawdhub/SKILL.md b/skills/clawdhub/SKILL.md
deleted file mode 100644
index 8b045e9a52..0000000000
--- a/skills/clawdhub/SKILL.md
+++ /dev/null
@@ -1,53 +0,0 @@
----
-name: clawdhub
-description: Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.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 clawdhub CLI.
-metadata: {"openclaw":{"requires":{"bins":["clawdhub"]},"install":[{"id":"node","kind":"node","package":"clawdhub","bins":["clawdhub"],"label":"Install ClawdHub CLI (npm)"}]}}
----
-
-# ClawdHub CLI
-
-Install
-```bash
-npm i -g clawdhub
-```
-
-Auth (publish)
-```bash
-clawdhub login
-clawdhub whoami
-```
-
-Search
-```bash
-clawdhub search "postgres backups"
-```
-
-Install
-```bash
-clawdhub install my-skill
-clawdhub install my-skill --version 1.2.3
-```
-
-Update (hash-based match + upgrade)
-```bash
-clawdhub update my-skill
-clawdhub update my-skill --version 1.2.3
-clawdhub update --all
-clawdhub update my-skill --force
-clawdhub update --all --no-input --force
-```
-
-List
-```bash
-clawdhub list
-```
-
-Publish
-```bash
-clawdhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
-```
-
-Notes
-- Default registry: https://clawdhub.com (override with CLAWDHUB_REGISTRY or --registry)
-- Default workdir: cwd (falls back to OpenClaw workspace); install dir: ./skills (override with --workdir / --dir / CLAWDHUB_WORKDIR)
-- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set