openclaw-release-maintainer

Orchestrates OpenClaw stable and beta releases across npm publishing and macOS distribution.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill openclaw-release-maintainer-srgaba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-release-maintainer
Source: https://github.com/srgaba/open-claw/tree/main/project/.agents/skills/openclaw-release-maintainer
Command: npx skills add https://github.com/srgaba/open-claw --skill openclaw-release-maintainer-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting an OpenClaw release involves many coordinated steps—version alignment across multiple files, changelog-backed release notes, preflight validation, npm trusted publishing, and macOS signing/notarization—and missing any one of them can ship a broken or inconsistent release. This Skill encodes the full maintainer workflow so releases follow the correct sequence every time. ## Core Features & Use Cases - Release Channel Management: Enforces naming rules for stable, beta, and dev channels, including npm dist-tags and beta version suffixes like -beta.N. - Version & Changelog Alignment: Ensures every version location (package.json, iOS/macOS plists, Android gradle, docs) matches the release tag, and builds user-facing release notes from CHANGELOG.md. - Publish-Time Validation: Runs release checks, install smoke tests, and post-publish verification against the npm registry before and after publishing. - Use Case: When preparing OpenClaw v2025.1.2-beta.1, use this Skill to align all version files, run preflight workflows (npm, public mac validation, private mac preflight), create the tag and prerelease, then dispatch the real publish runs and verify the uploaded zip, dmg, and dSYM assets. ## Quick Start Ask the agent to prepare and validate the OpenClaw release for a specific version tag, running all preflight checks before any publish step.

Frequently Asked Questions about openclaw-release-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cut an OpenClaw stable release?

Follow the documented release sequence: align all version locations to the target tag, update CHANGELOG.md, run full preflight including mac readiness, create and push the tag, then dispatch the npm and private mac publish workflows with required approvals. Verify npm and release artifacts afterward.

How are beta releases versioned and published to npm?

Beta releases use tags like vYYYY.M.D-beta.N with the npm dist-tag beta, preferring -beta.N suffixes over -1 or -2. The npm publish must use the matching beta version suffix so the plain version is not consumed or blocked.

Does pushing a git tag automatically publish the npm package?

No. The core openclaw npm publish is a manual workflow_dispatch run using GitHub trusted publishing. Creating or pushing a tag alone does not trigger any publish.

Can beta macOS releases update the production appcast.xml feed?

No. The shared production Sparkle feed at appcast.xml on main is stable-only. Beta mac releases may upload assets to the GitHub prerelease but must not replace the shared appcast.xml unless a separate beta feed exists.

What happens if a preflight check fails after tagging?

Fix the issue on a new commit, delete and recreate the tag and matching GitHub release from the fixed commit, then rerun all preflights from scratch. Old preflight results are never reused after the commit changes.

When should I use the local macOS publish fallback?

Use the local fallback only when CI/CD mac publishing is unavailable or broken. It runs scripts/package-mac-dist.sh and scripts/make_appcast.sh on a real Mac with local signing, notary, and Sparkle credentials configured.