OpenClaw インストール方法：セットアップ完全ガイド（Mac/Windows/Linux）

「インスタント麺が作れるなら、OpenClaw もインストールできます。かかる時間もだいたい同じです。」

今日の目標

ステップ 0: アシスタントを動かす場所を選ぶ

最初の判断はこれです。アシスタントをどのマシンで動かすか。

VPS の推奨スペック: Ubuntu 22.04、2 CPU cores、4GB RAM、40GB SSD。

どの環境を選ぶべき？

• まず試したい → ノート PC（最も簡単。ただし電源が入っている間だけ）
• 24/7 で動かしたい → VPS（$5-10/月。寝ている間も動く）
• 24/7 にしたいがクラウドは使いたくない → Mac Mini または古い PC

どの環境を選んでも、OpenClaw の作業ファイルは通常 ~/.openclaw/workspace/ に置かれ、インストールしたスキルは主に ~/.openclaw/skills/ に保存されます。

このステップの完了条件は、「自分のアシスタントを常時オンラインにしておく正確なマシンはどれか」に答えられることです。

ステップ 1: 前提条件をそろえる

インストーラーを実行する前に、次を準備してください。

Node 22.16 以降（既定で推奨されるランタイムは Node 24）

• 必要な理由: openclaw CLI は Node.js 上で動きます。
• node -v で確認します。Node 22.16 以降なら準備完了です。

AI モデルへのアクセス（1 つ選ぶ）

• Claude subscription (Pro/Max/Team)
  • 必要な理由: アシスタントは各応答とツール実行計画のたびにモデルプロバイダーを必要とします。
  • ウィザードでは OAuth を使うので、貼り付ける API key は不要です。
• Anthropic API key
  • 必要な理由: OpenClaw が Anthropic を直接呼び出すための認証情報です。
  • console.anthropic.com で取得します。
• そのほかにも OpenAI、Gemini、OpenRouter、Qwen、Mistral などをサポートしています。
  • 必要な理由: Claude 以外を使いたい場合でも、対応しているプロバイダーならアシスタントを動かせます。

Telegram Bot Token

1. Telegram を開いて @BotFather を検索します。
2. /newbot を送信し、名前と username を決めます。
3. BotFather が返す token をコピーします。

必要な理由: この token によって、OpenClaw は自分の bot を通じて Telegram の送受信ができます。

あなたの Telegram User ID

• Telegram で @userinfobot を検索し、数値の ID をコピーします。
• 必要な理由: オンボーディングではこの ID を admin として登録し、他人が勝手にアシスタントを操作できないようにします。

このステップの完了条件は、4 つのものを手元に持っていることです。マシン、Node 22.16 以降、モデル用の認証経路 1 つ、そして Telegram の 2 つの値です。

ステップ 2: インストール

次を実行します。

curl -fsSL https://openclaw.ai/install.sh | bash

これが公式のワンライナーです。必要なら OpenClaw と Node をまとめてインストールします。

手動インストールの代替方法:

npm install -g openclaw@latest && openclaw onboard

この手順では CLI を直接インストールし、その後オンボーディングウィザードを起動して、最初の設定を ~/.openclaw/workspace/ に書き込みます。

Platform guide: macOS → Platform guide: Windows → Platform guide: Linux / VPS →

うまくいったかは、command not found ではなくウィザードが開くこと、そしてオンボーディング後に openclaw status でサービス実行中と表示されることで確認できます。

ステップ 3: ウィザードで聞かれること

設定ウィザードでは 5 つの質問に進みます。

1. Mode — 初回インストールなら QuickStart を選ぶ。
2. AI Model — プロバイダーを選び、認証する。
3. Chat Channel — Telegram を選び、Bot Token を貼り付ける。
4. Admin Setup — 自分の Telegram user ID を入力する。
5. Daemon Install — 再起動後もバックグラウンドで動くように yes を選ぶ。

Linux では通常 systemd user unit、macOS では通常 LaunchAgent になります。どちらでも目的は同じで、マシン再起動後に OpenClaw が自動起動することです。

このステップの完了条件は、daemon install がエラーなく終わり、openclaw status が stopped ではなく healthy を返すことです。

ステップ 4: 最初のメッセージを送る

ウィザードが終わったら Telegram で自分の bot を開き、次を送ります。

Hello — who are you?

数秒以内に返信が返ってくるはずです。今は ~/.openclaw/workspace/SOUL.md のようなファイルでまだカスタマイズしていないので、返答はやや汎用的に聞こえます。それは Day 3 で変わります。

ほかにも試してください。

• "Write a Python quicksort"
• "What's the square root of 1024?"
• "Can you check my email?"（今は no と返るはずです）

このステップの完了条件は、Telegram に実際の bot 返信が表示され、openclaw logs --follow にそのメッセージで繰り返しエラーが出ていないことです。

最低限の成功条件

今日の終了時点で、次ができる状態にしておきます。

• openclaw status を実行して稼働中と確認できる
• Telegram でメッセージを送り、応答を受け取れる
• 電源を切って再起動してもサービスが自動で戻る

確認ポイント: 再起動テストは今やってください。後回しにしないこと。サービスが自動復帰しないなら、次に進む前に直します。

日常的に使う管理コマンド

よく使うのは次のコマンドです。

openclaw status           # Overall health
openclaw doctor           # Full diagnostic check
openclaw gateway restart  # Restart background service
openclaw logs --follow    # View runtime logs
openclaw configure        # Change model, channel, or any setting

基本運用に十分かどうかは、次の 2 つにすぐ答えられるかで判断できます。「今動いているか？」と「ログには何が出ているか？」です。

よくある問題

Port already in use — OpenClaw が使いたい port を別プロセスが占有しています。openclaw logs --follow のエラーを見て、競合プロセスを解放し、その後 openclaw daemon restart を実行してください。修正後は bind error が繰り返されず、openclaw status が healthy を返すはずです。

Telegram bot not responding — 多くの場合、bot token の誤り、Telegram user ID の未設定、または daemon が起動していません。openclaw configure または openclaw onboard をやり直してから、新しいテストメッセージを送ってください。bot が返信し、ログに auth failure ではなく受信メッセージが出れば解決です。

Service not starting after reboot — daemon install の工程が失敗したか、スキップされています。openclaw doctor を実行し、必要なら daemon を再インストールしてから、もう一度 reboot を試してください。ログイン直後または server boot 直後に openclaw status が running を返せば直っています。

Full troubleshooting guide →

次にやること

アシスタントは会話できるようになりましたが、まだ性格も運用指示もありません。明日は ~/.openclaw/workspace/ にある中核ファイル、つまり ~/.openclaw/workspace/SOUL.md、~/.openclaw/workspace/USER.md、~/.openclaw/workspace/AGENTS.md、~/.openclaw/workspace/IDENTITY.md を編集して、それを形にします。