OpenClawリリース手順：macOS環境での公開を完全ガイド

新しいソフトウェアをリリースする際、手動での確認作業や複雑なデプロイ手順に追われて、本来のコーディング時間が削られてしまうことはありませんか？OpenClawのリリースプロセスは、こうした開発者の負担を軽減し、信頼性の高いデプロイを実現するために設計されています。

OpenClawのリリース管理は、安定性と透明性を重視した運用フローを採用しています。本記事では、OpenClawのリリース方針と、開発者が知っておくべき手順について解説します。

バージョンの命名規則

OpenClawでは、一貫性を保つために明確なバージョン命名ルールを定めています。

安定版リリース: YYYY.M.D
- Git tag: vYYYY.M.D
安定版修正リリース: YYYY.M.D-N
- Git tag: vYYYY.M.D-N
ベータ版プレリリース: YYYY.M.D-beta.N
- Git tag: vYYYY.M.D-beta.N
月や日にゼロ埋めは行いません。
latest は現在推奨されている安定版のnpmリリースを指します。
beta は現在のベータ版インストールターゲットを指します。
安定版および安定版修正リリースは、デフォルトでnpmの beta に公開されます。リリース担当者は明示的に latest を指定するか、後から検証済みのベータ版ビルドを昇格させることができます。
すべてのOpenClawリリースは、npmパッケージとmacOSアプリを同時に提供します。

リリースサイクル

リリースは品質を最優先し、段階的なプロセスを踏むことで安全性を確保しています。

リリースはベータ版から先に進みます。
安定版は、最新のベータ版が検証された後にのみリリースされます。
詳細なリリース手順、承認プロセス、認証情報、およびリカバリに関する注意点は、メンテナーのみが参照可能です。

リリース前の事前チェック

リリース作業を安全に進めるため、各ステップで自動化されたチェックを実行します。

リリース前の事前チェックの前に pnpm check:test-types を実行し、TypeScriptのテストカバレッジを確保します。
事前チェックの前に pnpm check:architecture を実行し、アーキテクチャ境界のチェックが正常であることを確認します。
pnpm release:check の前に pnpm build && pnpm ui:build を実行し、必要な dist/* リリースアーティファクトとControl UIバンドルが存在することを確認します。
タグ付けされたすべてのリリースの前に pnpm release:check を実行します。
リリースチェックは、個別の手動ワークフロー OpenClaw Release Checks で実行されるようになりました。
OSをまたいだインストールおよびアップグレードのランタイム検証は、プライベートな呼び出し元ワークフロー openclaw/releases-private/.github/workflows/openclaw-cross-os-release-checks.yml からディスパッチされ、再利用可能なパブリックワークフロー .github/workflows/openclaw-cross-os-release-checks-reusable.yml を呼び出します。
この分割は意図的なもので、実際のnpmリリースパスを短く決定論的に保ちつつ、低速なライブチェックを別のレーンで実行することで、公開プロセスをブロックしないようにしています。
リリースチェックは、ワークフローロジックとシークレットを維持するために、main ワークフロー参照からディスパッチする必要があります。
そのワークフローは、既存のリリースタグまたは現在の40文字の完全な main コミットSHAを受け入れます。
コミットSHAモードでは、現在の origin/main HEADのみを受け入れます。古いリリースコミットにはリリースタグを使用してください。
OpenClaw NPM Release の検証専用事前チェックも、タグをプッシュすることなく、現在の40文字の完全な main コミットSHAを受け入れます。
そのSHAパスは検証専用であり、実際の公開に昇格させることはできません。
SHAモードでは、ワークフローはパッケージメタデータチェックのためにのみ v<package.json version> を合成します。実際の公開には、本物のリリースタグが必要です。
両方のワークフローは、実際の公開と昇格パスをGitHubホスト型のランナーで維持し、非変異的な検証パスはより大きなBlacksmith Linuxランナーを使用できます。
そのワークフローは、OPENAI_API_KEY および ANTHROPIC_API_KEY ワークフローシークレットを使用して、以下のコマンドを実行します。

OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_CACHE_TEST=1 pnpm test:live:cache

npmリリースの事前チェックは、個別のリリースチェックレーンを待機しなくなりました。
承認の前に、以下のコマンドを実行します。

RELEASE_TAG=vYYYY.M.D node --import tsx scripts/openclaw-npm-release-check.ts

npm公開後、公開されたレジストリのインストールパスを新しい一時プレフィックスで検証するために、以下のコマンドを実行します。

node --import tsx scripts/openclaw-npm-postpublish-verify.ts YYYY.M.D

メンテナーのリリース自動化では、事前チェック後に昇格させるフローを使用します。
安定版のmacOSリリース準備には、アップデーターの確認も含まれます。

NPMワークフローの入力

ワークフローを制御するために、以下の入力パラメータを使用します。

tag: v2026.4.2、v2026.4.2-1、v2026.4.2-beta.1 などの必須リリースタグ。preflight_only=true の場合、検証専用の事前チェックとして現在の40文字の完全な main コミットSHAも使用可能です。
preflight_only: 検証、ビルド、パッケージ化のみの場合は true、実際の公開パスの場合は false。
preflight_run_id: 実際の公開パスで必須。ワークフローが事前チェックで準備されたtarballを再利用するために使用します。
npm_dist_tag: 公開パスのnpmターゲットタグ。デフォルトは beta です。

ルール:

安定版および修正タグは beta または latest に公開できます。
ベータ版プレリリースは beta にのみ公開できます。
完全なコミットSHA入力は preflight_only=true の場合のみ許可されます。
リリースチェックのコミットSHAモードでは、現在の origin/main HEADも必要です。
実際の公開パスは、事前チェック中に使用されたものと同じ npm_dist_tag を使用する必要があります。ワークフローは公開前にそのメタデータを検証します。

安定版npmリリースの手順

安定版npmリリースを作成する際は、以下のステップに従ってください。

preflight_only=true を指定して OpenClaw NPM Release を実行します。タグが存在する前は、現在の完全な main コミットSHAを使用して事前チェックワークフローのドライランが可能です。
通常のベータ版先行フローの場合は npm_dist_tag=beta を選択し、直接安定版を公開したい場合のみ latest を選択します。
ライブプロンプトキャッシュのカバーが必要な場合は、同じタグまたは現在の完全な main コミットSHAを使用して、OpenClaw Release Checks を個別に実行します。これは、長期実行や不安定なチェックを公開ワークフローと切り離すために意図的に分離されています。
成功した preflight_run_id を保存します。
preflight_only=false、同じ tag、同じ npm_dist_tag、および保存した preflight_run_id を指定して、再度 OpenClaw NPM Release を実行します。
リリースが beta に着地した場合は、プライベートリポジトリの openclaw/releases-private/.github/workflows/openclaw-npm-dist-tags.yml ワークフローを使用して、その安定版を beta から latest に昇格させます。
意図的に latest に直接公開し、beta も直ちに同じ安定版ビルドに追従させる必要がある場合は、同じプライベートワークフローを使用して両方のdist-tagを安定版に向けさせるか、スケジュールされた自己修復同期によって後で beta を移動させます。

dist-tagの変更は、パブリックリポジトリがOIDCのみの公開を維持する一方で、NPM_TOKEN を必要とするため、セキュリティ上の理由からプライベートリポジトリで行われます。

公開リファレンス

詳細な実装やスクリプトについては、以下のリポジトリを参照してください。

メンテナーは、実際の実行手順として openclaw/maintainers/release/README.md のプライベートリリースドキュメントを使用します。

さらに詳しいサポートが必要な場合は、AI Setup Assistant をご利用ください。

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。