### Install Dependencies and Setup Local Environment

Source: https://github.com/openclaw/clawhub/blob/main/README.md

Install project dependencies, copy the local environment file, and configure it. This is necessary before starting local development servers.

```bash
bun install
cp .env.local.example .env.local
# edit .env.local — see CONTRIBUTING.md for local Convex values
```

--------------------------------

### Install and Get Help

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub-admin/README.md

Install dependencies and view the main help command for the admin CLI.

```bash
bun install
bun run admin -- --help
```

--------------------------------

### Run Worktrunk Setup and Install Dependencies

Source: https://github.com/openclaw/clawhub/blob/main/specs/dev-worktrees.md

Execute Worktrunk's copy-ignored step and then run the setup script. Install Vite if it's not already executable.

```text
wt step copy-ignored || true; bun run setup:worktree -- --quiet --force --prefer-fallback
test -x node_modules/.bin/vite || bun install
```

--------------------------------

### Install Dependencies and Configure Local Environment

Source: https://github.com/openclaw/clawhub/blob/main/CONTRIBUTING.md

Install project dependencies and copy the example environment file for local Convex development. You will need to edit the `.env.local` file with specific values.

```bash
bun install
cp .env.local.example .env.local
```

--------------------------------

### Install Skill using OpenClaw

Source: https://github.com/openclaw/clawhub/blob/main/docs/how-it-works.md

Install a skill from the ClawHub registry using the OpenClaw CLI. The '@openclaw/demo' is a common example skill.

```bash
openclaw skills install @openclaw/demo
```

--------------------------------

### Install a Skill

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub/README.md

Install a specific skill package from the ClawHub registry.

```bash
clawhub install @openclaw/demo
```

--------------------------------

### Example Admin Command

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub-admin/README.md

An example of using the admin CLI to unhide a skill with a reason and confirmation.

```bash
bun run admin -- skills unhide maxhub-pipixia --reason "VT false positive; reanalysis clean" --yes
```

--------------------------------

### Install, List, and Update Skills

Source: https://github.com/openclaw/clawhub/blob/main/specs/manual-testing.md

Commands to manage skills locally, including installation, listing, and updating. Requires creating a temporary directory.

```bash
mkdir -p /tmp/clawhub-manual && cd /tmp/clawhub-manual
```

```bash
bunx clawhub@beta install gifgrep --force
```

```bash
bunx clawhub@beta list
```

```bash
bunx clawhub@beta update gifgrep --force
```

--------------------------------

### Search and Install Plugins with OpenClaw

Source: https://github.com/openclaw/clawhub/blob/main/docs/clawhub.md

Use these commands to search for plugins in ClawHub and install them using the `openclaw` CLI. Note the `clawhub:<package>` format for installing plugins from the registry.

```bash
openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all
```

--------------------------------

### Install ClawHub CLI

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub/README.md

Install the ClawHub CLI using the provided shortcut script or via npm after publishing.

```bash
# From this repo (shortcut script at repo root)
bun clawhub --help

# Once published to npm
# npm i -g clawhub
```

--------------------------------

### Install Plugin from ClawHub

Source: https://github.com/openclaw/clawhub/blob/main/docs/how-it-works.md

Use this command to install a plugin directly from ClawHub, specifying the package name. This ensures the registry is the source of truth for the installation.

```bash
openclaw plugins install clawhub:<package>
```

--------------------------------

### Install Skill Directly from ClawHub

Source: https://github.com/openclaw/clawhub/blob/main/specs/plans/plugins.md

Use this command to install a skill directly from ClawHub.

```bash
openclaw skills install owner/skill-name
```

--------------------------------

### Start Local Convex Backend

Source: https://github.com/openclaw/clawhub/blob/main/README.md

Run the local Convex backend development server. This command starts the backend services required for local development.

```bash
bunx convex dev
```

--------------------------------

### Install Nix Plugin via Nix Configuration

