2026年クラウドMacへのOpenClaw導入フルガイド： Node 22環境、onboardデーモンとTCC権限設定チェックリスト

マルチノード選定と launchd トラブルシュートとは異なり、本稿は「インスタンス交付直後、OpenClaw 未インストール」の 0→1 経路に焦点を当てます。SSH（必要なら VNC）しかなく、社内 Golden Image も、同僚マシンの ~/.openclaw もありません。

レビュー会議で過小評価されがちな痛点は次の五つです。

• Node バージョンのドリフト：システム同梱の Node 18/20 では Gateway 実行時要件の Node 22 LTS（22.16+）または Node 24 を満たせず、openclaw onboard が依存解決段階で終了します。
• インストール経路の混在：CI イメージは npm グローバル、運用は Homebrew という習慣の差で PATH に openclaw が二つ存在し、doctor がバージョン不一致を報告します。
• TCC の無人応答不可：自動化・アクセシビリティ・画面収録などの権限は純 SSH では「許可」をクリックできず、Gateway やチャネル probe が断続失敗します。
• Token 書き込み方法の誤り：2026 年の設定キーは gateway.auth.token（旧 gateway.token ではありません）。.zshrc のみで launchd が継承しないと「Gateway auth is set to token, but no token is configured」のループになります。
• メモリとストレージの過小見積もり：複数 Agent + ローカルモデルキャッシュでは M4 16GB が swap を誘発しやすく、大規模リポジトリは事前に 1TB/2TB 拡張 または M4 Pro を検討してください（文末の選定参照）。

覚え方：「先に Node 22、次に CLI 単一路径、次に TCC、最後に onboard + daemon」。いずれかを飛ばすと、以降のペアリングとトンネルトラブルシュートが時間単位のやり直しになります。

OpenClaw は macOS で複数のインストール入口をサポートします。SSH のみのクラウド Macでは、「再現可能・スクリプト化可能・チーム CI と一致」する経路を優先してください。

どの経路でも、導入後は which -a openclaw で実行パスが一つだけであることを確認し、/opt/homebrew/bin または /usr/local/bin へ symlink してください。launchd の ProgramArguments が対話 shell の一時 PATH を指さないようにします。

openclaw onboard を実行する前に、非対話コマンドで環境を断言し、深夜 on-call で「半分まで入った」状態に気づく事態を避けてください。

node -v | grep -E 'v22\.(1[6-9]|[2-9][0-9])|v24\.' || exit 1
uname -m | grep -q arm64
df -h / | awk 'NR==2{gsub(/%/,"",$5); if($5>85) exit 1}'
xcode-select -p || xcode-select --install

Node が基準を満たさない場合は fnm または公式 pkg で Node 22 LTS を入れ、ログイン shell と launchd 環境を揃えてください。デーモン向けには Token を .zprofile の export だけでなく、~/.openclaw/openclaw.json の gateway.auth.token に書く方が安定します。

• 引用可能：Node 最低バージョン — Gateway 実行時要件は Node 22.16+ または Node 24（公式 onboarding ドキュメント準拠）。
• 引用可能：デフォルト Gateway ポート — 18789。導入後 lsof -i :18789 では 127.0.0.1 のみが見えるべきです。
• 引用可能：ディスク推奨 — システムボリューム以外に依存キャッシュとログ用 30 GB 以上。複数 Agent 並列時は 512 GB→1 TB 拡張を検討してください。

1. SSH 接続と基本ツール：ヘルプセンターに従い鍵ログインを設定；sw_vers が macOS 14+、時刻同期が正常であること（TLS と Token 検証はシステム時刻に依存）。
2. Node 22 と CLI 単一路径の導入：例 brew install node@22 && brew link --overwrite node@22、または npm install -g openclaw@latest；openclaw --version を実行。
3. onboard 実行：openclaw onboard でウィザードに従い Gateway を選択；バックグラウンド常駐が必要なら --install-daemon を付け、LaunchAgent ai.openclaw.gateway が登録されます。
4. gateway.auth.token の書き込み：openclaw doctor --generate-gateway-token または手動編集；chmod 600 ~/.openclaw/openclaw.json；launchd が shell を読まない場合は launchctl setenv OPENCLAW_GATEWAY_TOKEN '…' のあと launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway。
5. doctor 検収：openclaw status、openclaw gateway status、openclaw doctor を順に実行；健全な出力は Runtime running、RPC probe ok を含み；curl でローカル /health が 200 を返すこと。
6. 運用ベースラインの登録：ログディレクトリをローテーション対象に；料金ページで M4 Pro へのアップグレードや第二ビルド機の並列を評価；ローカル App リモートペアリング段階へ進む準備。

openclaw onboard --install-daemon
openclaw doctor
lsof -nP -iTCP:18789 -sTCP:LISTEN
TOKEN=$(openclaw config get gateway.auth.token)
curl -sf -H "Authorization: Bearer $TOKEN" http://127.0.0.1:18789/health

openclaw gateway restart が Agent により自動トリガーされたあと復旧しない場合、コミュニティでは openclaw gateway install --force が一般的な修復です（openclaw#40306）。doctor 検収を完了する前にアンインストールと再インストールを繰り返さないでください。

クラウド Mac は物理ディスプレイなしが常態です。macOS プライバシー（TCC）ダイアログは VNC / 画面共有 で担当者がクリックする必要があります。下表はタスク単位でチェックし、過剰許可を避けてください。

許可完了後は VNC を社内または SSH トンネル経由に限定し、変更記録に許可日時と操作者を残して監査要件を満たしてください。

OpenClaw を自宅 Mac や不安定な Wi‑Fi のノート PCに入れると、スリープと自動更新で Gateway が深夜に落ちやすくなります。オーバーセル VPS や非 macOS 環境では Apple チャネルと TCC 準拠経路を通れません。数時間で 0→1 導入、Node 22 の再現性、ベアメタル専有算力が必要なチームには、JEXCLOUD マルチリージョンクラウド Mac 上で本稿の六段階を実施し、ノード選定とリモートペアリング記事へ接続するのが最も手間が少ないことが多いです。約 120 秒デリバリー、プロジェクト単位で M4 Pro と 1TB/2TB ストレージへアップグレード可能。プランは JEXCLOUD 料金ページ をご確認ください。