chore(i18n): refresh ja-JP translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-14 04:44:10 +00:00
parent 1f2baa9bc6
commit daf1570465

View File

@ -1,14 +1,14 @@
---
read_when:
- 公開リリースチャネルの定義を探していま
- バージョン命名とリリース頻度を探していま
summary: 公開リリースチャネル、バージョン命名、リリース頻度
- 公開リリースチャネルの定義を探す
- バージョン命名とリリース頻度を探す
summary: 公開リリースチャネル、バージョン命名、およびリリース頻度
title: リリースポリシー
x-i18n:
generated_at: "2026-04-14T02:08:47Z"
generated_at: "2026-04-14T04:43:21Z"
model: gpt-5.4
provider: openai
source_hash: fdc32839447205d74ba7a20a45fbac8e13b199174b442a1e260e3fce056c63da
source_hash: 3eaf9f1786b8c9fd4f5a9c657b623cb69d1a485958e1a9b8f108511839b63587
source_path: reference/RELEASING.md
workflow: 15
---
@ -17,136 +17,159 @@ x-i18n:
OpenClaw には 3 つの公開リリースレーンがあります。
- stable: デフォルトでは npm の `beta` に公開されるタグ付きリリース、または明示的に指定された場合は npm の `latest` に公開
- stable: タグ付きリリースで、デフォルトでは npm の `beta` に公開され、明示的に要求された場合は npm の `latest` に公開されます
- beta: npm の `beta` に公開されるプレリリースタグ
- dev: `main` の移動する先頭
## バージョン命名
- Stable リリースバージョン: `YYYY.M.D`
- stable リリースのバージョン: `YYYY.M.D`
- Git タグ: `vYYYY.M.D`
- Stable 修正リリースバージョン: `YYYY.M.D-N`
- stable 修正リリースのバージョン: `YYYY.M.D-N`
- Git タグ: `vYYYY.M.D-N`
- Beta プレリリースバージョン: `YYYY.M.D-beta.N`
- beta プレリリースのバージョン: `YYYY.M.D-beta.N`
- Git タグ: `vYYYY.M.D-beta.N`
- 月や日はゼロ埋めしない
- `latest`現在昇格済みの stable npm リリースを意味す
- `beta`現在の beta インストール対象を意味す
- Stable および stable 修正リリースは、デフォルトで npm の `beta` に公開される。リリース運用者は明示的に `latest` を指定することもでき、検証済みの beta ビルドを後で昇格させることもできる
- すべての OpenClaw リリースでは、npm パッケージと macOS アプリが一緒に出荷され
- 月や日はゼロ埋めしないでください
- `latest` は現在昇格済みの stable npm リリースを意味しま
- `beta` は現在の beta インストール対象を意味しま
- stable および stable 修正リリースはデフォルトで npm の `beta` に公開されます。リリース運用者は明示的に `latest` を対象にすることも、検証済みの beta ビルドを後で昇格させることもできます
- すべての OpenClaw リリースでは、npm パッケージと macOS アプリが一緒に出荷されます
## リリース頻度
- リリースは beta-first で進
- Stable は、最新の beta が検証された後にのみ続く
- リリースは beta-first で進みます
- stable は最新の beta が検証された後にのみ続きます
- 詳細なリリース手順、承認、認証情報、復旧メモは
maintainers 限定
maintainer 限定です
## リリース事前確認
- pack 検証ステップで必要な `dist/*` リリースアーティファクトと Control UI バンドルが存在するように、`pnpm release:check` の前に `pnpm build && pnpm ui:build` を実行する
- すべてのタグ付きリリースの前に `pnpm release:check` を実行する
- リリースチェックは現在、別の手動ワークフローで実行される:
- pack
検証ステップで期待される `dist/*` のリリース成果物と Control UI バンドルが存在するように、`pnpm release:check` の前に `pnpm build && pnpm ui:build` を実行してください
- すべてのタグ付きリリースの前に `pnpm release:check` を実行してください
- リリースチェックは現在、別個の手動ワークフローで実行されます:
`OpenClaw Release Checks`
- この分離は意図的なもの: 実際の npm リリース経路を短く、決定的で、アーティファクト重視に保ちつつ、より遅いライブチェックは独自のレーンに置き、公開を遅延またはブロックしないようにする
- ワークフローロジックと secrets を正統なものに保つため、このリリースチェックは `main` ワークフロー ref から起動する必要がある
- このワークフローは、既存のリリースタグまたは現在の完全な 40 文字の `main` コミット SHA のどちらかを受け付ける
- コミット SHA モードでは、現在の `origin/main` HEAD のみを受け付ける。古いリリースコミットにはリリースタグを使う
- `OpenClaw NPM Release` の検証専用事前確認も、プッシュ済みタグを必要とせずに、現在の完全な 40 文字の `main` コミット SHA を受け付ける
- その SHA パスは検証専用であり、実際の公開には昇格できない
- SHA モードでは、ワークフローはパッケージメタデータ確認のためにのみ `v<package.json version>` を合成する。実際の公開には引き続き実際のリリースタグが必要
- 両方のワークフローは、実際の公開および昇格経路を GitHub ホストランナー上に維持しつつ、変更を伴わない検証経路ではより大きな Blacksmith Linux ランナーを使用できる
- この分離は意図的なものです。実際の npm リリース経路を短く、
決定的で、成果物重視のものに保ちながら、低速なライブチェックは
独自のレーンに分離し、公開を停滞またはブロックしないようにします
- リリースチェックは `main` のワークフロー ref からディスパッチする必要があります。これにより、
ワークフローロジックとシークレットが正規のものに保たれます
- そのワークフローは、既存のリリースタグまたは現在の完全な
40 文字の `main` コミット SHA のいずれかを受け付けます
- コミット SHA モードでは、現在の `origin/main` HEAD のみを受け付けます。古いリリースコミットには
リリースタグを使用してください
- `OpenClaw NPM Release` の検証専用事前確認でも、プッシュ済みタグを必要とせずに現在の完全な 40 文字の `main` コミット SHA を受け付けます
- その SHA パスは検証専用であり、実際の公開に昇格することはできません
- SHA モードでは、ワークフローはパッケージメタデータチェックのためにのみ `v<package.json version>` を合成します。実際の公開には依然として実際のリリースタグが必要です
- 両方のワークフローは、実際の公開および昇格経路を GitHub-hosted
ランナー上に維持しつつ、変更を伴わない検証経路ではより大きな
Blacksmith Linux ランナーを使用できます
- そのワークフローは
`OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_CACHE_TEST=1 pnpm test:live:cache`
`OPENAI_API_KEY``ANTHROPIC_API_KEY` の両方のワークフロー secrets を使って実行する
- npm リリース事前確認は、別のリリースチェックレーンを待たなくなった
- 承認前に `RELEASE_TAG=vYYYY.M.D node --import tsx scripts/openclaw-npm-release-check.ts`
(または対応する beta/修正タグ)を実行する
- npm 公開後に、
を、`OPENAI_API_KEY` と `ANTHROPIC_API_KEY` の両方のワークフローシークレットを使用して実行します
- npm リリース事前確認は、別個のリリースチェックレーンを待たなくなりました
- 承認前に
`RELEASE_TAG=vYYYY.M.D node --import tsx scripts/openclaw-npm-release-check.ts`
(または対応する beta/修正タグ)を実行してください
- npm 公開後、公開されたレジストリの
インストール経路を新しい一時プレフィックスで検証するために、
`node --import tsx scripts/openclaw-npm-postpublish-verify.ts YYYY.M.D`
(または対応する beta/修正バージョン)を実行し、新しい一時 prefix で公開済みレジストリのインストール経路を検証する
- Maintainer のリリース自動化は現在、事前確認してから昇格する方式を使う:
- 実際の npm 公開は、成功した npm `preflight_run_id` を通過していなければならない
- stable npm リリースのデフォルトは `beta`
- stable npm 公開では、ワークフロー入力により明示的に `latest` を指定できる
- stable npm の `beta` から `latest` への昇格は、信頼された `OpenClaw NPM Release` ワークフロー上の明示的な手動モードとして引き続き利用可能
- 直接 stable 公開では、すでに公開済みの stable バージョンに `latest``beta` の両方を向ける明示的な dist-tag 同期モードも実行できる
- それらの dist-tag モードでも、npm の `dist-tag` 管理は信頼された公開とは別であるため、`npm-release` 環境に有効な `NPM_TOKEN` が引き続き必要
- 公開の `macOS Release` は検証専用
- 実際の非公開 mac 公開は、成功した非公開 mac の
`preflight_run_id``validate_run_id` を通過していなければならない
- 実際の公開経路では、アーティファクトを再ビルドせず、準備済みアーティファクトを昇格する
- `YYYY.M.D-N` のような stable 修正リリースでは、公開後検証器は `YYYY.M.D` から `YYYY.M.D-N` への同じ一時 prefix アップグレード経路も確認する。これにより、古いグローバルインストールがベースの stable ペイロードに静かに残ることを防ぐ
- npm リリース事前確認は、tarball に `dist/control-ui/index.html` と空でない `dist/control-ui/assets/` ペイロードの両方が含まれていない限り、fail closed する。これは空のブラウザダッシュボードを再び出荷しないため
- リリース作業が CI 計画、拡張機能タイミングマニフェスト、または拡張機能テストマトリクスに触れた場合は、承認前に `.github/workflows/ci.yml` から planner が管理する `checks-node-extensions` ワークフローマトリクス出力を再生成して確認する。これにより、リリースノートが古い CI レイアウトを説明しないようにする
- Stable macOS リリース準備には、アップデーター関連の面も含まれる:
- GitHub リリースには、パッケージ化された `.zip`、`.dmg`、`.dSYM.zip` が最終的に含まれていなければならない
- `main` 上の `appcast.xml` は、公開後に新しい stable zip を指していなければならない
- パッケージ化されたアプリは、デバッグではない bundle id、空でない Sparkle feed
URL、およびそのリリースバージョンに対する正規の Sparkle build floor 以上の `CFBundleVersion` を維持していなければならない
(または対応する beta/修正バージョン)を実行してください
- maintainer 向けリリース自動化は現在、事前確認してから昇格する方式を使用します:
- 実際の npm 公開は、成功した npm `preflight_run_id` に合格している必要があります
- stable npm リリースのデフォルトは `beta` です
- stable npm 公開は、ワークフロー入力で明示的に `latest` を対象にできます
- `beta` から `latest` への stable npm 昇格は、信頼済みの `OpenClaw NPM Release` ワークフロー上で明示的な手動モードとして引き続き利用できます
- 直接の stable 公開では、すでに公開済みの stable バージョンに `latest``beta` の両方を向ける明示的な dist-tag 同期モードも実行できます
- これらの dist-tag モードでも、npm の `dist-tag` 管理は信頼済み公開とは別であるため、`npm-release` 環境内の有効な `NPM_TOKEN` が引き続き必要です
- 公開の `macOS Release` は検証専用です
- 実際の private mac 公開は、成功した private mac の
`preflight_run_id``validate_run_id` に合格している必要があります
- 実際の公開経路では、準備済み成果物を再ビルドせずに昇格させます
- `YYYY.M.D-N` のような stable 修正リリースでは、公開後検証ツールは
`YYYY.M.D` から `YYYY.M.D-N` への同じ一時プレフィックスのアップグレード経路も確認するため、
リリース修正によって古いグローバルインストールが元の stable ペイロードのまま
気づかれず残ることはありません
- npm リリース事前確認は、tarball に `dist/control-ui/index.html` と空でない `dist/control-ui/assets/` ペイロードの両方が含まれていない限り fail closed になるため、
空のブラウザダッシュボードを再び出荷することはありません
- `pnpm test:install:smoke` は候補アップデート tarball の npm pack `unpackedSize` 予算も適用するため、
インストーラー E2E で公開経路の前に pack の意図しない肥大化を検出できます
- リリース作業で CI 計画、拡張タイミングマニフェスト、または
拡張テストマトリクスに触れた場合は、承認前に `.github/workflows/ci.yml` から planner が所有する
`checks-node-extensions` ワークフローマトリクス出力を再生成して確認してください。これによりリリースノートが古い CI レイアウトを説明することを防げます
- stable macOS リリースの準備完了には、アップデーター関連の面も含まれます:
- GitHub リリースには、パッケージ化された `.zip`、`.dmg`、および `.dSYM.zip` が含まれている必要があります
- `main` 上の `appcast.xml` は、公開後に新しい stable zip を指している必要があります
- パッケージ化されたアプリは、デバッグ以外の bundle id、空でない Sparkle feed
URL、およびそのリリースバージョンに対する正規の Sparkle build floor 以上の `CFBundleVersion` を維持する必要があります
## NPM ワークフロー入力
`OpenClaw NPM Release` は、運用者が制御する次の入力を受け付けます。
`OpenClaw NPM Release` は、以下の運用者制御入力を受け付けます。
- `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 を再利用す
`v2026.4.2-beta.1`。`preflight_only=true` の場合は、検証専用事前確認のために現在の完全な
40 文字の `main` コミット SHA も使用できます
- `preflight_only`: 検証/ビルド/パッケージのみの場合は `true`、実際の公開経路の場合`false`
- `preflight_run_id`: 実際の公開経路で必須です。これによりワークフローは成功した事前確認実行から準備済み tarball を再利用しま
- `npm_dist_tag`: 公開経路の npm 対象タグ。デフォルトは `beta`
- `promote_beta_to_latest`: `true` の場合、公開をスキップし、すでに公開済みの stable `beta` ビルドを `latest` に移動する
- `sync_stable_dist_tags`: `true` の場合、公開をスキップし、すでに公開済みの stable バージョンに `latest`
`beta` の両方を向ける
- `promote_beta_to_latest`: 公開をスキップし、すでに公開済みの
stable `beta` ビルドを `latest` に移動する場合は `true`
- `sync_stable_dist_tags`: 公開をスキップし、すでに公開済みの stable バージョンに `latest`
`beta` の両方を向ける場合は `true`
`OpenClaw Release Checks` は、運用者制御する次の入力を受け付けます。
`OpenClaw Release Checks` は、以下の運用者制御入力を受け付けます。
- `ref`: 検証対象の既存リリースタグ、または現在の完全な 40 文字の `main` コミット
- `ref`: 検証する既存のリリースタグ、または現在の完全な 40 文字の `main` コミット
SHA
ルール:
- Stable および修正タグは、`beta` または `latest` のどちらにも公開できる
- Beta プレリリースタグは `beta` にのみ公開できる
- 完全なコミット SHA 入力は `preflight_only=true` の場合にのみ許可され
- リリースチェックのコミット SHA モードでも、現在の `origin/main` HEAD が必要
- 実際の公開経路では、事前確認時と同じ `npm_dist_tag` を使用しなければならない
ワークフローは公開続行前にそのメタデータを検証す
- stable および修正タグは `beta` または `latest` のどちらにも公開できます
- beta プレリリースタグは `beta` にのみ公開できます
- 完全なコミット SHA 入力は `preflight_only=true` の場合にのみ許可されます
- リリースチェックのコミット SHA モードでも、現在の `origin/main` HEAD が必要です
- 実際の公開経路では、事前確認時に使用したものと同じ `npm_dist_tag` を使用する必要があります
ワークフローは公開続行する前にそのメタデータを検証しま
- 昇格モードでは、stable または修正タグ、`preflight_only=false`、
空の `preflight_run_id`、および `npm_dist_tag=beta` を使用しなければならない
空の `preflight_run_id`、および `npm_dist_tag=beta` を使用する必要があります
- dist-tag 同期モードでは、stable または修正タグ、
`preflight_only=false`、空の `preflight_run_id`、`npm_dist_tag=latest`、
および `promote_beta_to_latest=false` を使用しなければならない
- 昇格モードおよび dist-tag 同期モードでも、有効な `NPM_TOKEN` が必要。
`npm dist-tag add` には通常の npm 認証が引き続き必要であり、信頼された公開はパッケージ公開経路のみを対象とするため
および `promote_beta_to_latest=false` を使用する必要があります
- 昇格モードおよび dist-tag 同期モードでも、有効な `NPM_TOKEN` が必要です。これは
`npm dist-tag add` に通常の npm 認証が依然として必要であり、信頼済み公開は
パッケージ公開経路のみをカバーするためです
## Stable npm リリース手順
## stable npm リリース手順
Stable npm リリースを行う場合:
stable npm リリースを行うときは、次の手順に従います。
1. `preflight_only=true``OpenClaw NPM Release` を実行する
- タグがまだ存在しない場合は、事前確認ワークフローの検証専用ドライランのために、現在の完全な `main` コミット SHA を使用できる
2. 通常の beta-first フローでは `npm_dist_tag=beta` を選び、意図的に直接 stable 公開したい場合のみ `latest` を選ぶ
3. ライブの prompt cache カバレッジが必要な場合は、同じタグまたは
現在の完全な `main` コミット SHA を使って `OpenClaw Release Checks` を別途実行する
- これは意図的な分離であり、ライブカバレッジを利用可能にしたまま、
長時間実行または不安定なチェックを公開ワークフローに再結合しないため
4. 成功した `preflight_run_id` を保存する
1. `preflight_only=true``OpenClaw NPM Release` を実行します
- タグがまだ存在しない場合は、
事前確認ワークフローの検証専用ドライランとして現在の完全な `main` コミット SHA を使用できます
2. 通常の beta-first フローでは `npm_dist_tag=beta` を選択し、
意図的に stable を直接公開したい場合にのみ `latest` を選択します
3. ライブ prompt cache カバレッジが必要な場合は、同じタグまたは
現在の完全な `main` コミット SHA を指定して `OpenClaw Release Checks` を別途実行します
- これは意図的な分離です。これにより、長時間実行または不安定なチェックを公開ワークフローに再結合することなく、
ライブカバレッジを利用可能なまま維持できます
4. 成功した `preflight_run_id` を保存します
5. `preflight_only=false`、同じ
`tag`、同じ `npm_dist_tag`、保存した `preflight_run_id``OpenClaw NPM Release` を再度実行する
6. リリースが `beta` に入った場合、その
公開済みビルドを `latest` に移したいときは、後で同じ stable `tag`、`promote_beta_to_latest=true`、`preflight_only=false`、
空の `preflight_run_id`、および `npm_dist_tag=beta``OpenClaw NPM Release` を実行する
7. 意図的にリリースを直接 `latest` に公開し、`beta`
も同じ stable ビルドに合わせる必要がある場合は、同じ
`tag`、同じ `npm_dist_tag`、および保存した `preflight_run_id` を指定して、再度 `OpenClaw NPM Release` を実行します
6. リリースが `beta` に公開された場合は、その
公開済みビルドを `latest` に移動したいタイミングで、同じ stable `tag`
`promote_beta_to_latest=true`、`preflight_only=false`、
空の `preflight_run_id`、および `npm_dist_tag=beta` を指定して後で `OpenClaw NPM Release` を実行します
7. リリースが意図的に `latest` に直接公開され、`beta`
も同じ stable ビルドを指すべき場合は、同じ
stable `tag`、`sync_stable_dist_tags=true`、`promote_beta_to_latest=false`、
`preflight_only=false`、空の `preflight_run_id`、および `npm_dist_tag=latest` `OpenClaw NPM Release` を実行する
`preflight_only=false`、空の `preflight_run_id`、および `npm_dist_tag=latest` を指定して `OpenClaw NPM Release` を実行します
昇格モードおよび dist-tag 同期モードでも、`npm-release`
環境の承認と、そのワークフロー実行アクセス可能な有効な `NPM_TOKEN` が必要です。
環境の承認と、そのワークフロー実行からアクセス可能な有効な `NPM_TOKEN`引き続き必要です。
これにより、直接公開経路と beta-first 昇格経路の両方が
文書化され、運用者から見える形になります。
文書化され、運用者に見える形で維持されます。
## 公開リファレンス
@ -156,6 +179,6 @@ Stable npm リリースを行う場合:
- [`scripts/package-mac-dist.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-dist.sh)
- [`scripts/make_appcast.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/make_appcast.sh)
Maintainers は、実際の運用手順については
maintainer は、実際のランブックについて
[`openclaw/maintainers/release/README.md`](https://github.com/openclaw/maintainers/blob/main/release/README.md)
にある非公開のリリースドキュメントを使用します。
にある private のリリースドキュメントを使用します。