Source: https://github.com/openclaw/clawhub/blob/main/README.md

Declare Nix plugins in your Nix configuration to have clawdbot manage their installation. This example shows how to add a plugin from a GitHub repository.

```nix
programs.clawdbot.plugins = [
  { source = "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo"; }
];

```

--------------------------------

### Preview Detached/Codex Worktree

Source: https://github.com/openclaw/clawhub/blob/main/README.md

Commands to set up and run the detached/Codex worktree preview. This includes starting the worktree development server and getting its URL.

```bash
bun run setup:worktree
bun run dev:worktree
wt --yes url
```

--------------------------------

### POST /api/cli/telemetry/install

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

Sends installation telemetry data.

```APIDOC
## POST /api/cli/telemetry/install

### Description
Sends installation telemetry data. This endpoint is used to track CLI installations.

### Method
POST

### Endpoint
/api/cli/telemetry/install
```

--------------------------------

### Complete Skill Frontmatter Example

Source: https://github.com/openclaw/clawhub/blob/main/docs/skill-format.md

An example of complete frontmatter for a ClawHub skill, including name, description, version, and detailed metadata.

```yaml
---
name: todoist-cli
description: Manage Todoist tasks, projects, and labels from the command line.
version: 1.2.0
metadata:
  openclaw:
    requires:
      env:
        - TODOIST_API_KEY
      bins:
        - curl
    primaryEnv: TODOIST_API_KEY
    envVars:
      - name: TODOIST_API_KEY
        required: true
        description: Todoist API token.
      - name: TODOIST_PROJECT_ID
        required: false
        description: Optional default project ID.
    emoji: "\u2705"
    homepage: https://github.com/example/todoist-cli
---
```

--------------------------------

### Start Local Convex Backend

Source: https://github.com/openclaw/clawhub/blob/main/AGENTS.md

Starts the local Convex backend with type checking disabled for development.

```bash
bunx convex dev --typecheck=disable
```

--------------------------------

### Start Worktree Server

Source: https://github.com/openclaw/clawhub/blob/main/AGENTS.md

Starts a detached worktree server that seeds local fixtures and the public corpus. Requires 'wt' on PATH.

```bash
bun run dev:worktree
```

--------------------------------

### Start Local Web App

Source: https://github.com/openclaw/clawhub/blob/main/README.md

Run the local web application development server, typically accessible on port 3000. This command starts the frontend application.

```bash
bun run dev
```

--------------------------------

### Verify ClawHub CLI Installation

Source: https://github.com/openclaw/clawhub/blob/main/docs/cli.md

Verify the installation by running the help command and checking login status. These commands confirm the CLI is accessible and functional.

```bash
clawhub --help
```

```bash
clawhub login
```

```bash
clawhub whoami
```

--------------------------------

### Declare Install Dependencies

Source: https://github.com/openclaw/clawhub/blob/main/docs/skill-format.md

Declare skill dependencies using the 'install' array in the metadata. Supported kinds include brew, node, go, and uv.

```yaml
metadata:
  openclaw:
    install:
      - kind: brew
        formula: jq
        bins: [jq]
      - kind: node
        package: typescript
        bins: [tsc]
```

--------------------------------

### Search and Install Skills with OpenClaw

Source: https://github.com/openclaw/clawhub/blob/main/docs/clawhub.md

Use these commands to search for skills in ClawHub and install them using the `openclaw` CLI.

```bash
openclaw skills search "calendar"
openclaw skills install @openclaw/demo
openclaw skills update --all
```

--------------------------------

### ClawHub CLI Skill Installation

Source: https://github.com/openclaw/clawhub/blob/main/docs/clawhub.md

Commands to install and update skills from ClawHub into the local workspace.

```bash
clawhub install @openclaw/demo
clawhub update @openclaw/demo
clawhub update --all
clawhub list
```

--------------------------------

