起動しないとき最初は？

JSON、18789、plist の PATH と WorkingDirectory を確認してからチャネルと doctor へ。

Docker でホストに設定が見えない？

~/.openclaw と workspace の両方をマウントし uid を揃える。

install.sh と npm は衝突？

あり得る。本番エントリポイントを一つに決め plist で先頭 PATH を固定。

2026 OpenClaw インストール経路の選び方：install.sh・npm・pnpm・Docker と Mac クラウド launchd 検収

Mac クラウドで OpenClaw を長期運用するなら、公式 install.sh、npm -g、リポジトリの pnpm、Docker のどれを正とするかが速度競争ではなくアップグレードと再起動責務の契約になる。本稿は対象者と得られるもの（監査可能な更新と再現可能な常駐）、痛点、貼り付け用マトリクス、launchd 五ステップ、Docker ボリューム事実、JSON と 18789 の第一検査を整理し、既存の status→doctor 記事と補完関係にある。

1. 要約：各経路が最適化するもの

install.sh は初回オンボードを最短化するが、バイナリと設定の実体パスを把握し launchd から絶対パスで呼ぶ必要がある。npm install -g openclaw@latest はパッケージ版管理に慣れたチーム向けで、SSH セッションを跨いで which openclaw を安定させやすい。pnpm ソースビルドは上流追従とパッチに最適だがビルド規律が要る。Docker は隔離に強いがバインドマウントの uid、企業プロキシ経由 DNS、workspace だけ掛けて ~/.openclaw を忘れると設定が分裂する。2026 年よくあるのはデモ用スクリプトを本番 Mac クラウドに流用し WorkingDirectory とログを直さず、セッション切断後に戻らないゲートウェイを残すパターンである。

2. 痛点

更新ドリフト：スクリプト導入と npm グローバルと pnpm link が共存し openclaw --version と実プロセスが食い違う。
ボリューム分裂：コンテナにのみ設定がありホストから見えない、あるいは uid 不一致で JSON が壊れる。
デーモン不在：SSH フォアグラウンドは切断で死に、再起動後に戻らない。
トリアージ順序：JSON と 18789 を見ず pairing に入ると時間を失う。

3. マトリクス

「第一トリアージ」はインストール媒体レベルに限定し doctor 階層とは役割分担する。

経路	更新	典型パス	権限	第一検査
`install.sh`	再実行	ユーザ bin + 設定	PATH	version
`npm -g`	`npm update -g`	接頭辞 + ~/.openclaw	nvm	launchd 環境一致
pnpm	pull+build	clone	依存サイズ	終了コード
Docker	新イメージ	コンテナ+巻	uid/DNS	compose logs

ヒント：plist/compose に HOME・PATH・WorkingDirectory を明示。

4. launchd 五ステップ

対話的 openclaw onboard 済みを前提に 24/7 へ：

媒体と版（または digest）を Runbook に固定
LaunchAgent plist：絶対パス、標準出力エラー先
bootstrap と kickstart で端末子でないことを確認
lsof -i :18789 と JSON 妥当性
前バージョン npm またはイメージ tag でロールバック演習

plist 骨格（置換必須）：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
 "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>com.example.openclaw.gateway</string>
  <key>ProgramArguments</key><array>
    <string>/usr/local/bin/openclaw</string><string>gateway</string><string>run</string>
  </array>
  <key>WorkingDirectory</key><string>/Users/deploy</string>
  <key>StandardOutPath</key><string>/var/log/openclaw/gateway.out</string>
  <key>StandardErrorPath</key><string>/var/log/openclaw/gateway.err</string>
  <key>RunAtLoad</key><true/>
</dict></plist>

5. Docker と監査

~/.openclaw と workspace の二巻きが最低限
uid 1000 前提とホスト所有者のずれ
プロキシ下ではコンテナ内 curl で出口確認
18789 の競合：実験用ゲートウェイは旧 plist を止める
媒体検収後に doctor 記事でチャネル側へ
変更票に媒体・digest・version・Label を残す

6. ネイティブ Mac クラウドの利点

WSL や入れ子仮想化、ノート PC 上の趣味 Docker はデモには良いが、本番では翻訳層と再起動責務が曖昧になる。共有 Mac クラウドではボリューム IO の尾が長くなることもある。SSH 可能な専用 Mac クラウドで npm またはインストーラバイナリ＋ launchd とすれば「どこに何が動いているか」を Runbook 一行で説明しやすい。明示的な隔離が要るまで Docker をデフォルトにしない。Windows や汎用 Linux は後から macOS パス前提の自動化を足すと噛み合わない。初回は站内の 5 分デプロイ記事でチャネルを通し、本稿で媒体と plist を凍結せよ。