クラウド Mac に OpenClaw を載せる現場で詰まるのは、しばしば常駐ロジックより先に起きる導入工程です。本文では公式 install.sh とグローバル npm という二系統、openclaw onboard --install-daemon が書き込む launchd、既定の 18789openclaw gateway status の意味、iCloud や社内同期に置いてはいけない状態ディレクトリ、Git やコンテナのレジストリに近い リージョンM4 Pro 64GB が有効化されやすい同時負荷、そして 切り分けの優先順位 を一気通貫で揃えます。プロセス常駐・heartbeat・pm2 など 24 時間目線の深掘りは、同階層の 2026 年に OpenClaw を 24 時間安定稼働 を参照し、本稿は「導入と一次切り分け」に専有させます。
01

クラウド Mac で六度出る導入事故の型

社内用に育てたノートとは違い、借り上げ Mac は基盤が薄く、セッション寿命も短い前提です。curl と npm だけの発想に留まると、openclaw onboard --install-daemon が作る launchd の Label や作業ディレクトリ、標準出力の場所、PATH の差、といった事実上の SSoT を見落とします。一つ目の型は バージョンの漂流 です。同じリリースノート名でも、片方は公式 one-liner、片方は古い global npm という壊れ方は、openclaw gateway status が指すバイナリと実際のプロセスが交錯するときに露呈します。二つ目は 18789 競合 です。社内用の一時的な可視化、別プロジェクトの health サーバ、失敗に終わった npm のデバッグ用ポートが 18789 を奪い、外から見ると「モデル推論の障害」に見えてしまいます。三つ目は 同期フォルダ上の state です。SQLite ベースの状態が断続的に書き込まれると、相変わらず process は立っているのに、書き込み失敗のログが散発する、という中間ゾーンに落ちます。四つ目は リージョン不整合 です。Git ホスト、コンテナのレジストリ、社内 npm ミラーが大陸の両岸に分かれていると、onboard 時の小さな I/O 失敗率が乗数で跳ね、インストール失敗に見えます。五つ目は メモリ不足 です。M4 ベース帯域で、ブラウザ自動化、ベクトルキャッシュ、同時多スキルが積もると、リンク時の遅さではなく常時 swap が支配します。六つ目は 切り分け順の逆転 です。status を読む前に設定ファイルを焼き直し、再インストールの前に launchd の整合を取らないと、人時だけが流れます。常駐面の方針は、改めて 同フォルダの 24 時間記事 と衝突しないよう、同じ用語(再起動、heartbeat、pm2 など)でメモを残すのが安全です。

併走する Xcode 用 CI と同一ホストに載せる場合は、DerivedData や各種ツールのキャッシュが、OpenClaw の I/O パターンと衝突し、ディスクの枯渇はメモリ不足と一緒に届きがちです。アカウント分離、あるいは少なくともパスプレフィクスを分け、容量アラートの所有をチケット上で固定してください。多くのチームは、週明けの人間が GUI を開く時間帯と、夜間のヘッドレスのピークを積算せず、OpenClaw の同時性だけを上げに行って失敗します。そこに M4 Pro 64GB の議論を持ち込む前に、まずリージョンと同期の是非を抜かさない、という手順の筋が本稿の骨格です。多地域の RTT と契約週次は マルチリージョン記事 と整合させ、OpenClaw の導入順に巻き戻ると、トータルの手戻りが減ります。

01

one-liner のコピーだけ残してタグ名と Node のメジャーが残っていない。 再現性は「同じ release tag」「同じ Node 20 系以上」「同じパッケージマネージャの方針」で初めて成立します。

02

onboard を流さない、あるいは launchd を検証せず次へ進む。 対話 shell にぶら下がるゲートウェイは、VNC 切断のたびに孤児化しやすいです。

03

18789 の所有者名簿がない。 lsof -i :18789openclaw gateway status、ドキュメントのプロセス名を一列に揃えます。

04

状態を同期フォルダに置く。 バックアップはスナップショットやオブジェクトストレージ、双方向 iCloud ではなく。ログに鍵が混ざるなら、保存期間をプロジェクト方針に従います。

05

Git とレジストリから遠いリージョンを選ぶ。 RTT はチップの世代では縮まりません。倉庫に近づくか、社内にミラーを作ります。

06

インストール失敗票と OOM 票を一緒に扱う。 前者は npm と権限、後者は統一メモリとスキル同時。常駐の扱いは 24 時間の記事 へ切り出します。

