OpenClaw入門: macOSで最短セットアップして最初の1チャットを通す手順
OpenClawに興味はあるけど、最初の一歩で止まりやすい。
この感覚、めっちゃ自然だと思うんです。
AIまわりのツールって、だいたい最初に概念が多いですよね。
Gateway、channel、node、onboarding。
言葉は並ぶのに、手は止まる。
なのでこの記事は、最初から大きく行きません。
** 今日は「Dashboardで会話が1回通る」までをゴールにします。 **
ここまで行けると、次からは驚くほど楽になります。
設定を覚える作業から、運用を育てる作業に変わるからです。
まずOpenClawって何か
すごく短く言うと、OpenClawは ** self-hostedなAIゲートウェイ ** です。
もう少しだけ噛み砕くと、
- 自分の環境で動かせる
- 複数のチャット導線をまとめて扱える
- AIエージェント運用の土台になる
という感じです。
ここで大事なのは、
** 最初から全機能を使い切る必要はない ** ということです。
まずはローカルで、Dashboardから1回会話する。
これだけで、OpenClawの中核はちゃんと体験できます。
今日の到達点を先に共有
今日やることは4つだけです。
- インストール
- オンボーディング
- ゲートウェイ状態確認
- Dashboardで起動確認
この順番に意味があります。
「情報を理解してから動く」のではなく、
** 動かしながら理解する **。
この順番のほうが、途中で迷いにくいんです。
前提チェック（Node 22+）
まずNodeのバージョンを確認します。
node --version
OpenClaw docsのGetting Startedでは、前提として ** Node 22以上 ** が示されています。
もし古くても、後続のinstall scriptで整うケースはあります。
ただ、先に把握しておくとトラブルの切り分けがしやすい。
ここ、地味ですが効きます。
macOSでインストール
公式の推奨導線はこれです。
curl -fsSL https://openclaw.ai/install.sh | bash
ローカルドキュメント（/opt/homebrew/lib/node_modules/openclaw/docs/start/getting-started.md）でも同じ流れです。
インストーラには細かいオプションがあります。
たとえば --no-onboard など。
ただ初回は、深追いしなくて大丈夫。
** まず王道で通す ** のが一番早いです。
初回設定（onboard）
次にオンボーディングを実行します。
openclaw onboard --install-daemon
ここでは、初期設定と常駐運用の土台づくりをまとめて行うイメージです。
「daemonってまだ早いかな」と感じるかもしれないですが、
後から毎回起動を気にするより、最初に整えておくほうが運用は安定します。
起動確認（status と dashboard）
まず状態確認です。
openclaw gateway status
ここで「動作中」が確認できれば、かなり前進しています。
続いてDashboardを開きます。
openclaw dashboard
ブラウザが開いてControl UIに到達できればOK。
この時点で、
** OpenClawのコア体験はもう手に入っています。 **
first-run workflow（最初の運用の考え方）
ここから先で大事なのは、拡張の順番です。
おすすめはこの流れ。
- Dashboardで1回やり取り
- 使い方の感触を掴む
- 必要になったらチャネル接続を追加
最初からDiscordやTelegram連携まで全部やると、
失敗時の原因が増えて、疲れやすいんですよね。
まず1本通す。
それから広げる。
この順番、シンプルですが強いです。
よくある詰まりと対処
1) openclaw: command not found
- 新しいターミナルを開き直す
- PATH反映を確認する
インストール直後は、シェル環境の反映待ちで見えることがあります。
2) Nodeバージョンが要件未満
node --version
22未満なら、Node更新後に再実行。
3) Gatewayが上がらない
まずは状態確認。
openclaw gateway status
必要なら前面実行でログ確認。
openclaw gateway --port 18789
「何が起きているか」が見えるだけで、解像度が一気に上がります。
最小用語辞典（今日使った分だけ）
- ** Gateway **: OpenClawの中核プロセス。各機能のハブ
- ** onboard **: 初期セットアップの導線
- ** dashboard **: ブラウザから操作するUI
用語は多く見えますが、最初はこの3つで十分です。
まとめ
OpenClawの初回導入で大事なのは、
「情報を全部集めてから始めること」ではないです。
** 小さく動かして、成功体験を先に作ること。 **
今日の流れをもう一回だけ。
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
ここまで通れば、もうスタートラインは超えています。
次は、必要に応じてチャネル連携や運用ルールに進めばいい。
焦らず、一段ずつ積んでいきましょう。