OpenClaw 2026 完全インストールガイド：ゼロから始めるパーソナル AI アシスタント

クイック結論（先にインストール方式を決める）

多くの読者は、このルートで進めれば十分です。
個人 PC なら npm、サーバー常時稼働なら Docker、とにかく早く試すなら 1 クリックスクリプト。
Node バージョンとネットワーク環境を先に確認してからインストールすれば、「入らない／何度もやり直す」時間の大半を避けられます。

深夜 2 時、私は画面に表示された 17 個目のエラーメッセージを呆然と見つめていました。

「Cannot find module ‘@anthropic-ai/sdk’」——この赤い文字を、もう 3 日間見続けています。数え切れないオープンソースプロジェクトをいじってきた開発者として、インストール失敗の修羅場は見慣れているつもりでした。しかし OpenClaw のデプロイは、「自信満々」から「人生を疑う」までの心理的プロセスを味わわせてくれました。

正直、Mac Mini でようやく最初の対話に成功したとき、その達成感は初めて “Hello World” を書いたときに匹敵します。OpenClaw は一度構築すれば本当に便利です。WhatsApp、Telegram、Discord、さらには iMessage 上で Claude や GPT-4 といったトップクラスの AI をいつでも呼び出せ、データも完全にプライベートでプライバシー漏洩の心配がありません。

問題は、インストール手順が初心者にはあまり優しくないことです。

このガイドでは大口は叩きませんし、公式ドキュメントの（10 回は目にしたであろう）冗長な説明も並べません。踏んだ落とし穴、試した経路、最終的に成功した方法をそのままお伝えします。Windows ユーザー、Mac 派、サーバーに載せるベテラン、どれにも合う方式があります。Windows では公式インストール手順に ネイティブ Windows と WSL2 の両方が記載され、以下の Linux コマンド手順に揃えるなら WSL2 が扱いやすいことが多いです。

低コスト「エビ飼育」ガイド：ArkClaw で AI Agent を本当に身近に

最近話題の OpenClaw（ロブスタ／エビ）は便利ですが、設定のハードルが高い。ByteDance 火山引擎の ArkClaw はその敷居を一気に下げました。サーバーや Token 設定をいじらず、1 クリックで 24 時間オンライン、ブラウザ操作・スクリプト実行・カレンダー管理ができる「AI 下請け」が手に入ります。

月額 9.9 元と本当に安く、招待コード ZLKUK54M（こちらから登録）なら 8.9 元。プログラマーなら Coding Plan Pro に入ると無料で使える特典もあります。

インストール前の準備：まずは落ち着いて

「1 クリック・インストールスクリプト」を見て興奮してコピペする——ちょっと待ってください。

OpenClaw はシステム環境に厳格な要件があります。これを飛ばすと後で必ず穴に落ちます。公式ドキュメントとコミュニティのフィードバックに基づき、事前に確認すべき事項は以下のとおりです。

Node.js バージョン（公式と一致）

公式インストール手順 では 推奨 Node 24、最低 Node 22.14+ と明記されています。1 クリックスクリプトも未達時に警告します。私は Node 20 で依存関係の落とし穴にハマり、24 に上げたら一気に安定しました。

node --version

v22.14 未満なら、少なくとも v22.14 へ、できれば v24（推奨）へ。Windows も 24.x を優先してください。

OS 互換性

• macOS：12.0 (Monterey) 以降、Intel / Apple Silicon 両対応
• Windows：ネイティブ Windows と WSL2 の両方が公式サポート；完全な体験では公式は WSL2 をより推奨
• Linux：Ubuntu 20.04+、Debian 11+、CentOS 8+ などでテスト実績が多い

API Key の準備

OpenClaw 自体は「ゲートウェイ」にすぎません。Claude (Anthropic)、OpenAI、Google Gemini など具体的な AI サービスを接続しないと使えません。少なくとも 1 つの Claude API Key を用意するのがおすすめです。

中国からアクセスするユーザー向けの補足

npm 公式レジストリは中国では遅いことが多いので、淘宝ミラーへの切り替えを推奨します：

npm config set registry https://registry.npmmirror.com

API 呼び出しも Anthropic / OpenAI は海外ネットワーク環境が必要です。安定した回線がなければ、合規な中継サービスの利用を検討してください。

Railway - モダンなデプロイプラットフォーム、煩わしい運用から解放、数分で公開

今すぐ始める →広告

方式 1：1 クリックスクリプト（最速・5 分）

以下に当てはまるなら、この方式を選んでください：

