← 開発日記に戻る

OpenClaw 2026をリモートMacで安定運用 — 導入スクリプトとonboard、Gateway 18789/トークン/LaunchDaemon、ログ対照表、カナダ中高配M4の7×24

開発 · 2026.04.28 · 7 分

リモートMacでOpenClaw Gatewayを常時運用するイメージ

クラウド上の専用MacでOpenClawを「開発用のおもちゃ」から「常時待受のゲートウェイ」へ寄せるとき、詰まるのは思想より手順です。公式のワンライナー/インストールスクリプトでCLIを揃えたあと、openclaw onboardが実体のセットアップになります。続けて既定の待受ポート18789、クライアントが付けるトークン、launchdに載せるLaunchDaemonかLaunchAgentか、ログに出る定型エラーの意味、カナダノードで24GB/1TB級を選ぶ理由が一本の運用線になります。前提の全体像はOpenClaw 2026:リモートMacでの導入・デプロイと排障と重なりますが、本稿は番号と常駐とログの三点を厚めにします。

インストールスクリプトとopenclaw onboard

ドキュメント掲載のcurl | sh系は、PATHにopenclaw CLIを置き、以降のウィザードを前提にした入口です。リモートMacではSSHセッションだけで完走させず、初回だけ画面共有を開き、TCC(アクセシビリティや自動化)をバンドルID単位で通す計画が安全です。オンボーディング中に--install-daemon相当を選ぶと、再起動後もopenclaw gateway runを手で打たずに済むlaunchd登録まで進みます。途中で落ちた場合は、半端なplistよりopenclaw doctoropenclaw gateway statusを先に見てからやり直す方が早いことが多いです。

Gateway 18789とトークン

HTTPゲートウェイの既定は18789です。別サービスが同じポートを掴んでいるとEADDRINUSEで起動に失敗します。リバースプロキシや社内ゼロトラストの前段を挟む場合は、外向き443と内向き18789の役割を図にして共有してください。クライアントからの接続には共有シークレットや短命トークンを載せるパターンが一般的で、画面収録に貼らず環境変数やmacOSキーチェーン連携に寄せます。トークン期限切れはHTTPログでは401403に見え、CLI側では認証エラー文言に落ちます。

LaunchDaemon運用の注意点

LaunchDaemonはシステム全体でroot相当の文脈が絡み、LaunchAgentはログインユーザに紐づきます。クラウドMacで「ログインセッションが切れてもゲートウェイだけ残す」ならDaemon寄り、デスクトップ連携を厚くするならAgent、の切り分けが定石です。いずれもlaunchctl listでラベルが0以外の終了コードを返していないか、ログパスをlog streamかファイルテールで巡回します。plistを手編集したあとはlaunchctl bootoutbootstrapのペアを運用ドキュメントに固定し、二重登録を防ぎます。

ログ・メッセージ対照表(抜粋)

以下はリモートMac運用で頻度が高いシグナルです。実際の文言はバージョンで多少変わります。

ログ・症状 第一候補の原因 確認・対処
EADDRINUSE / bind failed 18789の競合 lsof -i :18789、不要プロセス停止、またはポート変更
ECONNREFUSED ゲートウェイ未起動/クラッシュ直後 openclaw gateway statuslaunchctlの終了コード
401 Unauthorized トークン欠落・期限切れ・ヘッダ名ミス 環境変数の再読込、プロキシがAuthorizationを落としていないか
certificate / UNABLE_TO_VERIFY_LEAF_SIGNATURE TLS終端と実体ホストの不一致 プロキシの証明書、中間CA、システム時刻
権限ダイアログの繰り返し TCC未完了/アプリ移動でパスが変わった GUIで一度通す、インストール場所を固定
運用メモ:openclaw --versionとデスクトップアプリ側のゲートウェイ互換表を突き合わせ、ポート所有者・launchdラベル・トークンのローテ手順を1枚のRunbookにまとめておくと、7×24に寄せたときの「誰が何を直すか」が明確になります。

カナダ中高配M4の7×24シナリオ

北米向けレイテンシと業務時間の重なりを取りにいくならカナダ拠点は相性がよく、Apple Siliconの振る舞い自体は地域で変わりません。Gateway+ブラウザ自動化+ローカル推論のバーストを夜間も抱えるなら、16GBより24GBユニファイドメモリ、512GBより1TBストレージの帯に寄せた方がスワップとログ肥大に余裕が出ます。構成の詳細は2026年カナダ遠隔Mac M4深度進化:24GBメモリと1TBストレージが北米進出、自動テスト、大規模Node.jsビジネスにもたらす実戦価値を参照し、チーム割当とコスト感は2026年リモートMacチームの予算と性能:カナダノードで北米ユーザー、太平洋横断のSSH/VNC選区、M4(16GB/256GB対24GB/512GB)と1TB/2TB拡張・並列インスタンスは割に合うかと併読すると打ち合わせが早いです。

まとめ

スクリプトでCLIを揃え、onboardでランタイムを束ね、18789とトークンをネットワーク設計に組み込み、launchdで再起動耐性を付け、ログ対照表で一次切り分けを短縮する。カナダの中高配M4はこのパイプラインを物理的に支える現実的な選択です。

常時Gatewayを載せるなら、静音で電力の薄いアンカーが有利

Apple Silicon M4のMac miniクラスは、夜間もNodeランタイムとゲートウェイを載せたまま待機電力が抑えやすく、ラック常駐より騒音と冷却の心配が少ないです。macOSはUnix系ツールチェーンとコード署名モデルが揃い、SSHと画面共有で運用に乗せやすい一方、GatekeeperとSIPで不要バイナリの混入リスクを下げやすいです。ユニファイドメモリはブラウザ自動化とエージェントのスパイクを同一チップ上でさばきやすく、24GB/1TB帯に寄せるとログとキャッシュの長期運用が楽になります。

自前ラックではなくクラウドに載せ替える場合、 HashvpsのクラウドMac mini M4は現実的な出発点です。 プランと料金を見る と、上記のポート・トークン・メモリ設計をそのまま見積もりに落とし込めます。

Hashvps · Mac クラウド

専用M4でOpenClawゲートウェイを常時化

18789待受、LaunchDaemon、北米レイテンシ。オンボード後はインフラとして扱えるホストを選ぶ。

ホームへ
期間限定