pnpm-lock.yaml。已發布的 OpenClaw npm
套件使用 npm-shrinkwrap.json,也就是 npm 可發布的相依性鎖定檔,因此
套件安裝會使用發行期間已審查的相依性圖。
簡易版
Shrinkwrap 是隨 npm 套件一起發布的相依性樹收據。 它會告訴 npm 要安裝哪些確切的遞移套件版本。 對 OpenClaw 發行版而言,這表示:- 已發布的套件不會要求 npm 在安裝時即時產生新的相依性圖;
- 相依性變更會更容易審查,因為它們會出現在鎖定檔中;
- 發行驗證可以測試使用者將會安裝的同一份相依性圖;
- 套件大小或原生相依性的意外情況更容易在發布前發現。
openclaw security audit、套件
來源證明,或安裝煙霧測試。
簡短的心智模型:
| 檔案 | 適用位置 | 代表意義 |
|---|---|---|
pnpm-lock.yaml | OpenClaw 原始碼簽出 | 維護者相依性圖 |
npm-shrinkwrap.json | 已發布的 npm 套件 | 使用者的 npm 安裝圖 |
package-lock.json | 本機 npm 應用程式 | 不是 OpenClaw 發布合約 |
OpenClaw 為何使用它
OpenClaw 是閘道、外掛主機、模型路由器與代理執行階段。預設 安裝可能會影響啟動時間、磁碟使用量、原生套件下載,以及 供應鏈暴露面。 Shrinkwrap 讓發行審查有穩定的邊界:- 審查者可以看到遞移相依性的變動;
- 套件驗證器可以拒絕非預期的鎖定檔漂移;
- 套件驗收可以使用即將發布的相依性圖測試安裝;
- 外掛套件可以攜帶自己的已鎖定相依性圖,而不是 依賴根套件來擁有僅供外掛使用的相依性。
技術細節
根openclaw npm 套件和 OpenClaw 擁有的 npm 外掛套件在發布時會包含
npm-shrinkwrap.json。合適的 OpenClaw 擁有外掛
套件也可以搭配明確的 bundledDependencies 發布,讓其執行階段
相依性檔案被包含在外掛 tarball 中,而不是只依賴
安裝時解析。
請這樣維護邊界:
pnpm-lock.yaml 中的套件版本。這會保持
pnpm 相依性的版本年齡、覆寫,以及修補審查邊界完整。
只有在刻意重新整理根套件且不觸碰外掛套件時,才使用僅限根的命令:
pnpm-lock.yamlnpm-shrinkwrap.json- 已綁定的外掛相依性酬載
- 任何
package-lock.json差異
package-lock.json。
若要檢查已發布的根套件: