clawhub-publisher

What This Skill Does

The clawhub-publisher is a specialized OpenClaw agent skill designed to streamline the deployment of custom AI agent skills to the ClawHub marketplace. It functions as an intelligent wrapper around the official ClawHub CLI, automating the repetitive and error-prone aspects of publishing. By handling environment validation, CLI patching, slug conflict management, and automated retries for rate-limited requests, it ensures a seamless developer experience. This skill effectively lowers the barrier to entry for creators, allowing them to focus on code quality rather than deployment infrastructure.

Installation

To install this skill, use the following OpenClaw command: clawhub install openclaw/skills/skills/antonia-sz/clawhub-publish-skill

Ensure your local environment has the ClawHub CLI installed globally via npm (e.g., npm install -g clawhub). The skill requires read permissions for your local workspace and write access to the CLI configuration paths to perform necessary patching.

Use Cases

• Automated Deployment: Ideal for developers managing multiple skills who want a "one-shot" publication flow.
• Error Mitigation: Specifically useful for users encountering the known acceptLicenseTerms bug in the official CLI, as this skill applies an idempotent patch automatically.
• CI/CD Integration: Can be utilized by automated scripts to push updates to the marketplace without manual intervention.
• Rate Management: Handles network bottlenecks gracefully by scheduling retries for 429 Too Many Requests errors using the OpenClaw cron utility.

Example Prompts

1. "发布这个 skill 到 clawhub，路径是 /root/skills/my-new-agent，slug 为 my-new-agent，token 是 clh_123456。"
2. "把 /workspace/skills/data-analyzer 上传到 clawhub，slug 用 data-analyzer-v1，剩下的参数请引导我输入。"
3. "clawhub publish，目录在 /home/user/skills/translator，帮我自动处理一下发布流程。"

Tips & Limitations

• Token Security: Always store your clh_ tokens securely. The agent requires them for direct authentication with the ClawHub API.
• Directory Structure: Ensure your target directory contains a valid SKILL.md file, as the publisher will validate this before attempting any network requests.
• Slug Strategy: Choose descriptive, lowercase, kebab-case slugs. If a conflict occurs, the skill will suggest a suffix, but selecting unique names from the start will optimize the process.
• Environment: Currently optimized for Linux/macOS environments where standard pathing for global node modules exists.