clawhub-production-release

ClawHub Production Release

ClawHub production changes are manual-only. Merging to main does not deploy

the app or publish the CLI.

Safety Rules

• Run production workflows from main.
• Re-read the workflow and exact main SHA immediately before dispatch.
• Require a successful Deploy Test workflow for that exact SHA before

dispatching an app production deploy. This is an operator check until the

production workflow enforces the gate directly.

• Do not treat a green workflow alone as proof. Record the workflow URL, exact

deployed SHA, and live-surface verification.

• Do not add one-off migrations or repairs to the deploy workflow. Run

operator-controlled data changes separately with clawhub-convex and

create-and-cleanup-migration.

• Never start a production deploy or npm publish unless the user explicitly

asked for that release action.

App Production Deploy

The workflow is .github/workflows/deploy.yml.

1. Confirm the selected commit is on origin/main and record its SHA.
2. Find the successful Test deployment for that exact SHA and record its URL:

gh run list \
  --repo openclaw/clawhub \
  --workflow deploy-test.yml \
  --branch main \
  --commit <MAIN_SHA> \
  --status success \
  --limit 1

If no successful exact-SHA Test run exists, stop and fix or rerun Test before

releasing production.

1. Run the required pre-merge or release validation for the changed surface.
2. Dispatch one target:

gh workflow run deploy.yml \
  --repo openclaw/clawhub \
  --ref main \
  -f target=full \
  -f allow_deleting_large_indexes=false

Choose full, backend, or frontend:

• full: deploy Convex, wait for the matching Vercel production deployment,

and run production smoke checks.

• backend: deploy Convex and run production HTTP smoke checks.
• frontend: wait for Vercel's production deployment for the selected main

SHA, then run HTTP and UI smoke checks. The workflow does not call

vercel deploy.

Set allow_deleting_large_indexes=true only after reviewing the Convex index

deletion and explicitly accepting it.

1. Capture the workflow run URL and wait for completion.
2. Verify the run used the expected SHA.
3. Verify the affected live route, API, or backend contract on

https://clawhub.ai.

1. Report the Test workflow URL, production workflow URL, deployed SHA, target,

and live proof.

The workflow uses the GitHub Production environment. Backend deploys require

the environment secret CONVEX_DEPLOY_KEY. The optional

PLAYWRIGHT_AUTH_STORAGE_STATE_JSON enables authenticated UI smoke coverage.

Stable CLI npm Release

The workflow is .github/workflows/clawhub-cli-npm-release.yml. Stable tags

must use vX.Y.Z.

1. Confirm the tag points to the intended commit on main.
2. Dispatch validation-only preflight:

gh workflow run clawhub-cli-npm-release.yml \
  --repo openclaw/clawhub \
  --ref main \
  -f tag=vX.Y.Z \
  -f preflight_only=true

1. Wait for success and record the preflight run ID and URL.
2. Promote that exact artifact in the real publish:

gh workflow run clawhub-cli-npm-release.yml \
  --repo openclaw/clawhub \
  --ref main \
  -f tag=vX.Y.Z \
  -f preflight_only=false \
  -f preflight_run_id=<RUN_ID>

1. Wait for the npm-release environment job and verify the published version

from npm.

1. Report the preflight URL, publish URL, tag, release SHA, and published

version.

Real publishes use npm trusted publishing through the npm-release GitHub

environment. The trusted publisher must match repository

openclaw/clawhub, workflow clawhub-cli-npm-release.yml, and environment

npm-release.