> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# リリースパフォーマンススイープ

このページは、2026年5月の OpenClaw のパフォーマンス、
パッケージサイズ、依存関係、shrinkwrap クリーンアップの根拠をまとめたものです。公開ブログ記事の技術的な補足資料です。

ここでは2つの監査を組み合わせています。

* **リリースパフォーマンススイープ:** `v2026.5.28` から安定版
  `v2026.4.23` までの GitHub Releases。`OpenClaw Performance` ワークフロー、
  `profile=smoke`、モックプロバイダーレーンを使用。ほとんどのタグ行は1サンプルです。
  `v2026.5.27` と `v2026.5.28` の行は、最新の repeat-3 リリースブランチ
  アーティファクトを使用しています。
* **4月初旬のコンテキスト:** `v2026.4.1` から `v2026.5.2` までの公開済み
  `clawgrit-reports` モックプロバイダーベースライン。4月下旬の壊れたリリースを
  公開パフォーマンスベースラインとして扱わないためにのみ使用しています。
* **インストールフットプリントスイープ:** 一時パッケージに新規
  `npm install --ignore-scripts` インストールを行い、サイズには
  `du -sk node_modules`、パッケージインスタンス数には `node_modules` の走査を使用。
* **npm パッケージサイズスイープ:** 公開済みリリースに対して
  `npm pack openclaw@<version> --dry-run --json` を実行し、圧縮 tarball サイズ、
  展開後サイズ、ファイル数を記録。

<Warning>
  メインのパフォーマンススイープは、タグごとに1つの smoke サンプルを使用しています。ただし、
  `v2026.5.27` と `v2026.5.28` の行は、最新の repeat-3
  リリースブランチアーティファクトを使用しています。4月初旬のコンテキストは、
  `clawgrit-reports` の公開済み repeat-3 中央値を使用しています。これらの数値は、
  リリースゲート統計ではなく、傾向の根拠とリグレッション探索のシグナルとして扱ってください。
</Warning>

## スナップショット

パフォーマンスカバレッジ: **77件のリクエスト済みリリース**、**74件のアーティファクト裏付け済みポイント**、
**3件の利用できない CI 実行**。測定済みの最新安定版ポイント: `v2026.5.28`。

<CardGroup cols={2}>
  <Card title="Stable agent turn" icon="gauge">
    **コールドターンが5.1倍高速化**

    * `v2026.4.14`: 9.8秒
    * `v2026.5.28`: 1.9秒
  </Card>

  <Card title="Published package" icon="package">
    **17.9MB tarball**

    最新安定版パッケージ。3月のパッケージサイズのピークである43.3MBから減少。
  </Card>

  <Card title="Latest stable install" icon="hard-drive">
    **361.7MiB の新規インストール**

    `v2026.5.28` はネストされた OpenClaw 依存関係ツリーを大幅に削減していますが、
    ローカルインストール監査では、より小さい259.7MiBのネストツリーがまだ残っています。
  </Card>

  <Card title="Dependency graph" icon="boxes">
    **300個のインストール済みパッケージ**

    最新安定版リリース。スクリプトを無効にした新規インストールで、一意なパッケージ名/バージョンのルートとして測定。
  </Card>
</CardGroup>

## インストールフットプリントのタイムライン

<CardGroup cols={2}>
  <Card title="Monthly high" icon="triangle-alert">
    **645個の依存関係**

    `2026.2.26` は、このサンプルにおける月間の依存関係数の最高値でした。
  </Card>

  <Card title="Shrinkwrap introduced" icon="lock">
    **1,020.6MB のインストール**

    `2026.5.22` はルート shrinkwrap を追加し、パッケージ形状の問題を明らかにしました:
    911.8MB がネストされた `openclaw/node_modules` 配下に配置されました。
  </Card>

  <Card title="Latest stable" icon="tag">
    **361.7MiB のインストール**

    `2026.5.28` は `2026.5.27` から新規インストールサイズを52.8%削減していますが、
    259.7MiB のネストされた OpenClaw ツリーをまだインストールします。
  </Card>

  <Card title="Dependency graph" icon="scissors">
    **300個のパッケージルート**

    `2026.5.28` は `2026.5.27` より、一意なパッケージ名/バージョンのルートを71個少なくインストールします。
  </Card>