### GitHub-Backed Skill Install Response (Success)

Source: https://github.com/openclaw/clawhub/blob/main/specs/github-backed-skills.md

This JSON response indicates a successful installation of a GitHub-backed skill. It provides repository details, path, commit SHA, and content hash for the skill.

```json
{
  "ok": true,
  "installKind": "github",
  "github": {
    "repo": "NVIDIA/skills",
    "path": "skills/aiq-deploy",
    "commit": "<40-char sha>",
    "contentHash": "<skill-folder hash>",
    "sourceUrl": "https://github.com/NVIDIA/skills/tree/<sha>/skills/aiq-deploy"
  }
}
```

--------------------------------

### Install Code Plugin via ClawHub Source

Source: https://github.com/openclaw/clawhub/blob/main/specs/plans/plugins.md

Use this command to install a code plugin directly from a ClawHub source.

```bash
openclaw plugins install clawhub:@scope/pkg
```

--------------------------------

### Setup Worktree with Environment Variable

Source: https://github.com/openclaw/clawhub/blob/main/CONTRIBUTING.md

Alternatively, specify the source worktree using an environment variable.

```bash
CLAWHUB_WORKTREE_SOURCE=/path/to/source/worktree bun run setup:worktree
```

--------------------------------

### ClawHub CLI Install Commands with Package Manager Flexibility

Source: https://github.com/openclaw/clawhub/blob/main/specs/superpowers/2026-04-22-skill-install-surface-design.md

These commands demonstrate installing a skill using ClawHub CLI, supporting multiple package managers like npx, pnpm, and bunx. npm is the default.

```sh
npx clawhub@latest install slug
```

```sh
pnpm dlx clawhub@latest install slug
```

```sh
bunx clawhub@latest install slug
```

--------------------------------

### URL Redirection Examples for Official Aliases

Source: https://github.com/openclaw/clawhub/blob/main/specs/slug-routing.md

Illustrates how different URL patterns redirect to the canonical plugin page for an official alias. These examples show the expected behavior for top-level and scoped alias paths.

```text
/<alias> -> /openclaw/plugins/<alias>
/openclaw/<alias> -> /openclaw/plugins/<alias>
/@openclaw/<alias> -> /openclaw/plugins/<alias>
```

--------------------------------

### Run the Frontend Development Server

Source: https://github.com/openclaw/clawhub/blob/main/CONTRIBUTING.md

Start the frontend development server. Ensure the port matches your `SITE_URL` configuration.

```bash
bun run dev -- --port 3000
```

--------------------------------

### Get Package Release Security Summary

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

Retrieve the security and trust summary for a specific package release. This is used by install clients to decide if a release can be installed. No authentication is required.

```json
{
  "package": {
    "name": "@openclaw/example-plugin",
    "displayName": "Example Plugin",
    "family": "code-plugin"
  },
  "release": {
    "releaseId": "packageReleases:...",
    "version": "1.2.3",
    "artifactKind": "npm-pack",
    "artifactSha256": "0123456789abcdef...",
    "npmIntegrity": "sha512-ப்படாத",
    "npmShasum": "0123456789abcdef0123456789abcdef01234567",
    "npmTarballName": "example-plugin-1.2.3.tgz",
    "createdAt": 1730000000000
  },
  "trust": {
    "scanStatus": "malicious",
    "moderationState": "quarantined",
    "blockedFromDownload": true,
    "reasons": ["manual:quarantined", "scan:malicious"],
    "pending": false,
    "stale": false
  }
}
```

--------------------------------

### Search Skills API Response

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

Example JSON response structure for the `GET /api/v1/search` endpoint, detailing the fields returned for each skill.

```json
{
  "results": [
    {
      "score": 0.123,
      "slug": "gifgrep",
      "displayName": "GifGrep",
      "summary": "…",
      "version": "1.2.3",
      "updatedAt": 1730000000000,
      "ownerHandle": "openclaw",
      "owner": {
        "handle": "openclaw",
        "displayName": "OpenClaw",
        "image": "https://example.com/avatar.png"
      }
    }
  ]
}
```