• OS が macOS、Linux、または WSL2
• とにかく早く試したい、設定は最小限
• システムへの変更を許容できる

インストールコマンド

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

スクリプトが自動で行うこと：

1. Node.js バージョン確認（不足時はアップグレードを促す）
2. openclaw npm パッケージのグローバルインストール
3. 設定ディレクトリ（~/.openclaw/）の作成
4. システムサービスの設定（任意）

インストール後の初期化

openclaw onboard --install-daemon

API Key の入力とデフォルトチャンネル設定を対話形式で進めます。プロンプトに従えば特別な注意点はありません。

インストール確認

openclaw --version

バージョンが表示されれば成功。順調なら本当に 5 分です。

ただし正直、この「1 クリック」スクリプトは私の Ubuntu サーバーで 2 回失敗しました。原因はどちらも権限問題。同様なら焦らず、下の npm 手動インストールを参照してください。

方式 2：npm グローバルインストール（柔軟・日常使用に最適）

私が最もよく使い、最も推奨する方式です。手順はやや多いですが、障害時の切り分けが容易で、システムへの侵襲も小さいです。

ステップ 1：Node.js 環境の確認

# バージョン確認
node --version

# バージョン不足なら nvm を推奨
# macOS / Linux で nvm インストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Node 24 をインストール
nvm install 24
nvm use 24

ステップ 2：OpenClaw のインストール

npm install -g openclaw@latest

@latest で最新版を確実に取得。OpenClaw は更新が頻繁で、2026 年 2 月時点では v2026.2.24 まで到達しています。

EACCES 権限エラー（macOS で多い）が出たら、npm グローバルディレクトリの権限が未設定です。修正方法：

# 専用ディレクトリ作成
mkdir ~/.npm-global

# npm に新ディレクトリを使わせる
npm config set prefix '~/.npm-global'

# PATH に追加
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 再インストール
npm install -g openclaw@latest

ステップ 3：初期設定

openclaw onboard --install-daemon

対話ウィザードで以下を設定します：

1. AI プロバイダー選択（Claude、OpenAI、Gemini など）
2. 対応する API Key 入力
3. メッセージチャンネル（Telegram Bot、Discord など）
4. システムサービス化（任意だが推奨）

ステップ 4：Gateway の起動と確認

openclaw onboard --install-daemon 済みなら、多くの場合 Gateway サービスは登録済みです。まず状態を確認：

openclaw gateway status

フォアグラウンドでログを見ながら動かす場合：

openclaw gateway

インストール済みシステムサービスを明示的に起動／停止する場合（公式 CLI と一致）：

openclaw gateway start
openclaw gateway stop

方式 3：Docker インストール（安全・サーバー向け）

VPS、NAS、長期安定稼働が必要な環境なら Docker が最適です。コンテナ隔離で AI エージェントの誤操作がホストに波及するのを防げます。冗談ではなく、OpenClaw インスタンスがファイルを誤削除した事例もあります。

ステップ 1：Docker 環境の確認

docker --version
docker-compose --version

厳密なバージョン要件はありませんが、Docker 20.10+ を推奨します。

ステップ 2：設定ディレクトリの作成

mkdir -p ~/openclaw-data/config
mkdir -p ~/openclaw-data/data

ステップ 3：Docker Compose ファイルの準備

Vultr - 高性能NVMeクラウドサーバー、世界32拠点、Dockerワンクリック展開対応

価格を見る →広告

# docker-compose.yml
version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ~/openclaw-data/config:/app/config
      - ~/openclaw-data/data:/app/data
    environment:
      - NODE_ENV=production
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}

ステップ 4：環境変数の設定

# .env ファイル作成
cat > ~/openclaw-data/.env << EOF
ANTHROPIC_API_KEY=your_claude_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
EOF

ステップ 5：コンテナ起動

cd ~/openclaw-data
docker-compose up -d

ステップ 6：ログで状態確認

docker logs -f openclaw

OpenClaw Gateway started on port 3000 が表示されれば成功です。

Docker 方式のもう一つの利点：Mac Mini、Raspberry Pi など Docker が動くデバイスに載せ、スマホの Telegram や WhatsApp からいつでも呼び出せます。多くの人にとってこれが OpenClaw の主な使い方です。

Windows：WSL2 詳細手順（任意パス）

WSL2 を選ぶ場合、本文の Linux 手順に揃えるときの落とし穴です。ネイティブ Windows も公式サポートされていますが、必要に応じてインストールドキュメントを参照してください。

落とし穴 1：WSL バージョンが古い