</CardGroup>

<Tip>
  shrinkwrap 自体が問題だったわけではありません。問題だったのは悪いパッケージ形状です。
  `v2026.5.28` も shrinkwrap を同梱していますが、ローカル監査ではネストされた依存関係ツリーははるかに小さくなり、
  全プラットフォーム向け canvas のファンアウトもなくなっています。
</Tip>

## 5.28で変わったこと

`v2026.5.27` から `v2026.5.28` の間のクリーンアップでは、機能そのものを削除するのではなく、デフォルトインストールのグラフを縮小しました。

<CardGroup cols={2}>
  <Card title="ルートのデフォルトグラフ" icon="git-branch">
    一意のパッケージ名/バージョンのルートは **371** から **300** に減少しました。パッケージインスタンスは **372** から **301** に減少しました。
  </Card>

  <Card title="ネストされたツリー" icon="unplug">
    同じローカルインストール監査で、ネストされた `openclaw/node_modules` は **656.1MiB** から **259.7MiB** に減少しました。
  </Card>

  <Card title="ネイティブのオプションコーン" icon="cpu">
    全プラットフォーム向けの `@napi-rs/canvas` ネイティブパッケージコーンは、デフォルトインストールに入らなくなりました。
  </Card>

  <Card title="サプライチェーン面" icon="shield">
    デフォルトパッケージが少ないほど、デフォルトで信頼する必要がある tarball、メンテナー、ネイティブバイナリ、インストール時の挙動、推移的な更新経路も少なくなります。
  </Card>
</CardGroup>

## 主な数値

4月下旬の壊れた行を公開パフォーマンスのベースラインとして使用しないでください。`v2026.4.23` と `v2026.4.29` は回帰の証拠として有用ですが、大きな `14x` 形式の差分は主に不良リリースラインからの回復を示しています。

ブログの説明では、規模感として4月前半に公開されたベースラインを使用してください。

| 指標            | 4月前半のベースライン | `v2026.5.28` |              差分 |
| ------------- | ----------: | -----------: | --------------: |
| コールドエージェントターン |     9,819ms |      1,908ms | 80.6% 低下、5.1倍高速 |
| ウォームエージェントターン |     7,458ms |      1,870ms | 74.9% 低下、4.0倍高速 |
| エージェントピークRSS  |     686.2MB |      581.0MB |        15.3% 低下 |

4月前半のベースラインは、公開された `clawgrit-reports` のモックプロバイダー実行に含まれる `v2026.4.14` です。この実行は repeat 3 を使用し、診断タイムラインが出力されなかったためにのみ失敗しました。コールド、ウォーム、RSS の中央値は、概算の規模感としてはまだ有用です。これはリリースゲート統計ではなく、説明用の文脈として扱ってください。

5月の一連の作業では、最新のリリースブランチ行が `v2026.5.2` から大きく改善しました。

| 指標            | `v2026.5.2` | `v2026.5.28` |       差分 |
| ------------- | ----------: | -----------: | -------: |
| コールドエージェントターン |     3,897ms |      1,908ms | 51.0% 低下 |
| ウォームエージェントターン |     3,610ms |      1,870ms | 48.2% 低下 |
| エージェントピークRSS  |     613.7MB |      581.0MB |  5.3% 低下 |

前回の安定版リリースとの比較:

| 指標            | `v2026.5.27` | `v2026.5.28` |       差分 |
| ------------- | -----------: | -----------: | -------: |
| コールドエージェントターン |      2,231ms |      1,908ms | 14.5% 低下 |
| ウォームエージェントターン |      2,226ms |      1,870ms | 16.0% 低下 |
| エージェントピークRSS  |      649.0MB |      581.0MB | 10.5% 低下 |

### インストールフットプリント