--------------------------------

### List Skills API Response

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

Example JSON response structure for the `GET /api/v1/skills` endpoint, including skill metadata and pagination information.

```json
{
  "items": [
    {
      "slug": "gifgrep",
      "displayName": "GifGrep",
      "summary": "…",
      "topics": ["Productivity"],
      "tags": { "latest": "1.2.3" },
      "stats": {},
      "createdAt": 0,
      "updatedAt": 0,
      "latestVersion": { "version": "1.2.3", "createdAt": 0, "changelog": "…" },
      "metadata": { "os": ["macos"], "systems": ["aarch64-darwin"] }
    }
  ],
  "nextCursor": null
}
```

--------------------------------

### CLI Setup and Smoke Tests

Source: https://github.com/openclaw/clawhub/blob/main/specs/manual-testing.md

Commands to ensure you are logged in and to perform basic CLI smoke tests.

```bash
bun clawhub whoami
```

```bash
bun clawhub login
```

```bash
bun clawhub --help
```

```bash
bun clawhub --cli-version
```

```bash
bun clawhub whoami
```

--------------------------------

### GET /api/v1/packages/{name}/versions/{version}/security

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

Retrieves the security and trust summary for a specific package release. This endpoint is crucial for clients to determine if a package release is safe to install.

```APIDOC
## GET /api/v1/packages/{name}/versions/{version}/security

### Description
Returns the exact package release security and trust summary for install clients. This is the public OpenClaw consumption surface for deciding whether a resolved release can be installed.

### Method
GET

### Endpoint
/api/v1/packages/{name}/versions/{version}/security

### Parameters
#### Path Parameters
- **name** (string) - Required - The name of the package.
- **version** (string) - Required - The specific version of the package.

### Response
#### Success Response (200)
- **package** (object) - Identifies the resolved registry package.
  - **name** (string) - The name of the package.
  - **displayName** (string) - The display name of the package.
  - **family** (string) - The family the package belongs to.
- **release** (object) - Identifies the exact release that was evaluated.
  - **releaseId** (string) - The unique identifier for the release.
  - **version** (string) - The version of the release.
  - **artifactKind** (string) - The kind of artifact for the release.
  - **artifactSha256** (string) - The SHA256 hash of the artifact.
  - **npmIntegrity** (string) - The npm integrity hash.
  - **npmShasum** (string) - The npm shasum.
  - **npmTarballName** (string) - The name of the npm tarball.
  - **createdAt** (integer) - The timestamp when the release was created.
- **trust** (object) - Contains information about the trust status and moderation.
  - **scanStatus** (string) - The effective trust status.
  - **moderationState** (string | null) - The manual moderation state, or null if none exists.
  - **blockedFromDownload** (boolean) - Signal to block installation.
  - **reasons** (array) - User-facing and audit explanation list.
  - **pending** (boolean) - Indicates if trust inputs are awaiting completion.
  - **stale** (boolean) - Indicates if the trust summary is computed from outdated inputs.

### Response Example
```json
{
  "package": {
    "name": "@openclaw/example-plugin",
    "displayName": "Example Plugin",
    "family": "code-plugin"
  },
  "release": {
    "releaseId": "packageReleases:...",
    "version": "1.2.3",
    "artifactKind": "npm-pack",
    "artifactSha256": "0123456789abcdef...",
    "npmIntegrity": "sha512-ப்படாத",
    "npmShasum": "0123456789abcdef0123456789abcdef01234567",
    "npmTarballName": "example-plugin-1.2.3.tgz",
    "createdAt": 1730000000000
  },
  "trust": {
    "scanStatus": "malicious",
    "moderationState": "quarantined",
    "blockedFromDownload": true,
    "reasons": ["manual:quarantined", "scan:malicious"],
    "pending": false,
    "stale": false
  }
}
```
```

