リモート Mac の CI で OpenClaw のスキルチェーンと MCP を載せる手順です。Node は公式の下限・推奨に合わせ、導入は公式スクリプトに一本化し、ゲートウェイは 127.0.0.1 とトークンで閉じます。workspace 例・エラー対照・定時プルとプリフライトのつなぎまでまとめます。

運用前に押さえる三つの制約

1

ランタイム差:node -v が要件とずれると CLI が黙って落ちます。ジョブ先頭で必ず表示してください。

2

露出面:0.0.0.0 かつトークンなしは避け、127.0.0.1 かソケット+外向きは SSH トンネル等で閉じます。

3

再現性:export 頼みをやめ、openclaw.json とスキル・プリフライトを workspace に集約します。

MCP ゲートウェイの公開パターン比較

パターンセキュリティ向くシーン
ループバック+トークン+SSHCI ノードの既定案
Unix ソケット同一ホスト連携
0.0.0.0原則禁止

再現手順(五ステップ)

1

Node:公式ドキュメント(下限 22.16 付近、24 系推奨の記載)に合わせ fnm 等で固定。

2

導入:npm -g は PATH がブレるため公式 curl スクリプト優先。冒頭で openclaw --version をログ化。

3

workspace:下記構成に openclaw.json・スキル・MCP・preflight.sh を置き cwd 固定。

4

ゲートウェイ:127.0.0.1 バインド+長いトークン必須。0.0.0.0 の無認証公開は禁止。

5

常駐:LaunchAgents の plist で RunAtLoadKeepAliveWorkingDirectory とログを絶対パスで。

最小の再現 workspace ディレクトリ例

openclaw-ci-workspace/
├── openclaw.json
├── skills/
├── mcp-servers/
├── scripts/preflight.sh
└── logs/gateway.log

よくあるエラー対照表

症状原因対処
openclaw が見つからないPATH公式スクリプト経路と shell の PATH を一致
即クラッシュNode 不足要件どおりに上げる
MCP 即切断トークン誤り環境変数と設定を突合
外部から到達裸の 0.0.0.0ループバックへ戻しトンネルで閉じる

定時プルとプリフライトをつなぐ一例

launchdcrongit pull --ff-only のあと preflight.sh、成功時のみ launchctl kickstart でゲートウェイ再起動、と二段にすると安全です。プリフライトで doctor 相当と MCP の list tools を exit code 化してください。

設計メモとして引用しやすい要点

チェックリスト
  • Node 下限・推奨を公式に合わせログに残す。
  • 導入は公式スクリプト、ゲートウェイはループバック+トークン。
  • plist の WorkingDirectory とログを絶対パスで固定。

まとめと次のアクション

三点セットは Node 固定・閉じたゲートウェイ・workspace 宣言です。ブログ一覧ヘルプホーム も併せてご覧ください。

リモート Mac に MCP とプリフライトを載せればスキル更新と CI 入口を一箇所に集約できます。ClawHub 自動化と併読ください。専用ノードが欲しい方は 購入 から MacPull をご利用ください。

MCP 常駐ゲートウェイ向け

スキルチェーンを載せるなら安定したリモート Mac ノードを

常時オン・再現性の高い CI 用 Mac で OpenClaw と MCP を閉域運用。料金確認と購入はログイン不要です。

24時間以内デリバリー スペック変更可 いつでも解約可