リモート Mac CI で OpenClaw を無人運用する手順です。チェックリスト付きです。Node 二十二・一四以上または二十四、OpenClaw Installer（
npm・macOS 検出）に沿った導入、非対話 onboard と API 鍵の環境変数注入、マージログ でゲートします。既定ポート一八七八九、分離ディレクトリ、doctor と検証点の戻しを整理しました。validate・doctor 版戻し・MCP。料金・購入・ヘルプはログイン不要です。
運用が止まる三つの典型
対話待ち、標準エラーがログに乗らず誤緑、PATH と鍵の launchd 不一致です。下の表と手順で潰し切ります。
前置バージョンとディレクトリ隔離
Node 二十二・一四以上または二十四を固定し、OPENCLAW_HOME 相当の専用ディレクトリへ設定とキャッシュを閉じます。npm i -g openclaw@タグ で CLI をピン留めします。疎通例は https://127.0.0.1:18789 です。専用リモート Macなら七×二十四時間の再現性が上がります。
- ログ先頭に
node -v。 - 一八七八九番は直列ジョブか明示ポート。
非対話パラメータと環境変数の対応表
| 目的 | 渡し方 | メモ |
|---|---|---|
| 認可 | OPENCLAW_GATEWAY_TOKEN を export | ファイルより注入 |
| モデル鍵 | マスク名のみ | 値はログ禁止 |
| 非対話 | --yes 系・CI=1 | TTY 無し前提 |
| doctor | 終了コード＋末尾保存 | grep で警告 |
CI ジョブとマージ出力のゲート脚本
set -euo pipefail の同一シェルで onboard・doctor・config validate を一ログへ。終了コードは各コマンド直後に取得します。
一
マージ
exec > >(tee -a openclaw-ci.log) 2>&1
二
注入
export VAR="$(cat file)" の単相のみ。
三
検証
doctor を grep し validate と併せ緑条件を決める。
四
成果物
ログと鍵除外 tar を短い保持で載せる。
五
緑
一八七八九でヘルス応答を条件に含める。
失敗時の doctor 解析とロールバック検証点
変更前に鍵除外 tar を切り、失敗時は直前アーティファクトへ戻してから公式の doctor --repair 相当のみ実行します。リロード直後は短い再起動のあとマージログを再取得します。
- 開始時と成功時の二回 tar。
- 公開ログはマスク一行要約のみ。
FAQ：ポート・PATH・トークン
一八七八九番使用中
lsof で確認し直列か別ポートを設定と一致。
コマンド不在
PATH にグローバル bin、which openclaw をログへ。
四〇一
空白と二重引用符を削り plist と export を突合。