--------------------------------

### Get Security Verdicts for Skills

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

Returns current compact security verdicts for exact skill versions. This endpoint is intended for clients that already know which installed ClawHub skill versions they need to display.

```APIDOC
## POST /api/v1/skills/-/security-verdicts

### Description
Returns current compact security verdicts for exact skill versions. This collection endpoint is intended for clients that already know which installed ClawHub skill versions they need to display, such as OpenClaw Control UI.

### Method
POST

### Endpoint
/api/v1/skills/-/security-verdicts

### Parameters
#### Request Body
- **items** (array) - Required - An array of objects, where each object contains `slug` (string) and `version` (string) for the skills.
  - **slug** (string) - Required - The unique identifier of the skill.
  - **version** (string) - Required - The specific version of the skill.

### Request Example
```json
{
  "items": [{ "slug": "gifgrep", "version": "1.2.3" }]
}
```

### Response
#### Success Response (200)
- **schema** (string) - The schema version of the response.
- **items** (array) - An array of security verdict objects for each requested skill.
  - **ok** (boolean) - Indicates if the skill verdict is okay.
  - **decision** (string) - The security decision for the skill (e.g., "pass", "fail").
  - **reasons** (array) - A list of reasons for the decision.
  - **requestedSlug** (string) - The slug requested in the query.
  - **slug** (string) - The skill's slug.
  - **displayName** (string) - The display name of the skill.
  - **publisherHandle** (string) - The handle of the skill's publisher.
  - **publisherDisplayName** (string) - The display name of the skill's publisher.
  - **requestedVersion** (string) - The version requested.
  - **version** (string) - The skill's version.
  - **createdAt** (integer) - Timestamp of when the skill was created.
  - **checkedAt** (integer) - Timestamp of when the skill was last checked.
  - **skillUrl** (string) - URL to the skill on ClawHub.
  - **securityAuditUrl** (string) - URL to the security audit page for the skill.
  - **security** (object) - Security-related information.
    - **status** (string) - The overall security status (e.g., "clean").
    - **passed** (boolean) - Indicates if security checks passed.
    - **signals** (object) - Security signals from various scanners.
      - **staticScan** (object) - Results from the static scan.
        - **status** (string) - Status of the static scan.
        - **reasonCodes** (array) - Reason codes for the static scan status.
      - **virusTotal** (object or null) - VirusTotal scan results.
      - **skillSpector** (object or null) - SkillSpector scan results.
      - **dependencyRegistry** (object or null) - Dependency registry scan results (deprecated).
  - **error** (object) - Error object if the item failed.
    - **code** (string) - Error code.
    - **message** (string) - Error message.

#### Response Example
```json
{
  "schema": "clawhub.skill.security-verdicts.v1",
  "items": [
    {
      "ok": true,
      "decision": "pass",
      "reasons": [],
      "requestedSlug": "gifgrep",
      "slug": "gifgrep",
      "displayName": "GifGrep",
      "publisherHandle": "steipete",
      "publisherDisplayName": "Peter",
      "requestedVersion": "1.2.3",
      "version": "1.2.3",
      "createdAt": 0,
      "checkedAt": 0,
      "skillUrl": "https://clawhub.ai/steipete/skills/gifgrep",
      "securityAuditUrl": "https://clawhub.ai/steipete/skills/gifgrep/security-audit?version=1.2.3",
      "security": {
        "status": "clean",
        "passed": true,
        "signals": {
          "staticScan": { "status": "clean", "reasonCodes": [] },
          "virusTotal": null,
          "skillSpector": null,
          "dependencyRegistry": null
        }
      }
    },
    {
      "ok": false,
      "decision": "fail",
      "reasons": ["version.not_found"],
      "requestedSlug": "missing-version",
      "requestedVersion": "1.0.0",
      "error": { "code": "version_not_found", "message": "Version not found" },
      "security": null
    }
  ]
}
```
```

