01. 三つの痛み：混在インストール、onboard 後の空白、ポートとネイティブ依存

1）スクリプトと npm の混在：which openclaw はグローバルパッケージを指す一方、launchd や cron は古い PATH のバイナリを呼ぶことがあり、バージョン不一致やプラグイン探索パスのずれになります。v2026.4.5 ではコンソールと ClawHub が状態ディレクトリとスキルキャッシュに敏感で、混在は Needs Setup の偽陽性を増やします。

2）onboard 後も会話できない：多くはプロバイダー鍵の置き場か隔離境界内のスキル依存未導入です。MCP の承認境界を先に確認し、本機に残す能力とレンタル Mac で試す能力を分けましょう。

3）初回がポートやネイティブで止まる：ゲートウェイのデフォルト待受とファイアウォール、sharp 等の再ビルドが絡みます。Windows では 18789 と doctor を併読し、WSL2 と PowerShell のホーム分割を誤診しないようにしてください。

02. install.sh／npm／Docker：対照表

詳細手順の正本はマルチプラットフォーム導入ガイドです。ここでは v2026.4.5 文脈の意思決定用に要約します。

観点	公式スクリプト／curl	npm グローバル	Docker
初回までの速さ	高：依存チェック付き	中：PATH と権限が要る	中〜高：イメージが揃っていれば速い
隔離と破棄	中：ユーザーホーム配下	低〜中：グローバル Node と結合	高：コンテナ破棄が容易
ClawHub／マルチモデル	日常開発向き	nvm 運用向き	チーム基線・CI 向き
日払い Mac	クリーン macOS で再現しやすい	グローバルと多ユーザーに注意	ボリュームと秘密注入を確認

03. 安全基線：待ち受け、秘密情報、アップグレード

コンソールとスキルが強く結びつくため、許可リストやリバプロ無しの公網公開は危険です。多ノードは Gateway と SecretRef、本番用量はキー管理とルーティングを参照してください。

症状	先に見る	参照
Needs Setup が残る	鍵、スキル依存、アウトバウンド	Skills 3.24 コンソール
ツール呼び出しがタイムアウト	ディスク IO、DNS、ルーティング劣化	用量ガバナンス
コマンド不明／版ずれ	PATH、nvm、複数ルート	コマンド FAQ

04. 五ステップ：導入から ClawHub スモークまで

単一経路に固定：スクリプト・npm・Docker のいずれかを runbook に記載。nvm 利用時は launchd とシェルを揃えます。
版と doctor：openclaw --version と openclaw doctor を保存し、FAQ と照合します。
onboard 完了：状態ディレクトリ、ポート、コンソール URL を記録。スモーク前にシステム全体プロキシを変えない。
最小マルチモデル＋ ClawHub：1 プロバイダーで会話閉ループ、その後 1〜2 スキル。横断は MCP で承認を。
切り分けとアーカイブ：ポート→PATH→ネイティブ→上流 API。成功後ログを残し、アップグレード／ロールバックと照合。

# 診断例
openclaw --version
openclaw doctor
node -v
which openclaw
lsof -i :18789 | head

05. 指標と誤解

指標 1：2026 年のコミュニティ事例では「インストール失敗」の 35〜50% が最終的に PATH／複数 Node／グローバル bin 未設定 でした。which -a openclaw を先に。
指標 2：初回 onboard から会話スモークまで（スキル依存込み）中央値 25〜55 分 程度の見積もりが現実的です。
指標 3：日払いで破棄する macOS で完走すると、長期混用に比べ主端末への鍵露出リスクを桁で下げるという内部比較表現があります（保証ではありません）。

帯域とレンタル運用は SSH/VNC FAQ、料金は M4 macOS 料金案内、接続は macOS リモート接続ガイドをご覧ください。

install.sh と npm の見えない結合：公式スクリプトはホーム直下に実行ファイルと状態ディレクトリをまとめがちですが、npm グローバルはアクティブな Node プレフィックス（nvm／fnm／システム Node）に CLI を置きます。v2026.4.5 の openclaw doctor は Node のパッチ版、非対話サービスから global bin が見えるか、スキルビルドキャッシュの整合まで見ます。ルートが混ざると設定根の重複や半端なプラグイン索引がログに出て、パッケージが入っていても ClawHub が Needs Setup のままになりがちです。先に which -a openclaw で一本化してください。

Docker 特有の落とし穴：ホストの .env を bind-mount する際、権限や CRLF で読めないことがあります。ゲートウェイを 0.0.0.0 にすると、公開ポートと onboard 記録の URL がズレるとヘルスチェックだけ失敗します。読み取り専用の秘密ボリュームと書き込み可能な状態ボリュームを分け、イメージ差し替え前にゲートウェイを止めて ClawHub キャッシュの競合を避けてください。本番向けの境界は Docker セキュリティ 5 ステップも参照します。

onboard 後のマルチモデル順序：ウィザード完了後、コンソールで 1 プロバイダーが健全になるまで待ち、2 本目をフォールバックや実験ルートにします。未準備のエンドポイントへツール呼び出しが分散すると初回所要が伸びます。ルーティングと予算は用量とキー管理に揃え、リハーサルが本番クォータを食わないようにします。

ネイティブ依存と Node パッチ：sharp など画像系スキルはパッチ更新後に再ビルドが要る場合があります。doctor が ABI 不一致を出したら、メジャーを固定した単一チェーンで再構築し、ホスト npm とコンテナで同じ状態ディレクトリを共有しないでください。Apple Silicon では Rosetta とネイティブ Node の取り違えにも注意します。

安全基線の実装：既定はループバック、TLS はリバプロで終端、ゲートウェイトークンは世界読み取り可能なパスに置かない、が v2026.4.5 の最低ラインです。MCP や高権限スキルを公網ゲートウェイに載せるとリスクはチャット越境に広がります。公開前に公開面と Operator 加固のチェックを回してください。

日払い Mac のリハーサル手順：消去前提の macOS では、インストール（三択一）→ doctor → onboard → 単一プロバイダ会話 → 単一スキルスモーク → からマルチモデル拡張、の順を固定し、ポート・PATH・状態パスをチケットに貼ります。個人用ノート PC の履歴に鍵を残さず、手順だけ持ち帰れます。型にはゼロコンフィグ日払い体験と ClawHub スキル日払いガイドも活用してください。

切り分け順（再掲）：リスナ競合 → 対話シェルとサービスの PATH 差 → ネイティブ再ビルド → 上流 DNS／クォータ。openclaw doctor とゲートウェイ断片を添え、コマンド FAQ の既知文字列と突き合わせます。単一インストール源を守ることが v2026.4.5 をチーム基線に落とす近道です。

06. 選択肢の比較とより良い体験

古いノート PC や Docker Desktop 多忙な Windows では、ポートの幽霊占有や PATH 分裂が起きやすいです。対照的に、ブラウザコンソールとローカルツールを一緒に検証するにはネイティブ macOS が安定しやすいです。

日払いとローカルコスト試算と日払いデプロイの落とし穴を runbook に戻し込み、次のメンバーが同じ混在インストールを繰り返さないようにしてください。

2026 OpenClaw v2026.4.5 完全ガイド：
install.sh・npm・Docker の対照、onboard 後の ClawHub／マルチモデル初回設定と初回トラブルシュート

目次