2026 OpenClaw オンボード：MacLogin クラウド Mac で launchd デーモンを入れ、ゲートウェイ健全性と Control UI を安定運用する

MacLogin で Apple Silicon を借りるプラットフォームチームは、npm install -g openclaw の直後に足踏みしがちです。CLI は入ったがゲートウェイが長生きしない、ノート PC から Control UI が見えない、openclaw doctor の警告が未処理——2026 年 5 月 19 日付の本稿は、openclaw onboard --install-daemon を誰が実行すべきか、前景プロセスとの違い、チケットに残すべき 数値（Node の正確な版、TCP 18789、香港・日本・韓国・シンガポール・米国 のリージョン）、SSH のみのときに Control UI を安全に開く手順をまとめます。姿勢マトリクス、9 段階、ローカルポート転送、doctor 切り分け表 を用意し、ページ内 FAQ スキーマとも整合させます。安定後は npm ci 再現性、curl ヘルス監視、ヒープ上限 へ進んでください。料金とリージョンは pricing、接続の基礎は help を参照します。

想定読者、初日に壊れやすい点、レンタル mini で onboard が要る理由

対象は 香港・東京・ソウル・シンガポール・米国 の MacLogin クラウド Mac に OpenClaw ゲートウェイを載せるスタッフエンジニア／DevEx リードです。CI と同じ温度感で運用し、スライドの題材にしないことが前提です。

• 前景だけのゲートウェイ：SSH 切断で SIGHUP を受け取りやすい。launchd に載せればセッション後も生存し、再起動方針を OS に委ねられます。
• Control UI の錯覚：ブラウザは手元のマシン、127.0.0.1 は mini 側——見る場所がズレています。
• Node の版ズレ：3 月のメモと 5 月のイメージが違うと微妙に壊れるので node -v を必ず貼る。
• doctor 放置：プロバイダ鍵の半設定で RPC が負荷時だけ不安定になる。
• 観測なし：合成チェックを付けないと「起きている＝健康」に見える。

MacLogin の利点は、ベアメタルの Apple Silicon と素直な macOS 挙動が揃うことです。東京で一度通した launchd テンプレを、レイテンシ実験用にシンガポールへ複製しても x86 特有の驚きが少ないです。

インストール姿勢マトリクス：前景、onboard デーモン、手書き plist

行を混在させないでください。staging と本番で「launchd が一つ違うだけ」は高コストです。

姿勢	向いているとき	SSH 切断後	運用負荷
tmux 内 openclaw gateway --port 18789	30 分未満のスパイク、デバッガ接続	ラッパ次第	高
openclaw onboard --install-daemon	チーム共有ゲートウェイ、CI 隣接ボット	生存（launchd 管理）	中
手書き LaunchDaemon	ProgramArguments をセキュリティ監査済みに限定したい	生存	初期高・長期低
macOS アプリ + 外部 CLI	GUI オンボードと CLI 固定版を両立	バンドル次第	中

前提：Node、ポート、リージョン、最初に読むべき文書

コマンドを打つ前に証跡を取り、監査で「即興ではない」と示します。

チェック	目標	確認コマンド
Node 基準	最低 22.14、許可なら 24.x	node -v && which node
グローバル prefix	サービスユーザーが書ける	npm prefix -g
ポート衝突	18789 が空いている	lsof -nP -iTCP:18789 -sTCP:LISTEN
リージョン	HK/JP/KR/SG/US をチケットに明記	pricing で RTT を比較

同一 mini で実験が衝突する場合はユーザーを分けるか別リースへ——ポートの競合は Git のマージでは解けません。

9 段階：空のシェルから launchd 管理ゲートウェイへ

1. 15 分の変更窓を凍結し、HK/JP/KR/SG/US 関係者へ通知する。
2. Node を固定版にし、セマバーを本文に貼る。
3. 方針に従い npm install -g openclaw@… を実行する。
4. onboard openclaw onboard --install-daemon を走らせ、ログをチケットに添付する。
5. launchctl で Label を確認する。
6. gateway status で RPC プローブを記録する。
7. Control UI を次節の方法で開く。
8. doctor をゼロまで潰す。
9. curl ヘルス 記事で継続監視を接続する。

Teams orchestrating multiple agent CLIs should read Multica vs Devin 比較.

See also: OpenClaw AppleScript 連携.

ループバック上の Control UI と SSH ローカル転送

ゲートウェイは mini の 127.0.0.1:18789 で待ち受けます。ssh -L 18790:127.0.0.1:18789 user@mini の後、手元で http://127.0.0.1:18790/ を開きます。方針が許せば VNC で mini 上の Safari を使う方法もあります。

SOC が承認したパターンを文書化し、混在運用を避けてください。

doctor・status・実障害が食い違うときの表

症状	有力原因	最初の手
起動直後に RPC 失敗	DNS/ネットより先にデーモンが立ち上がった	ThrottleInterval や起動順の調整
鍵不足の doctor 警告	オンボード未完了	承認済みシークレット注入で再実行
UI は開くが操作が固まる	ワークスペース権限	所有者とサービスユーザーの整合
CPU 高・トラフィック低	ポーリングやログ嵐	統一ログとヒープ記事へ

stderr が空でも謎が残る場合は 5 月 13 日の stderr 記事へ——本稿は初日の負荷を抑えるため深掘りしません。

FAQ：CI との境界、リージョン複製、いつ手を引くか

onboard は CI を置き換える？ いいえ。デーモン化の土台です。

JP の plist を US にコピー？ ProgramArguments は大抵 OK ですがエンドポイント行きの環境変数は必ず見直し、鍵の丸コピーは禁止です。

契約延長が途中で決まった？ 健全なら壊さず、観測保持を延長します。

npm ci で揉めたら？ 専用記事へ分離してください。

運用で効く Mac mini M4 エッジとしての理由

Neural Engine も含めたスループット以前に、launchd 再起動のサーマルが素直で、ユニファイドメモリ により Node ヒープとキャッシュが同一空間に収まる点が現場向きです。x86 VM 上の macOS より、launchd と画面共有のセマンティクスがそのまま使え、上記 SSH トンネル手順も既存 macOS サーバ監査に乗せやすくなります。

リージョン単位のレンタルで RTT を下げつつ CAPEX を避けられます。pricing でコア数を合わせ、help と VNC を併記すれば、GUI の方が早い検証もすぐ取れます。