--------------------------------

### Setup Worktree

Source: https://github.com/openclaw/clawhub/blob/main/AGENTS.md

Validates or links local state for worktrees. Use -- --from <path> or CLAWHUB_WORKTREE_SOURCE=<path> to specify a source.

```bash
bun run setup:worktree
```

--------------------------------

### Local Convex Backend Configuration

Source: https://github.com/openclaw/clawhub/blob/main/CONTRIBUTING.md

Example environment variables for local Convex development. These should be set in your `.env.local` file.

```bash
# Frontend
VITE_CONVEX_URL=http://127.0.0.1:3210
VITE_CONVEX_SITE_URL=http://127.0.0.1:3211
SITE_URL=http://localhost:3000

# Convex Auth / HTTP routes
CONVEX_SITE_URL=http://127.0.0.1:3211

# Deployment used by `bunx convex dev`
CONVEX_DEPLOYMENT=anonymous:anonymous-clawhub
```

--------------------------------

### Update all installed plugins

Source: https://github.com/openclaw/clawhub/blob/main/docs/quickstart.md

Updates all plugins that were previously installed via OpenClaw.

```bash
openclaw plugins update --all
```

--------------------------------

### Update all installed skills

Source: https://github.com/openclaw/clawhub/blob/main/docs/quickstart.md

Updates all skills that were previously installed via OpenClaw.

```bash
openclaw skills update --all
```

--------------------------------

### Minimal mint.json Configuration

Source: https://github.com/openclaw/clawhub/blob/main/specs/mintlify.md

This is a starter configuration for your `mint.json` file. It defines the project name, logo, and navigation structure for your documentation site.

```json
{
  "name": "ClawHub",
  "logo": "public/logo.svg",
  "navigation": [
    { "group": "Start", "pages": ["docs/README", "docs/quickstart"] },
    { "group": "Concepts", "pages": ["docs/architecture", "docs/skill-format", "docs/telemetry"] },
    { "group": "Reference", "pages": ["docs/cli", "docs/http-api", "docs/auth", "docs/deploy"] }
  ]
}
```

--------------------------------

### Build and Verify Admin CLI

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub-admin/README.md

Build and verify the admin CLI package from the repository root.

```bash
bun run --cwd packages/clawhub-admin build
bun run --cwd packages/clawhub-admin verify
```

--------------------------------

### Run Production Deploy Workflow

Source: https://github.com/openclaw/clawhub/blob/main/AGENTS.md

Manually start the GitHub Actions 'Deploy' workflow from the main branch to initiate a production release. Supports 'full', 'backend', and 'frontend' targets.

```bash
gh workflow run deploy.yml --repo openclaw/clawhub --ref main
```

--------------------------------

### Install Code Plugin via npm-compatible Registry

Source: https://github.com/openclaw/clawhub/blob/main/specs/plans/plugins.md

Use this command to install a code plugin from ClawHub using an npm-compatible registry endpoint.

```bash
openclaw plugins install @scope/pkg --registry https://clawhub.ai
```

--------------------------------

### Explore Packages

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub/README.md

Explore available packages by family, such as 'skill' or 'code-plugin'.

```bash
clawhub package explore --family skill
clawhub package explore --family code-plugin
```

--------------------------------

### Production Build

Source: https://github.com/openclaw/clawhub/blob/main/AGENTS.md

Creates a production build of the application using Vite and Nitro.

```bash
bun run build
```

--------------------------------

### Install ClawHub CLI

Source: https://github.com/openclaw/clawhub/blob/main/docs/clawhub.md

Install the `clawhub` CLI globally using npm or pnpm. This CLI is required for registry-authenticated workflows like publishing and managing packages.

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

```bash
pnpm add -g clawhub
```

--------------------------------

### Download a Package

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub/README.md

