なぜ「インストール経路」でトラブルが変わるのか
OpenClaw は CLI・デーモン・Gateway が連鎖します。npm は PATH で別版を拾いやすく、Docker は listen とポート転記のズレで外から見えないことが多く、curl 直配置はユニットのパス誤りで再起動ループになりがちです。「どの経路で入れたか」を残すのが最短の排障です。
npm/Docker/curl:パスと運用の差分
| 方式 | 長所 | 注意点 |
|---|---|---|
| npm | 更新が楽で馴染みやすい | prefix/Volta/nvm で実体が分裂しやすい |
| Docker | 依存を閉じて再現性が高い | ポート・ボリューム・UID の三点を必ず確認 |
| curl 等 | CI 向きで導入が単純 | 配置パスと権限をドキュメント化しないと迷子に |
「開発 npm/常駐 Docker」など役割分担も有効で、Gateway の bind(127.0.0.1 か 0.0.0.0)とリバースプロキシの upstream が揃っているかを確認してください。
Gateway が応答しないときの切り分け
プロセス生存とポートを分け、コンテナなら docker ps と ports、ネイティブなら launchctl/systemctl と FW を順に。TLS 手前では証明書の SAN と HTTP/HTTPS の取り違いに注意します。
リモート Mac ノードを置く意味
常時電源と安定した出口に寄せると Webhook と SSH の運用が単純になります。全体構成は OpenClaw 導入実戦ガイドのとおり、ホストと Docker の責務を先に決めると後戻りが減ります。
メモリとワーカー数:頭打ちを避ける
統合メモリではモデルとキャッシュが同じプールを共有し、ワーカーを増やすとスループットが逆転することがあります。短期の買い/借りの比較は 意思決定マトリクス記事の表を流用すると説明しやすいです。
運用前チェックリスト
-
実体:
whichとバージョンを記録 - 待受:ループバックのみならプロキシ経路を別検証
- メモリ:OOM 時の再起動方針を先に決める
常時稼働ノードなら、Mac mini と macOS が噛み合う
Gateway 付きのエージェント運用は、低いアイドル電力と静音性がそのまま可用性に効きます。Apple Silicon の Mac mini は待機電力が極めて小さく、長時間の常駐に向き、ネイティブの Unix 環境で Homebrew・Docker・SSH を同じマシンに載せられるため、npm 系とコンテナ系の混在構成でも手戻りが少なくなります。Gatekeeper や SIP による実行制御は、curl で入れたバイナリを運用する際の「意図しない実行」を減らす助けにもなります。
ハードとクラウドのどちらを選ぶにしても、総合的な電気代・冷却・メンテ工数まで含めると、小型で安定した Apple Silicon デスクトップは長期 TCO で有利になりやすいです。本文で整理したパスと Gateway の切り分けを自前ノードへ落とし込みたいなら、コストパフォーマンスに優れた Mac mini M4 が現実的な出発点です。下のバナーから製品ラインとクラウド枠を確認し、今すぐ次の一歩を踏み出せます。