clawpub

Multi-hub deployment tool for OpenClaw skills. Packages and publishes skills to multiple competing claw hubs simultaneously.

Install

npm install -g clawpub

Quick Start

1. Create a clawpub.json in your skill project root (see examples/clawpub.json).
2. Run clawpub publish to push to all enabled hubs.

Commands

# Publish main skill to all enabled hubs
clawpub publish

# Publish to a specific hub
clawpub publish --hub clawhub

# Publish all variants too
clawpub publish --variants

# Reserve names across all hubs
clawpub reserve

# Check publish status
clawpub status

# Build variants locally (no publish)
clawpub build
clawpub build --clean

Configuration

Create clawpub.json in your project root:

{
  "skill": {
    "name": "my-skill",
    "source": "./public",
    "slug": "my-skill"
  },
  "hubs": {
    "clawhub": {
      "enabled": true,
      "registry": "https://clawhub.ai",
      "tags": ["latest"]
    },
    "github": {
      "enabled": true,
      "owner": "your-org",
      "repo": "your-repo",
      "tagPrefix": "skill-v"
    }
  },
  "variants": [
    {
      "name": "stripe",
      "slug": "stripe",
      "configPath": "./skill-variants/stripe/variant.config.json"
    }
  ],
  "reserve": {
    "names": ["my-skill", "my-skill-pro"]
  }
}

Supported Hubs

Hub	Key	Method
ClawHub	clawhub	clawhub CLI
GitHub Releases	github	gh CLI
Any ClawHub-compatible registry	custom key	HTTP API via /.well-known/clawhub.json discovery

Custom Registry

Any hub key not matching clawhub or github is treated as a generic ClawHub-compatible registry:

{
  "hubs": {
    "tencent": {
      "enabled": true,
      "url": "https://skillhub.example.com",
      "authTokenEnv": "TENCENT_SKILLHUB_TOKEN"
    }
  }
}

Variants

Variants let you publish modified versions of a skill (e.g., different payment providers). The variant config file controls overrides:

{
  "name": "stripe",
  "slug": "stripe",
  "title": "Stripe Payment Skill",
  "description": "Process payments with Stripe",
  "frontmatter": {
    "provider": "stripe"
  },
  "urlRewrites": [
    { "from": "https://example.com/pay", "to": "https://stripe.example.com/pay" }
  ],
  "fileOverrides": {
    "config.json": "./stripe-config.json"
  }
}

Prerequisites

• Node.js 20+
• clawhub CLI (for ClawHub publishing)
• gh CLI (for GitHub Releases publishing)

License

MIT - Wayy Research