name: Plugin ClawHub Release on: workflow_dispatch: inputs: publish_scope: description: Publish the selected plugins or all ClawHub-publishable plugins from the workflow ref required: true default: selected type: choice options: - selected - all-publishable plugins: description: Comma-separated plugin package names to publish when publish_scope=selected required: false type: string concurrency: group: plugin-clawhub-release-${{ github.sha }} cancel-in-progress: false env: FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true" NODE_VERSION: "24.x" PNPM_VERSION: "10.32.1" CLAWHUB_REGISTRY: "https://clawhub.ai" CLAWHUB_REPOSITORY: "openclaw/clawhub" # Pinned to a reviewed ClawHub commit so release behavior stays reproducible. CLAWHUB_REF: "4af2bd50a71465683dbf8aa269af764b9d39bdf5" jobs: preview_plugins_clawhub: runs-on: ubuntu-latest permissions: contents: read outputs: ref_sha: ${{ steps.ref.outputs.sha }} has_candidates: ${{ steps.plan.outputs.has_candidates }} candidate_count: ${{ steps.plan.outputs.candidate_count }} skipped_published_count: ${{ steps.plan.outputs.skipped_published_count }} matrix: ${{ steps.plan.outputs.matrix }} steps: - name: Checkout uses: actions/checkout@v6 with: ref: ${{ github.sha }} fetch-depth: 0 - name: Setup Node environment uses: ./.github/actions/setup-node-env with: node-version: ${{ env.NODE_VERSION }} pnpm-version: ${{ env.PNPM_VERSION }} install-bun: "false" use-sticky-disk: "false" - name: Resolve checked-out ref id: ref run: echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT" - name: Validate ref is on main run: | set -euo pipefail git fetch --no-tags origin +refs/heads/main:refs/remotes/origin/main git merge-base --is-ancestor HEAD origin/main - name: Validate publishable plugin metadata env: PUBLISH_SCOPE: ${{ github.event_name == 'workflow_dispatch' && inputs.publish_scope || '' }} RELEASE_PLUGINS: ${{ github.event_name == 'workflow_dispatch' && inputs.plugins || '' }} BASE_REF: ${{ github.event_name != 'workflow_dispatch' && github.event.before || '' }} HEAD_REF: ${{ steps.ref.outputs.sha }} run: | set -euo pipefail if [[ -n "${PUBLISH_SCOPE}" ]]; then release_args=(--selection-mode "${PUBLISH_SCOPE}") if [[ -n "${RELEASE_PLUGINS}" ]]; then release_args+=(--plugins "${RELEASE_PLUGINS}") fi pnpm release:plugins:clawhub:check -- "${release_args[@]}" elif [[ -n "${BASE_REF}" ]]; then pnpm release:plugins:clawhub:check -- --base-ref "${BASE_REF}" --head-ref "${HEAD_REF}" else pnpm release:plugins:clawhub:check fi - name: Resolve plugin release plan id: plan env: PUBLISH_SCOPE: ${{ github.event_name == 'workflow_dispatch' && inputs.publish_scope || '' }} RELEASE_PLUGINS: ${{ github.event_name == 'workflow_dispatch' && inputs.plugins || '' }} BASE_REF: ${{ github.event_name != 'workflow_dispatch' && github.event.before || '' }} HEAD_REF: ${{ steps.ref.outputs.sha }} CLAWHUB_REGISTRY: ${{ env.CLAWHUB_REGISTRY }} run: | set -euo pipefail mkdir -p .local if [[ -n "${PUBLISH_SCOPE}" ]]; then plan_args=(--selection-mode "${PUBLISH_SCOPE}") if [[ -n "${RELEASE_PLUGINS}" ]]; then plan_args+=(--plugins "${RELEASE_PLUGINS}") fi node --import tsx scripts/plugin-clawhub-release-plan.ts "${plan_args[@]}" > .local/plugin-clawhub-release-plan.json elif [[ -n "${BASE_REF}" ]]; then node --import tsx scripts/plugin-clawhub-release-plan.ts --base-ref "${BASE_REF}" --head-ref "${HEAD_REF}" > .local/plugin-clawhub-release-plan.json else node --import tsx scripts/plugin-clawhub-release-plan.ts > .local/plugin-clawhub-release-plan.json fi cat .local/plugin-clawhub-release-plan.json candidate_count="$(jq -r '.candidates | length' .local/plugin-clawhub-release-plan.json)" skipped_published_count="$(jq -r '.skippedPublished | length' .local/plugin-clawhub-release-plan.json)" has_candidates="false" if [[ "${candidate_count}" != "0" ]]; then has_candidates="true" fi matrix_json="$(jq -c '.candidates' .local/plugin-clawhub-release-plan.json)" { echo "candidate_count=${candidate_count}" echo "skipped_published_count=${skipped_published_count}" echo "has_candidates=${has_candidates}" echo "matrix=${matrix_json}" } >> "$GITHUB_OUTPUT" echo "Plugin release candidates:" jq -r '.candidates[]? | "- \(.packageName)@\(.version) [\(.publishTag)] from \(.packageDir)"' .local/plugin-clawhub-release-plan.json echo "Already published / skipped:" jq -r '.skippedPublished[]? | "- \(.packageName)@\(.version)"' .local/plugin-clawhub-release-plan.json - name: Fail manual publish when target versions already exist if: github.event_name == 'workflow_dispatch' && inputs.publish_scope == 'selected' && steps.plan.outputs.skipped_published_count != '0' run: | echo "::error::One or more selected plugin versions already exist on ClawHub. Bump the version before running a real publish." exit 1 preview_plugin_pack: needs: preview_plugins_clawhub if: needs.preview_plugins_clawhub.outputs.has_candidates == 'true' runs-on: ubuntu-latest permissions: contents: read strategy: fail-fast: false matrix: plugin: ${{ fromJson(needs.preview_plugins_clawhub.outputs.matrix) }} steps: - name: Checkout uses: actions/checkout@v6 with: ref: ${{ needs.preview_plugins_clawhub.outputs.ref_sha }} fetch-depth: 1 - name: Setup Node environment uses: ./.github/actions/setup-node-env with: node-version: ${{ env.NODE_VERSION }} pnpm-version: ${{ env.PNPM_VERSION }} install-bun: "true" use-sticky-disk: "false" install-deps: "false" - name: Checkout ClawHub CLI source uses: actions/checkout@v6 with: repository: ${{ env.CLAWHUB_REPOSITORY }} ref: ${{ env.CLAWHUB_REF }} path: clawhub-source fetch-depth: 1 - name: Install ClawHub CLI dependencies working-directory: clawhub-source run: bun install --frozen-lockfile - name: Bootstrap ClawHub CLI run: | cat > "$RUNNER_TEMP/clawhub" <<'EOF' #!/usr/bin/env bash set -euo pipefail exec bun "$GITHUB_WORKSPACE/clawhub-source/packages/clawhub/src/cli.ts" "$@" EOF chmod +x "$RUNNER_TEMP/clawhub" echo "$RUNNER_TEMP" >> "$GITHUB_PATH" - name: Preview publish command env: CLAWHUB_REGISTRY: ${{ env.CLAWHUB_REGISTRY }} SOURCE_REPO: ${{ github.repository }} SOURCE_COMMIT: ${{ needs.preview_plugins_clawhub.outputs.ref_sha }} SOURCE_REF: ${{ github.ref }} PACKAGE_TAG: ${{ matrix.plugin.publishTag }} PACKAGE_DIR: ${{ matrix.plugin.packageDir }} run: bash scripts/plugin-clawhub-publish.sh --dry-run "${PACKAGE_DIR}" publish_plugins_clawhub: needs: [preview_plugins_clawhub, preview_plugin_pack] if: github.event_name == 'workflow_dispatch' && needs.preview_plugins_clawhub.outputs.has_candidates == 'true' runs-on: ubuntu-latest environment: clawhub-plugin-release permissions: contents: read id-token: write strategy: fail-fast: false matrix: plugin: ${{ fromJson(needs.preview_plugins_clawhub.outputs.matrix) }} steps: - name: Checkout uses: actions/checkout@v6 with: ref: ${{ needs.preview_plugins_clawhub.outputs.ref_sha }} fetch-depth: 1 - name: Setup Node environment uses: ./.github/actions/setup-node-env with: node-version: ${{ env.NODE_VERSION }} pnpm-version: ${{ env.PNPM_VERSION }} install-bun: "true" use-sticky-disk: "false" install-deps: "false" - name: Checkout ClawHub CLI source uses: actions/checkout@v6 with: repository: ${{ env.CLAWHUB_REPOSITORY }} ref: ${{ env.CLAWHUB_REF }} path: clawhub-source fetch-depth: 1 - name: Install ClawHub CLI dependencies working-directory: clawhub-source run: bun install --frozen-lockfile - name: Bootstrap ClawHub CLI run: | cat > "$RUNNER_TEMP/clawhub" <<'EOF' #!/usr/bin/env bash set -euo pipefail exec bun "$GITHUB_WORKSPACE/clawhub-source/packages/clawhub/src/cli.ts" "$@" EOF chmod +x "$RUNNER_TEMP/clawhub" echo "$RUNNER_TEMP" >> "$GITHUB_PATH" - name: Ensure version is not already published env: PACKAGE_NAME: ${{ matrix.plugin.packageName }} PACKAGE_VERSION: ${{ matrix.plugin.version }} CLAWHUB_REGISTRY: ${{ env.CLAWHUB_REGISTRY }} run: | set -euo pipefail encoded_name="$(node -e 'console.log(encodeURIComponent(process.env.PACKAGE_NAME ?? ""))')" encoded_version="$(node -e 'console.log(encodeURIComponent(process.env.PACKAGE_VERSION ?? ""))')" url="${CLAWHUB_REGISTRY%/}/api/v1/packages/${encoded_name}/versions/${encoded_version}" status="$(curl --silent --show-error --output /dev/null --write-out '%{http_code}' "${url}")" if [[ "${status}" =~ ^2 ]]; then echo "${PACKAGE_NAME}@${PACKAGE_VERSION} is already published on ClawHub." exit 1 fi if [[ "${status}" != "404" ]]; then echo "Unexpected ClawHub response (${status}) for ${PACKAGE_NAME}@${PACKAGE_VERSION}." exit 1 fi - name: Publish env: CLAWHUB_REGISTRY: ${{ env.CLAWHUB_REGISTRY }} SOURCE_REPO: ${{ github.repository }} SOURCE_COMMIT: ${{ needs.preview_plugins_clawhub.outputs.ref_sha }} SOURCE_REF: ${{ github.ref }} PACKAGE_TAG: ${{ matrix.plugin.publishTag }} PACKAGE_DIR: ${{ matrix.plugin.packageDir }} run: bash scripts/plugin-clawhub-publish.sh --publish "${PACKAGE_DIR}"