# WSL バージョン確認
wsl --list --verbose

Version 1 ならアップグレードが必要：

# PowerShell（管理者）で実行
wsl --set-version Ubuntu 2

落とし穴 2：WSL2 メモリ不足

OpenClaw は一定のメモリを消費します。WSL2 既定設定では不足することがあります。Windows ユーザーディレクトリに .wslconfig を作成：

[wsl2]
memory=4GB
processors=2

WSL を再起動：

wsl --shutdown

落とし穴 3：Windows ファイアウォール

Windows ブラウザから WSL2 内の OpenClaw Web UI にアクセスする場合、ファイアウォールで該当ポートを許可する必要があるかもしれません。

Mac Mini で OpenClaw を動かす

Mac Mini は低消費電力・静音・性能十分で、OpenClaw 運用に最適な構成です。私の M1 Mac Mini は 3 ヶ月間安定稼働しています。

M シリーズチップの注意点

Docker イメージは ARM64 対応版を選びます。最新 OpenClaw 公式イメージは Apple Silicon をネイティブサポートし、Rosetta 不要です。

# docker-compose.yml でプラットフォーム指定（通常不要、プル失敗時に試す）
services:
  openclaw:
    platform: linux/arm64
    image: openclaw/openclaw:latest

バックグラウンド常駐

macOS では launchd での管理を推奨。--install-daemon で plist が自動作成されますが、手動インストール時は自分で設定が必要な場合があります：

# サービス状態確認
launchctl list | grep openclaw

# 手動ロード
launchctl load ~/Library/LaunchAgents/ai.openclaw.daemon.plist

OpenClaw よくあるエラーのトラブルシューティング

手順通りでも問題は起きます。頻出エラーと対処法：

エラー 1：「Cannot find module」系

原因：npm インストール不完全またはバージョン非互換

対処：

npm uninstall -g openclaw
npm cache clean --force
npm install -g openclaw@latest

エラー 2：「EACCES: permission denied」

原因：npm グローバルディレクトリの権限問題

対処：前述 npm インストール章の権限修正手順を参照

KiloClaw - 企業向けマネージド OpenClaw、AI エージェントのオーケストレーションとスマートルーティングを加速

今すぐ始める →広告

エラー 3：API 呼び出しが 401 / 403

原因：API Key 無効または利用枠枯渇

確認：

# 設定確認
openclaw config get

# 再設定
openclaw config set anthropic.apiKey=your_new_key

エラー 4：Docker コンテナが再起動を繰り返す

原因：環境変数ミスまたはポート競合

確認：

# 詳細ログ
docker logs openclaw

# ポート占有確認
lsof -i :3000

エラー 5：メッセージチャンネルから応答がない

原因：Webhook 設定ミスまたはネットワーク不通

確認：

• Telegram：Bot Token と Webhook URL の到達性
• Discord：Bot 権限と Intents の有効化
• 制限のあるネットワーク環境：Telegram / Discord サーバーへの到達性

インストール後のおすすめ設定

1. 複数 AI プロバイダーの設定

Claude と GPT-4 の両方を設定すると、一方が不安定なとき自動切り替えできます。

2. システム全体ショートカット

macOS は Alfred + Workflow、Windows は PowerToys Run でグローバル呼び出しを。

3. 設定の定期バックアップ

# 設定は ~/.openclaw/ に保存
cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)

4. 稼働状態のモニタリング

Docker デプロイにはヘルスチェック追加を推奨：

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 10s
  retries: 3

まとめ

まだ方式に迷っているなら：

• 最速で試す → 1 クリックスクリプト
• 日常の主力 → npm グローバルインストール
• サーバー常時稼働 → Docker

OpenClaw のインストールは想像ほど難しくありません。多くの「落とし穴」はドキュメントの分かりにくさやエラーメッセージの不明確さが原因です。このガイドが遠回りを減らす助けになれば幸いです。

余談ですが、OpenClaw をデプロイすることは単なるソフトウェア導入以上の意味を持ちます。データをプライベートに保ち、自主的にコントロールし、特定プラットフォームに縛られない——AI 能力が強化される今、この「主権意識」は想像以上に重要かもしれません。

さあ、試してみてください。ドキュメントにない問題があればコメント欄で——私が踏んだ穴は、おそらく想像以上に多いです。

次に読む

• OpenClaw インストール障害トラブルシューティング：Node、Docker、WSL2、API エラー
• OpenClaw 設定完全ガイド：openclaw.json の読み方
• OpenClaw セキュアデプロイ完全ガイド：5 層防御