5 分でインストール: OpenClaw 初回起動をスムーズに終わらせるガイド
4 min read
多くのチュートリアルは、まさにこの段階で人を置いていきます。この記事の目標はひとつ。最初の一回で成功することです。
このページで学べること
- インストール前の前提条件の確認
- OpenClaw のインストール
- オンボーディング完了と最初のアシスタント作成
- ダッシュボードを開くところまで
インストール前に確認する 2 点
必要なものは多くありませんが、この 2 つは必須です。
1. Node.js（LTS 版）
node --version
# バージョンが表示されれば OK2. AI モデル用の API key
Anthropic Claude や OpenAI などのクラウドモデルを使うなら API key が必要です。完全オフラインにしたいならローカルモデルでも構いません。この連載ではクラウドモデルを前提に進めます。
💡 API key の取得方法が分からない場合は「Anthropic API key」などで検索すれば、だいたい数分でたどり着けます。
OpenClaw をインストールする
公式ドキュメントでは git ベースのインストール方法 が推奨されています。あとで更新やデバッグがしやすいからです。
macOS / Linux
# docs.openclaw.ai の Quick Start の手順に従う
# 多くの場合は 1 行の curl スクリプトで始められるWindows
# まず Git が入っていて PATH に通っているか確認
git --version
# その後 docs.openclaw.ai の Windows 手順に従う⚠️ 「git not found」や「openclaw が認識されない」で止まる場合は、Git を PATH に追加してターミナルを再起動してください。
初回起動: アシスタントを誕生させる
インストール後、次を実行します。
openclaw gateway初回実行ではオンボーディングウィザード が起動し、次のようなことを聞かれます。
- どの AI モデルを使うか
- API key は何か
- ワークスペースをどこに置くか
入力が終われば、最初のアシスタントがその場で生まれます。
💡 「wake up my friend」のまま長く止まる場合は、API key、ネットワーク、ターミナルのエラーメッセージを確認しましょう。
オンボーディングが終わると何ができる？
- ダッシュボードログイン用の token
- 基本設定ファイル
~/.openclaw/openclaw.json - すでに動き始めている最初の AI アシスタント
ダッシュボードを開く
Gateway を動かしたまま、ブラウザで次を開きます。
http://127.0.0.1:18789/
よくある表示
| 表示 | 対処 |
|---|---|
pairing required |
openclaw devices list の後に openclaw devices approve <id> |
| token を要求される | オンボーディングでもらった token を貼る |
| 反応がない | openclaw gateway が動いたままか確認 |
次へ
これでアシスタントが自宅にやってきました。次はログイン周りとダッシュボード UI を分かりやすく整理します。