| 指標                                            |    ベースライン | `v2026.5.28` |       差分 |
| --------------------------------------------- | --------: | -----------: | -------: |
| `2026.5.22` ピークからのインストールサイズ                   | 1,020.6MB |     361.7MiB | 64.6% 低下 |
| 最新リリース `2026.5.27` からのインストールサイズ               |  767.1MiB |     361.7MiB | 52.8% 低下 |
| 月間最高値 `2026.2.26` からの依存関係                     |       645 |          300 | 53.5% 低下 |
| 最新リリース `2026.5.27` からの依存関係                    |       371 |          300 | 19.1% 低下 |
| `2026.5.22` からのネストされた `openclaw/node_modules` |   911.8MB |     259.7MiB | 71.5% 低下 |
| `2026.5.27` からのネストされた `openclaw/node_modules` |  656.1MiB |     259.7MiB | 60.4% 低下 |

### npmパッケージサイズ

| バージョン       | 圧縮tarball | 展開後パッケージ |  ファイル数 | 注記                     |
| ----------- | --------: | -------: | -----: | ---------------------- |
| `2026.1.30` |    12.8MB |   33.5MB |  4,607 | 初期のリブランド済みパッケージ        |
| `2026.2.26` |    23.6MB |   82.9MB | 10,125 | 機能の増加                  |
| `2026.3.31` |    43.3MB |  182.6MB | 21,037 | パッケージサイズの最高点           |
| `2026.4.29` |    22.9MB |   74.6MB |  9,309 | パッケージ剪定が見える状態          |
| `2026.5.12` |    23.4MB |   80.1MB | 12,035 | 大規模な外部Plugin分離         |
| `2026.5.22` |    17.2MB |   76.9MB | 12,386 | docs/assets をパッケージから除外 |
| `2026.5.27` |    17.8MB |   79.0MB | 12,509 | 前回の安定版パッケージ            |
| `2026.5.28` |    17.9MB |   81.0MB |  9,082 | 最新の安定版パッケージ            |

`2026.5.12` は、changelog 上で見える Plugin 抽出のマイルストーンです。Amazon Bedrock、Bedrock Mantle、Slack、OpenShell sandbox、Anthropic Vertex、Matrix、WhatsApp はコア依存関係パスから移動し、それらの依存関係コーンはすべてのコアインストールではなく、それらの Plugin と一緒にインストールされるようになりました。

## Kovaエージェントターンの概要

4月の安定版ラインには2つの異なる話があります。4月前半は遅いものの認識可能な状態でした。4月下旬は回帰の崖になりました。`v2026.5.2` は、モックプロバイダーのレーンが初めて3-5秒台に下がり、提供された一連の測定で一貫して成功し始めた地点です。

以前に公開された文脈:

| リリース         | Kova |  コールドターン |  ウォームターン | エージェントピークRSS |
| ------------ | ---- | -------: | -------: | -----------: |
| `v2026.4.10` | 失敗   | 11,031ms |  7,962ms |      679.0MB |
| `v2026.4.12` | 失敗   | 11,965ms |  8,289ms |      713.5MB |
| `v2026.4.14` | 失敗   |  9,819ms |  7,458ms |      686.2MB |
| `v2026.4.20` | 失敗   | 22,314ms | 18,811ms |      810.8MB |
| `v2026.4.22` | 失敗   |  9,630ms |  7,459ms |      743.0MB |

提供された一連の測定:

| リリース                | Kova |  コールドターン |  ウォームターン | エージェントピークRSS |
| ------------------- | ---- | -------: | -------: | -----------: |
| `v2026.4.23`        | 失敗   | 47,847ms |  8,010ms |    1,082.7MB |
| `v2026.4.24`        | 失敗   | 48,264ms | 25,483ms |      996.0MB |
| `v2026.4.25`        | 失敗   | 81,080ms | 59,172ms |    1,113.9MB |
| `v2026.4.26`        | 失敗   | 76,771ms | 54,941ms |    1,140.8MB |
| `v2026.4.27`        | 失敗   | 60,902ms | 33,699ms |    1,156.0MB |
| `v2026.4.29`        | 失敗   | 94,031ms | 57,334ms |    3,613.7MB |
| `v2026.5.2`         | 成功   |  3,897ms |  3,610ms |      613.7MB |
| `v2026.5.7`         | 成功   |  3,923ms |  3,693ms |      654.1MB |
| `v2026.5.12`        | 成功   |  7,248ms |  6,629ms |      834.8MB |
| `v2026.5.18`        | 成功   |  3,301ms |  2,913ms |      630.3MB |
| `v2026.5.20`        | 成功   |  3,413ms |  2,952ms |      643.2MB |
| `v2026.5.22`        | 成功   |  4,494ms |  4,093ms |      654.3MB |
| `v2026.5.26`        | 成功   |  2,626ms |  2,282ms |      660.4MB |
| `v2026.5.27-beta.1` | 成功   |  2,575ms |  2,217ms |      635.3MB |
| `v2026.5.27`        | 成功   |  2,231ms |  2,226ms |      649.0MB |
| `v2026.5.28`        | 成功   |  1,908ms |  1,870ms |      581.0MB |

