Skip to main content
ClawHub is the profClaw plugin marketplace. Published plugins appear in Settings > Plugins > Browse ClawHub and are installable with one click.

​
Publishing Checklist

Before submitting, verify:
  • keywords includes "profclaw-plugin" in package.json
  • profclaw.pluginId is unique (check clawhub.dev)
  • Default export uses definePlugin()
  • settingsSchema declared for all credentials and settings
  • healthCheck() implemented and tested
  • README includes setup instructions and screenshots
  • Tests pass (pnpm test)
  • Build succeeds (pnpm build)
  • No hardcoded secrets or credentials in source

​
Step 1: Publish to npm

npm login
npm publish --access public
Your package name should follow the convention: @yourname/profclaw-plugin-<name>

​
Step 2: Submit to ClawHub

​
Via CLI

profclaw plugins publish --npm-package @yourname/profclaw-plugin-myplugin
This submits to the ClawHub API for review.

​
Via Web

  1. Sign in at clawhub.dev
  2. Click Submit Plugin
  3. Enter your npm package name
  4. Fill in the listing details (category, icon, screenshots)
  5. Submit for review

​
Review Process

ClawHub review checks:
  • Plugin loads without errors in a sandboxed profClaw instance
  • healthCheck() returns { healthy: boolean }
  • No malicious code (automated + manual scan)
  • README quality and accuracy
  • No duplicate functionality without meaningful differentiation
Review typically takes 1-3 business days. You will receive an email on approval or rejection with feedback.

​
Versioning

Follow semantic versioning:
ChangeVersion bump
New feature, backwards compatibleminor
Bug fixpatch
Breaking API changemajor
When you publish a new npm version, ClawHub picks it up automatically within 1 hour. Users on auto-update receive the new version on their next profClaw restart.

​
Listing Metadata

After approval, update your listing at clawhub.dev/my-plugins:
  • Icon: PNG or SVG, 128x128px minimum
  • Screenshots: Show the plugin working in the settings UI
  • Category: search, tool, integration, or model
  • Pricing: Mark as free, paid, or freemium
  • Support URL: Link to your issue tracker

​
Unpublishing

To remove a plugin from ClawHub: 
profclaw plugins unpublish @yourname/profclaw-plugin-myplugin
This hides the listing. Users who already installed the plugin can continue using it. The npm package remains published.

​
ClawHub API

For automated publishing in CI/CD: 
curl -X POST https://api.clawhub.dev/v1/plugins \
  -H "Authorization: Bearer ${CLAWHUB_TOKEN}" \
  -d '{"npmPackage": "@yourname/profclaw-plugin-myplugin"}'
Get a ClawHub API token at clawhub.dev/settings/tokens.