Download a specific version or tag of a package from the registry.

```bash
clawhub package download @openclaw/example-plugin --tag latest
```

--------------------------------

### Run All Package CI

Source: https://github.com/openclaw/clawhub/blob/main/packages/clawhub-admin/README.md

Execute the CI process for all packages from the repository root.

```bash
bun run ci:packages
```

--------------------------------

### OpenClaw CLI Install Command

Source: https://github.com/openclaw/clawhub/blob/main/specs/superpowers/2026-04-22-skill-install-surface-design.md

Use this command to install a skill using the OpenClaw CLI. It supports fallback mechanisms for owner identification if the canonical handle is unavailable.

```sh
openclaw skills install owner/slug
```

--------------------------------

### Set Convex Environment Variables and Deploy Locally

Source: https://github.com/openclaw/clawhub/blob/main/specs/deploy.md

Set production environment variables for the Convex backend and initiate a local deployment. Ensure APP_BUILD_SHA and APP_DEPLOYED_AT are current.

```bash
bunx convex env set APP_BUILD_SHA "$(git rev-parse HEAD)" --prod
bunx convex env set APP_DEPLOYED_AT "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" --prod
bunx convex deploy
```

--------------------------------

### Passing Explicit Source to Setup Worktree

Source: https://github.com/openclaw/clawhub/blob/main/specs/dev-worktrees.md

When auto-discovery selects the incorrect source for worktree setup, you can explicitly specify the source directory. This is useful for ensuring the correct environment is copied or linked.

```bash
bun run setup:worktree -- --from /path/to/source/worktree
CLAWHUB_WORKTREE_SOURCE=/path/to/source/worktree bun run setup:worktree
```

--------------------------------

### Recommended Plugin Package Metadata

Source: https://github.com/openclaw/clawhub/blob/main/specs/plans/plugins.md

Example structure for package metadata, including OpenClaw-specific fields for extensions, compatibility, and build information.

```json
{
  "openclaw": {
    "extensions": ["./dist/index.js"],
    "compat": {
      "pluginApi": "^1.2.0",
      "minGatewayVersion": "2026.3.0"
    },
    "build": {
      "openclawVersion": "2026.3.14",
      "pluginSdkVersion": "2026.3.14"
    }
  }
}
```

--------------------------------

### Include CLI Help for Nix Plugin

Source: https://github.com/openclaw/clawhub/blob/main/README.md

Embed the CLI help output for a Nix plugin in its SKILL.md metadata. This is recommended for Nix plugins to provide usage information.

```yaml
---
name: padel
description: Check padel court availability and manage bookings via Playtomic.
metadata: { "clawdbot": { "cliHelp": "padel --help\nUsage: padel [command]\n" } }
---

```

--------------------------------

### Example 429 Rate Limit Exceeded Response

Source: https://github.com/openclaw/clawhub/blob/main/docs/http-api.md

This example shows the headers and body of an HTTP 429 response when rate limits are exceeded. It includes standard and legacy rate limit headers, as well as the `Retry-After` header for guidance on when to retry.

```http
HTTP/2 429
content-type: text/plain; charset=utf-8
x-ratelimit-limit: 20
x-ratelimit-remaining: 0
x-ratelimit-reset: 1771404540
ratelimit-limit: 20
ratelimit-remaining: 0
ratelimit-reset: 34
retry-after: 34

Rate limit exceeded
```

--------------------------------

### ClawHub Scan Command with Options

Source: https://github.com/openclaw/clawhub/blob/main/specs/superpowers/plans/2026-06-03-clawhub-scan-command-plan.md

Examples demonstrating the use of options like `--slug`, `--version`, and `--output` with the `clawhub scan` command.

```sh
clawhub scan --slug demo --version 1.2.3 --update
```

```sh
clawhub scan --slug demo --output report.zip
```

```sh
clawhub scan fixtures/skill --slug demo
```