上記の型を避けたうえで、次章の表にインストール経路、ポート、state の物理配置を焼き付けます。以降、launchd 再読み込みと 18789 の衝突は「設定ファイルをいじる前に必ず status 系で確定」という本稿の掟を貫きます。これを押さえれば、夜間帯の一次対応者が「どのバイナリのどの版を誰が入れたのか」で迷う時間を大幅に圧縮できます。

02

install.sh 対グローバル npm、18789、state:切り分けで揃えるべき列

公式 install.sh 系の利点は、新規インスタンスに対して最も短い「再現性の道筋」を提供することです。全員が同じ one-liner を使えば、Slack 上の「手順が足りない」系の会話は減ります。一方 nvm や pnpm 前提の倉庫が既にある場合、グローバル npm i -g openclaw も自然です。ただし launchd は対話式 shell 初期化を読まない典型なので、which node の結果が、SSH のログインシェルと一致しているか、あるいは plist 内に絶対パスで埋めたか、を必ず検証します。openclaw gateway status の出力中に現れるバイナリ表記は、その検証の一次ソースです。ここを飛ばすと「status は緑、実際の通信は違う二進数」が成立します。18789 はローカル可視性の受け口であり、出向のモデル推論の TCP 失敗と独立です。0.0.0.0 に広げるか 127.0.0.1 に留めるかは、SSH トンネル、社内ゼロトラスト、ゾーン境界に直結するので、メモ帳一つで済まさず、Runbook 冒頭の表に固定してください。M4 Pro 64GB の価値は、ゲートウェイ常駐+中〜重のスキル+(場合によっては)同機の検証用ブラウザを同時に走らせるシナリオに現れ、RTT の改善は代替しません。NVMe の空き率と、swap の発生有無を同じダッシュボードに載せないと、財務は「高いチップ」だけ買いに行き、幾何上の遅延は残ります。

導入経路採用が理にかなう状況onboard との接続
公式 one-liner / install.sh何もない新規 VM へ 30 分以内の同一体験を保証その後 openclaw onboard --install-daemon で launchd 登録
グローバル npmNode バージョンと社内 mirroring が既に固定plist に Node 絶対パス、PATH は launchd 用ラッパで保証

次の表は、18789 以外に見落としがちな I/O 条件を併列に載せます。state がネットワークボリューム上にある例は、一見「ディスク遅延」に見えても、実はロック問題です。社内 EDR の常時走査が同じ階層に降りてきているケースは、スループットではなく、ファイル open のレイテンシに効き、SQLite 書き込みが詰まります。そこに M4 Pro 64GB の追加メモリを足しても、I/O キューの根本は癒されません。逆に 64GB は、多チャネルのスキルとブラウザとゲートウェイの同時常駐のとき、swap 由来の断続的 500 応答に効きます。Git とレジストリ、npm の三点が同一大陸上にあるか、を RTT 観測付きで一度だけでも数値化して共有してください。数字がない会議は、最終的に「なんとなく M4 Pro」に流れがちです。

項目既定 / 想定まず疑う層
ローカル ダッシュ / ヘルスTCP 18789 既定lsof、status の bind 行、社内他ツール
状態ディレクトリローカル高速、同期外iCloud、企業 drive、二方向バックアップ、NAS
リージョンGit 近傍を優先大陸横断 RTT、プロキシの CONNECT 許可、社内 split DNS

導入経路は「同じ二進数か」、status は「同じプロセスか」、state は「同じ磁気的現実に書けているか」、リージョンは「幾何に勝てるか」、を別々の列で見るのが要です。

M4 Pro 64GB については、予算会議の一行に「同時常駐スキル本数、ブラウザ本数、ベクトルキャッシュ GB、夜間の swap 有無、DerivedData との併用可否」を併記すると説得力が上がります。ここに RTT 改善も混ぜると、承認者は煙に巻かれがちなので、ネットは別チケットに切り出してください。

03

三つの優先則:status、launchd、再インストール

一つ目の優先則は、openclaw gateway status の記述と、launchctl list に出るラベル名が一致するまで、.env や config をいじらない、という厳格さです。二つ目は 18789 を社内の「ポート帳票」に載せ、衝突したらその席の正オーナーと一緒に移動枠を取る、という人間的プロセスです。三つ目は、常駐に関する 24 時間安定記事 側の pm2・heartbeat 設計に追従し、同じ host で二重の監督者を生まないことです。二重の監督者は、起動条件が食い違い、最も読みづらい障害票を生みます。ログ内に出る API キーは、チケット添付用にマスク範囲を決め、生の生を共有しない。長時間保管するなら、閲覧権限と消去日を運用表に乗せます。

