Skip to content

PUBLISH.md

Latest commit

 

History

History
91 lines (67 loc) · 2.9 KB

PUBLISH.md

File metadata and controls

91 lines (67 loc) · 2.9 KB
Raw

Publishing to ClawHub - Step by Step Guide

ClawHub is the public skill registry for OpenClaw

Published Packages

Last updated 2026-06-04 (verified via npm view <pkg> version) — 3 stale entries (xingp14-woclaw / woclaw-hub / woclaw-hooks) aligned with current npm-published versions

Package Version Status Registry
xingp14-woclaw 0.4.3 ✅ Done npm
woclaw-hub 0.5.0 ✅ Done npm
woclaw-mcp 0.1.2 ✅ Done npm
woclaw-hooks 0.5.0 ✅ Done npm
opencode-woclaw 0.1.0 ✅ Done npm
WoClaw Skill — ⏳ Blocked ClawHub (~2026-04-13)
Docker Hub latest ✅ Done Docker Hub

npm Publishing Guide

xingp14-woclaw (Plugin + Skill)

cd plugin
HOME=/home/node/.openclaw/tmp npm publish

woclaw-hub (Server)

cd hub
HOME=/home/node/.openclaw/tmp npm publish

npm Token

Token stored in GitHub Actions secrets: NPM_TOKEN

ClawHub Publishing

Prerequisites

  • GitHub account connected to ClawHub
  • Account age ≥ 14 days

Estimated ready: ~2026-04-13 (GitHub account created 2026-03-30, needs 14 days)

clawhub login
clawhub sync --all

Docker Hub Publishing

🏷️ 下方 0.5.0 为当前 woclaw-hub 最新版本（截至 2026-06-04）。发布新版本时把 0.5.0 替换为新版本号即可。

Build

cd hub
docker build -t xingp14/woclaw-hub:latest ./hub
docker tag xingp14/woclaw-hub:latest xingp14/woclaw-hub:0.5.0

Login

docker login

Push

docker push xingp14/woclaw-hub:latest
docker push xingp14/woclaw-hub:0.5.0

GitHub Actions Auto-Sync

✅ CI/CD Fully Configured (2026-04-01):

  • ✅ Auto-publish to npm on tag (plugin/v* → xingp14-woclaw, hub/v* → woclaw-hub, hooks/v* → woclaw-hooks)
  • ✅ Auto-build and push Docker image on hub/v* tag
  • ⏳ Auto-sync to ClawHub — pending GitHub account age ≥14 days (~2026-04-13)

Current Status

  • Fix npm publish readiness (ESM, dist structure) - 2026-03-31
  • npm publish xingp14-woclaw@0.3.0 - 2026-04-01
  • npm publish woclaw-hub@0.2.0 - 2026-04-01
  • npm publish woclaw-mcp@0.1.2 (via GitHub Actions)
  • npm publish woclaw-hooks@0.4.0 (via GitHub Actions)
  • Set up GitHub Actions CI/CD (publish.yml, hub-publish.yml, docker-publish.yml)
  • Docker Hub credentials configured (DOCKERHUB_USERNAME + DOCKERHUB_TOKEN)
  • Trigger Docker Hub publish (push hub/v* tag to GitHub)
  • Publish to ClawHub (clawhub sync) — blocked until GitHub account age ≥14 days (~2026-04-13, GitHub created 2026-03-30)