2026 OpenClaw 設置から初回対話まで:全プラットフォーム 10 分ルートマップ、18789 ポートとよくある落とし穴

2026 OpenClaw 設置から初回対話まで:全プラットフォーム 10 分ルートマップ(ポート開放とよくある落とし穴)

約 12 分読了
OpenClaw 10 分入門 openclaw onboard 18789 ポート

OpenClaw をすぐ試したいがどこから始めればいいか分からない?本稿ではインストール前の準備(Node バージョンと 18789 ポート)、3 種類のインストール方法と 10 分ルート選択設置から初回対話までの手順、およびポート/コンソールにアクセスできない 3 つの落とし穴と FAQ をまとめ、Windows・Linux・macOS・リモート Mac のいずれでも約 10 分で初回対話まで到達できるようにします。

インストール前準備:Node バージョンと 18789 ポート

OpenClaw 2026 は Node.js v22 以上が必要です。それ未満だとインストールやビルドが失敗します。nvm の利用を推奨:nvm install 22 && nvm use 22。また、OpenClaw は Web コンソールにデフォルトで 18789 ポートを使用します。クラウドサーバーやリモート Mac を使う場合は、ファイアウォール/セキュリティグループで 18789(TCP)を許可しないとブラウザからコンソールにアクセスできません。

  • Node バージョン:ターミナルで node -v を実行し、v22.0.0 以上であること。
  • ポート 18789:ローカルまたはクラウドホストで入站 18789 を許可。Linux で ufw を使う場合は ufw allow 18789

3 種類のインストール方法と 10 分ルート選択

環境と好みに応じて、以下の 3 つのいずれかを選び、約 10 分でインストール完了とコンソール起動を目指します。

方法 向いている人 目安時間 備考
公式インストールスクリプト 初心者、ローカルや VPS で手軽に試したい 約 5–10 分 curl -fsSL https://openclaw.ai/install.sh | bash。スクリプトが Node を検出・インストール。
npm グローバルインストール すでに Node 22+ がある開発者 約 5–8 分 npm install -g openclaw@latest の後、openclaw onboardopenclaw gateway を実行。
Docker / プリインストールイメージ チームや本番、依存を分離したい場合 約 10–15 分 公式またはコミュニティの Docker イメージを使用し、18789 ポートをマッピング。一部クラウドでは OpenClaw ワンクリックイメージあり。
参照 1:「http://IP:18789 にアクセスできない」の多くはファイアウォールで 18789 が許可されていないため。クラウドではセキュリティグループで入站ルールを追加。
参照 2:npm インストールが固まる・タイムアウトする場合はミラー設定:npm config set registry https://registry.npmmirror.com
参照 3:リモート Mac で VNC 経由で OpenClaw を設置する場合、onboard と権限ダイアログを GUI で完了でき、SSH のみではクリックできないシステムダイアログを避けられる。当サイトの OpenClaw 設置・権限ダイアログ関連記事も参照。

設置から初回対話までの手順

「インストールスクリプト + onboard」の場合の最小手順です。

1

OpenClaw をインストール

curl -fsSL https://openclaw.ai/install.sh | bash または npm install -g openclaw@latest を実行し、完了を待つ。

2

設定ウィザードを実行

openclaw onboard を実行し、Gateway・API などの基本設定を案内に従って完了。権限ダイアログ(macOS など)が出た場合は GUI で許可をクリック。

3

Gateway を起動

openclaw gateway を実行(または systemd/pm2 で常駐)。18789 ポートがリッスンしていることを確認。

4

Web コンソールを開く

ブラウザで http://localhost:18789(またはサーバー IP:18789)にアクセスし、Dashboard を開く。

5

最初のコマンドを送信

コンソールまたは TUI(openclaw tui)で簡単なコマンドを 1 つ送り、モデルと Gateway が応答することを確認すれば「初回対話」完了。

ポートとコンソールにアクセスできない 3 つの落とし穴

「インストールしたがコンソールが開けない」「onboard の途中でエラー」でつまずくことが多いです。原因と対処は以下のとおり。

  1. ファイアウォール/セキュリティグループで 18789 が許可されていない:クラウドではセキュリティグループに TCP 18789 の入站ルールを追加。ローカル Linux で ufw 有効時は ufw allow 18789 の後 reload。
  2. Node バージョンが古い:Node 22+ を満たしていないとインストール・実行でエラーになる。nvm use 22 やシステムのパッケージマネージャでアップグレードして再試行。
  3. デフォルト Token を変更せずスキャンされる:設置後は Dashboard でデフォルトの Gateway Token をすぐ変更し、公網からのスキャン・悪用を防ぐ。システムプロンプト長も確認し、Token 消費の異常を避ける。

FAQ

10 分で本当に初回対話まで行ける?

Node 22+ とネットワークが問題なければ、インストールスクリプトまたは npm グローバルインストールで、onboard → gateway → 18789 コンソールを開く → 1 コマンド送信の流れで、多くのユーザーが 10 分前後で完了できます。ネットワークや権限で問題が出た場合は、当サイトの OpenClaw エラー調査・設置記事を参照してください。

リモート Mac で OpenClaw を入れるメリットは?

リモート Mac はフル GUI(VNC)なので、onboard 時のシステム権限ダイアログや Keychain 確認を直接クリックして完了でき、SSH のみではダイアログを扱えない問題を避けられます。当サイトの他の OpenClaw 設置・権限ダイアログ回避記事とあわせてご利用ください。

openclaw doctor は何をする?

openclaw doctor は環境・依存・設定の健全性をチェックします。起動できない・コンソールがおかしいときは、まず doctor を実行して出力を確認し、当サイトの調査ガイドとあわせて対処してください。

まとめ:ローカル Windows・Linux や自前 VPS でも OpenClaw は動かせますが、Node バージョン・ポート開放・権限ダイアログ・依存環境でトラブルが多く、調査コストがかかります。環境構築の手間を減らし、GUI の onboard とシステム権限まで含めて OpenClaw を手早く試したい場合は、VNCMac のリモート Mac をレンタルし、VNC デスクトップで OpenClaw を設置すると、環境差やダイアログがクリックできない問題を避け、数分で準備済み Mac とグラフィカルな設定が得られます。選定は当サイトの「OpenClaw 環境選型」「クイック開通」ページを参照してください。

Mac ノードと OpenClaw の設置方法を選ぶ

リモート Mac で VNC から OpenClaw を設置し、onboard と権限ダイアログを簡単に完了。数分で開通、従量課金。

  • VNC デスクトップでシステムダイアログ・Keychain に対応、OpenClaw 初回設定に最適
  • 当サイトの OpenClaw 設置・エラー調査記事と連携
  • 時間単位/月額課金、Mac の自前調達やローカル環境の保守不要