## ソースプローブ

必要なプローブエントリポイントがそれらのソースツリーにまだ存在しなかったため、成功した17件の古い ref ではソースプローブをスキップしました。これらの ref についてもエージェントターン指標は存在します。

代表的なソースプローブ地点:

| リリース                | デフォルト `readyz` p50 | 50個のPlugin `readyz` p50 | CLIヘルス p50 | Plugin最大RSS |
| ------------------- | -----------------: | ----------------------: | ---------: | ----------: |
| `v2026.4.29`        |            2,819ms |                 2,618ms |    1,679ms |     389.0MB |
| `v2026.5.2`         |            2,324ms |                 2,013ms |    1,384ms |     377.2MB |
| `v2026.5.7`         |            1,649ms |                 1,540ms |    1,175ms |     387.6MB |
| `v2026.5.18`        |            1,942ms |                 1,927ms |      607ms |     426.5MB |
| `v2026.5.20`        |            1,966ms |                 1,987ms |      621ms |     455.0MB |
| `v2026.5.22`        |            2,081ms |                 1,884ms |    5,095ms |     444.2MB |
| `v2026.5.26`        |            1,546ms |                 1,634ms |      656ms |     400.4MB |
| `v2026.5.27-beta.1` |            1,462ms |                 1,548ms |      548ms |     394.0MB |
| `v2026.5.27`        |            1,491ms |                 1,571ms |      553ms |     401.5MB |
| `v2026.5.28`        |            1,457ms |                 1,474ms |      623ms |     386.1MB |

`v2026.5.22` CLI ヘルススパイクは、agent-turn レーンがまだ通過していたにもかかわらず、この表で確認できます。対象を絞った CLI または gateway のリグレッションを調査するときは、ソースプローブを維持してください。

## インストールフットプリント監査

依存関係サンプルは、月ごとに 1 つの安定版リリースに加えて、`2026.5.22` の shrinkwrap 導入イベントと最新の `2026.5.28` リリースを使用します。

| ポイント           | インストール済み依存関係 | フレッシュインストール | OpenClaw パッケージ | ネストされた `openclaw/node_modules` | ルート shrinkwrap | Canvas インストール動作                       |
| -------------- | -----------: | ----------: | -------------: | -----------------------------: | -------------- | ------------------------------------- |
| 1月 `2026.1.30` |          605 |     438.4MB |         45.8MB |                          2.4MB | いいえ            | トップレベルラッパー + `darwin-arm64`           |
| 2月 `2026.2.26` |          645 |     575.7MB |        110.1MB |                          3.5MB | いいえ            | トップレベルラッパー + `darwin-arm64`           |
| 3月 `2026.3.31` |          438 |     584.1MB |        234.8MB |                            0MB | いいえ            | トップレベルラッパー + `darwin-arm64`           |
| 4月 `2026.4.29` |          392 |     335.0MB |         97.4MB |                            0MB | いいえ            | インストールなし                              |
| `2026.5.22`    |          401 |   1,020.6MB |      1,020.4MB |                        911.8MB | はい             | ネスト: 12 個すべての `@napi-rs/canvas` パッケージ |
| 5月 `2026.5.26` |          371 |     767.5MB |        767.4MB |                        656.4MB | はい             | ネスト: 12 個すべての `@napi-rs/canvas` パッケージ |
| `2026.5.27`    |          371 |    767.1MiB |       766.9MiB |                       656.1MiB | はい             | ネスト: 12 個すべての `@napi-rs/canvas` パッケージ |
| 最新 `2026.5.28` |          300 |    361.7MiB |       361.6MiB |                       259.7MiB | はい             | インストールなし                              |