手順化する際は、status を毎分叩くのではなく、失敗条件を「起動直後、再起動直後、スキル起動直後」に三点的に測ると、ノイズとシグナルを分けやすいです。ここにオートスケール的な曖昧さを入れると、on-call の心理的安全性が下がるので、閾値は数字で固定してください。launchd のログローテーションと、openclaw 側のログ肥大を同一ディスク圧力として見ると、ディスク要因の迷子が減ります。プロキシ越し TLS インスペクションを挟む企業では、中間 CA の期限切れが「モデル接続失敗」に擬態することがあるため、同じ締切日の一行を別カレンダーに置く価値があります。これは OpenClaw 特有ではありませんが、導入夜にしか表面化しません。

切り分けの順列(on-call 貼付用)
1) openclaw gateway status
2) 18789 もしくは任意ポートの lsof
3) launchd の plist パスと install 接頭辞
4) state が同期外か・ボリューム遅延がないか
5) ログインシェルと launchd で node/openclaw の which が一致
6) Git ・レジストリ ・LLM への出向の TLS/プロキシ/時刻

提案:ポート変更・state 移動・Node メジャー更新は一つのリリース枠に束ね、openclaw gateway status が一発緑で戻るまで本番系トラフィックに繋ぎ戻しません。

04

六歩:空のクラウド Mac から再現可能な起動点まで

六歩は「他者が同じ手順を踏める」ことより、「冷再起後も同じ挙動か」を満たすことに最適化します。KVMNODE 上のリージョンとメモリ帯域は、短期レンで一周してから、必要なら M4 Pro 64GB へ。注文導線は 注文ページ を正とし、口頭随時手配と混在させると、後から同じ枠を買い直せないトラブルに繋がります。onboard 後、launchd の stderr に出る行は、人間が毎分見に行かなくても、ローテーション先のディスク圧力と対で監視に載せると安心です。最後の再起動は必須で、VNC セッションに依存する起動方法は、本番では却下、という扱いにしてください。常駐スクリプトの最終的な心拍や再起動方針は、改めて 24 時間記事 へ合流させます。ここでは「インストールと launchd まで」と線を越えないことが、二重実装の抑止に効きます。スキル同時本数の上限は、人間の都合でなく、swap と GC の実測で定義してください。

01

Node と導入経路の宣言を固定する。 20 系以上、corepack の要否、one-liner か npm かを Wiki 冒頭に明文化します。

02

CLI を導入し、openclaw --version をリリースノートと合わせる。 グローバル npm の場合、launchd 向けの PATH 保証用ラッパを一緒に作ります。

03

openclaw onboard --install-daemon を流し、plist の Label / WorkingDirectory / StandardOut / Environment を控える。 launchctl list を見ます。

04

openclaw gateway status で健康と bind を確認し、不要なら 127.0.0.1 のまま、外向きが要るならゼロトラストと相談のうえ限定的に公布します。

05

state とログを非同期のローカル上に置き、空き率とローテーションの閾値を設定する。 併用で CI を動かすなら容量責任者を分けます。必要なら 64GB を検討。

06

冷再起、再度 status、軽量トラフィック。恒久的な心拍方針は 同フォルダの 24/7 記事 に揃えます。

05

予算行に載る三行の定義文

A

再現性=同じ手順・同じ tag・同じ Node で二台目も起き上がる。 再起動後の openclaw gateway status まで含め、同一出力でなければ未完了扱い。

B

18789 オーナーは人。 変更は favicon やブックマーク、Probe、社内他サーバ表と同時。緊急で kill するのは一時、恒久はリリース枠で。

C

リージョン・メモリ・NVMe・RTT・は別会計の一次近似。 混在させると、高い SoC だけ買いに行き、幾何は残る。まず幾何を測定。

注意: 対話シェにぶら下がるだけのゲートウェイは、夜間帯障害の多くの「起きたり寝たり」と同一視してはいけません。launchd でない限り、未検収です。

雑多な社内端末群より、同一事業者の下で、リージョンとメモリ帯域とレン期を一枚の opex として追える雲上 Mac 群 の方が、OpenClaw の導入タグ、launchd、18789 表、そして人間の手順の歪みに対抗しやすいです。KVMNODE のマルチリージョンな M4 / M4 Pro ラインアップを使い、価格 を参照しつつ短期で導入と daemon まで抜け、swap と RTT の実測のあと 64GB を検討し、注文ページ から可観測に伸ばす、という順序が、週次リリース前の「とりあえずもう一台」より通しやすいケースが多いです。常駐と pm2 については、改めて 同フォルダの安定稼働記事 へ戻ると、導入と運用の境界が一文字も食い違いません。これが 2026 年の現場で、最も手戻りの少い書き方です。