### Shrinkwrap 境界

<CardGroup cols={2}>
  <Card title="Shrinkwrap 前" icon="unlock">
    `2026.5.20` にはルート shrinkwrap がなく、大規模なネストされた OpenClaw 依存関係ツリーもありません。
  </Card>

  <Card title="導入" icon="lock">
    `2026.5.22` はルート shrinkwrap を追加し、ネストされた `openclaw/node_modules` の下に 911.8MB をインストールします。
  </Card>

  <Card title="最新の安定版" icon="tag">
    `2026.5.28` は shrinkwrap を維持し、ネストされた `openclaw/node_modules` の下にまだ 259.7MiB をインストールします。
  </Card>

  <Card title="Canvas ファンアウト修正済み" icon="check">
    `2026.5.28` は、ローカルのフレッシュインストール監査で `@napi-rs/canvas` パッケージを一切インストールしなくなりました。
  </Card>
</CardGroup>

公開 tarball の検査で境界が確認されています。

| バージョン       | 公開済み安定版? | ルート `npm-shrinkwrap.json` | メモ                      |
| ----------- | -------- | ------------------------- | ----------------------- |
| `2026.5.20` | はい       | いいえ                       | shrinkwrap 前の最後の安定版リリース |
| `2026.5.21` | いいえ      | n/a                       | 安定版 npm リリースなし          |
| `2026.5.22` | はい       | はい                        | shrinkwrap 導入           |
| `2026.5.23` | いいえ      | n/a                       | 安定版 npm リリースなし          |
| `2026.5.24` | いいえ      | n/a                       | 安定版 npm リリースなし          |
| `2026.5.25` | いいえ      | n/a                       | 安定版 npm リリースなし          |
| `2026.5.26` | はい       | はい                        | ネストされた依存関係ツリーはまだ存在      |
| `2026.5.27` | はい       | はい                        | ネストされた依存関係ツリーはまだ存在      |
| `2026.5.28` | はい       | はい                        | ネストされた依存関係ツリーは大幅に縮小     |

重要な違い: **shrinkwrap 自体が問題ではありません**。`v2026.5.28` はまだルート shrinkwrap を同梱しています。問題は、npm が大規模なネストされた OpenClaw 依存関係ツリーと 12 個すべての `@napi-rs/canvas` プラットフォームパッケージを実体化するパッケージ形状でした。ネストされたツリーは `v2026.5.28` で小さくなり、canvas プラットフォームのファンアウトはローカル監査に現れなくなりました。

shrinkwrap とメンテナーレベルのパッケージチェックについての平易な説明は、[npm shrinkwrap](/ja-JP/gateway/security/shrinkwrap) を参照してください。

## サプライチェーンの解釈

依存関係数は、インストールサイズの指標であるだけでなく、運用上のセキュリティ指標でもあります。各パッケージは、オペレーターが信頼しなければならないメンテナー、tarball、推移的更新、任意のネイティブバイナリ、インストール時の動作の集合を広げます。

クリーンアップの方向性は次のとおりです。

* 重量級で任意の機能をデフォルトのコアインストールの外に保つ
* Plugin パッケージが自身のランタイム依存関係グラフを所有するようにする
* Gateway 起動中のランタイムパッケージマネージャー修復を避ける
* 全プラットフォームのネイティブパッケージの実体化を引き起こさずに、決定論的インストールを維持する
* パッケージ受け入れと測定パスではインストールスクリプトを無効のままにする
* 公開前に、ネストされた依存関係ツリーとネイティブ任意依存関係の爆発を検出する

関連ドキュメント:

* [Plugin 依存関係解決](/ja-JP/plugins/dependency-resolution)
* [Plugin インベントリ](/ja-JP/plugins/plugin-inventory)
* [完全リリース検証](/ja-JP/reference/full-release-validation)
