最終更新: 2026年3月読了 12分

2026年版 OpenClaw のインストール方法

4つの方法、目的は1つ。あなたが管理するハードウェアで動く自分専用のAIアシスタント。スキルレベルに合った方法を選び、10分以内に始めましょう。

インストールはプロに任せたいですか?

ターミナルは不要。当社のチームがあなたのために OpenClaw をインストール、セキュリティ強化、設定します。プランは $169 から。

プランを見る

前提条件

OpenClaw をインストールする前に、サーバーが最低要件を満たしていることを確認してください。要件を下回ると応答が遅くなり、プロセスがクラッシュし、利用者の不満につながります。

CPU

最低 vCPU 2コア。マルチチャネル運用なら 4コア推奨。

RAM

最低 4 GB。Ollama でローカル LLM を動かす場合は 8 GB 推奨。

ストレージ

最低 20 GB SSD。メモリデータベースとログは時間とともに増加します。長期運用なら 50 GB を見込んでください。

OS

Ubuntu 22.04+、Debian 12+、または Docker 対応の任意の Linux。macOS と Windows (WSL2) でも動作します。

また、以下も必要です

  • SSH アクセス サーバーへの。 `ssh root@your-server-ip` を実行できれば問題ありません。
  • AIモデルの APIキー Anthropic、OpenAI、Google、または Ollama 経由のローカルモデルのいずれか。開始前に用意してください。
  • ドメイン名 (任意)。必須ではありませんが、SSL とクリーンな webhook URL のために推奨します。
VPS をお探しですか? Hetzner (CX22 約 $4.50/月) または DigitalOcean (Basic Droplet $6/月) をおすすめします。どちらも最低要件を上回ります。

1.ワンライナー (推奨)

OpenClaw を最速でインストールする方法。依存関係チェック、ダウンロード、設定ウィザード、サービス登録までを1コマンドで処理します。Ubuntu、Debian、CentOS、Fedora、Arch、macOS に対応。

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

インストーラが行うこと

1

OSとパッケージマネージャーを自動検出

2

Node.js 20 LTS が無ければインストール

3

依存解決を高速化する pnpm をグローバルインストール

4

最新の安定版 OpenClaw リリースをダウンロード

5

対話型の設定ウィザードを実行

6

systemd サービス (Linux) または launchd エージェント (macOS) を作成

7

OpenClaw を起動し、稼働状態を確認

想定される出力

[info] Detecting OS... Ubuntu 22.04 (x86_64)
[info] Node.js v20.18.1 found
[info] Installing pnpm...
[info] Downloading OpenClaw v2026.3.8...
[info] Running configuration wizard...
   → AI Provider: anthropic
   → Model: claude-sonnet-4-5
   → Port: 3100
[ok]   OpenClaw is running at http://localhost:3100
       Dashboard: http://localhost:3100/dashboard
インストーラは必要以上の権限では実行されません。実行前にスクリプトのソースを確認することを推奨します。これはすべてのパイプスクリプトで推奨される慣行です。

カスタムフラグ

対話型ウィザードをスキップして、フラグでインストールをカスタマイズします。

# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
  --provider anthropic \
  --model claude-sonnet-4-5 \
  --port 3100 \
  --no-systemd

2.npm / pnpm

全工程をコントロールしたい開発者向け。各ステップを明示的に確認できます。

ステップ 1 — Node.js 20+ をインストール

OpenClaw には Node.js 20 以上が必要です。まずバージョンを確認してください。

node --version
# If below v20, install via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

ステップ 2 — pnpm をインストール

npm install -g pnpm

ステップ 3 — OpenClaw をグローバルにインストール

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

ステップ 4 — 設定を初期化

init コマンドは現在のフォルダに `.env` ファイルと `data/` ディレクトリを作成します。

mkdir ~/openclaw && cd ~/openclaw
openclaw init

ステップ 5 — `.env` ファイルを編集

.envenv
# ~/openclaw/.env
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
# Or for OpenAI:
# AI_PROVIDER=openai
# AI_MODEL=gpt-5
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

ステップ 6 — OpenClaw を起動

openclaw start
# Or run in background:
openclaw start --daemon
`openclaw logs` でリアルタイムの出力を確認できます。`--follow` を付ければ新しいエントリをストリーミングします。

3.Docker

Docker はホストシステムから OpenClaw を分離します。アップデートは新しいイメージを pull して再起動するだけ。本番サーバーやチーム運用に最適です。

ステップ 1 — Docker をインストール

# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group changes to take effect

ステップ 2 — docker-compose.yml を作成

docker-compose.ymlyaml
version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - ./data:/app/data        # Persistent memory & databases
      - ./config:/app/config    # Configuration files
      - ./.env:/app/.env        # Environment variables
    environment:
      - NODE_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

ステップ 3 — `.env` ファイルを作成

.envenv
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Optional: Enable persistent memory
MEMORY_ENABLED=true
MEMORY_PROVIDER=sqlite

# Optional: WhatsApp channel
WHATSAPP_ENABLED=false
WHATSAPP_PHONE_ID=
WHATSAPP_TOKEN=

ステップ 4 — コンテナを起動

docker compose up -d

# Check the logs
docker compose logs -f openclaw

Docker でのアップデート

docker compose pull
docker compose up -d
必ず `data/` ディレクトリをバインドマウントしてください。ボリュームが無いとコンテナ再起動時にメモリと会話履歴がすべて失われます。

4.ソースから

コア動作の改変、アップストリームへの貢献、プレリリースブランチの実行が必要な場合に。開発者経験が必要です。

ステップ 1 — リポジトリをクローン

git clone https://github.com/openclaw/openclaw.git
cd openclaw

ステップ 2 — 依存関係をインストール

# Requires Node.js 20+ and pnpm
pnpm install

ステップ 3 — 環境ファイルをコピーして編集

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

ステップ 4 — ビルドして起動

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

ソースからのアップデート

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service
ソースからのビルドは TypeScript を JavaScript にコンパイルします。ハードウェアにより 30〜90秒かかります。2回目以降はキャッシュにより高速化されます。

インストール後の作業

OpenClaw が動いています。次は AI モデルを設定し、メッセージングチャネルを接続して、すべてが動くことを確認します。

AI モデルの設定

OpenClaw は複数の AI プロバイダーに対応しています。`.env` ファイルまたはダッシュボードで好みのモデルを設定してください。

プロバイダーモデルコスト / メッセージ
AnthropicClaude Opus 4.6, Sonnet 4.5, Haiku 4.5$0.001 – $0.05
OpenAIGPT-5, GPT-5 mini$0.002 – $0.03
GoogleGemini 3 Pro, Gemini 3 Flash$0.001 – $0.02
DeepSeekDeepSeek V3~$0.005
MistralMistral Large~$0.01
Ollama (local)Llama 4, Qwen 3, Mistral, and any GGUF modelFree
.envenv
# Example: Switch to Claude Opus 4.6
AI_PROVIDER=anthropic
AI_MODEL=claude-opus-4-6
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Example: Use a local model via Ollama
AI_PROVIDER=ollama
AI_MODEL=llama4:8b
OLLAMA_HOST=http://localhost:11434
テスト中は Haiku 4.5 や Gemini 3 Flash のような安価なモデルから始め、チャネルとメモリを設定してから強力なモデルに切り替えるのがおすすめです。

最初のチャネルをセットアップ (WhatsApp の例)

OpenClaw は 191+ の連携をサポートしています。最も人気のある WhatsApp を例に接続方法を紹介します。

1

Meta Business アプリを作成

developers.facebook.com にアクセスし、新しい Business アプリを作成。WhatsApp プロダクトを有効化します。

2

Phone Number ID と トークンを取得

WhatsApp API 設定で Phone Number ID をコピーし、永続的なアクセストークンを生成します。

3

認証情報を `.env` に追加

.envenv
WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string
4

Webhook URL を設定

Meta のダッシュボードで webhook URL を `https://your-domain.com/api/webhook/whatsapp` に設定し、ステップ3の verify token を使います。

5

OpenClaw を再起動してテストメッセージを送信

openclaw restart
# Or with Docker:
docker compose restart openclaw

最初のメッセージを送る

WhatsApp で接続済みの番号に「Hello」と送ってください。2〜5秒以内に応答があるはずです。WhatsApp 未設定ならダッシュボード経由でテストしてください。

# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, what can you do?"}'

成功すると JSON で AI の返答が返ります。エラーが出た場合は下のトラブルシューティングを参照してください。

よくあるエラーと対処法

インストール問題のほとんどは5つのカテゴリーに収まります。それぞれの修正方法を以下に示します。

Error: ポート 3100 が既に使用中

別のプロセスがデフォルトの OpenClaw ポートを占有しています。

# Find what is using port 3100
sudo lsof -i :3100

# Option A: Kill the process
sudo kill -9 <PID>

# Option B: Change OpenClaw's port
# In .env, set:
OPENCLAW_PORT=3200

Error: Node のバージョン不一致

OpenClaw は Node.js 20 以上が必要です。古いバージョンでは起動時に構文エラーが発生します。

# Check your current version
node --version

# If below v20, upgrade with nvm:
nvm install 20
nvm alias default 20
nvm use 20

# Verify
node --version  # Should show v20.x.x or higher

Error: Docker permission denied

「permission denied while trying to connect to the Docker daemon socket」と表示されます。

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in, then verify:
docker ps
# If you still get errors, restart the Docker service:
sudo systemctl restart docker

Error: SSL 証明書の問題

Meta などの webhook プロバイダーは HTTP エンドポイントを拒否します。HTTPS が必要です。

# Install Certbot and get a free Let's Encrypt certificate
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

# Auto-renewal is configured automatically
# Test renewal:
sudo certbot renew --dry-run
Cloudflare の背後にいる場合、SSL モードを「Full (Strict)」にして、Let's Encrypt の代わりに Cloudflare Origin Certificate を使います。

Error: メモリ不足 / プロセスが kill される

RAM が不足すると Linux の OOM killer が OpenClaw を終了させます。

# Check available memory
free -h

# Option A: Add swap space (quick fix)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Option B: Upgrade your VPS to 4+ GB RAM

# Option C: Use a lighter AI model
# In .env, switch from Opus to Haiku:
AI_MODEL=claude-haiku-4-5

AI モデル自体はリモートで API 経由で動きます。メモリ問題は OpenClaw のメモリ DB と Node.js プロセスから来るもので、モデルではありません。4 GB RAM が現実的な最低ラインです。

インストール後のセキュリティ

セキュリティを設定していない OpenClaw は負債です。公開インスタンスの 93.4% が基本認証を欠き、42,665 件がインターネット上で公開されているという調査結果があります。その統計の一部にならないでください。

セキュリティチェックリスト (簡易版)

  • `.env` で認証を有効化: AUTH_ENABLED=true、AUTH_SECRET に 32文字のランダム文字列を設定
  • UFW ファイアウォール設定: ポート 22 (SSH)、80 (HTTP)、443 (HTTPS) のみ許可
  • Let's Encrypt または Cloudflare Origin Certificate で SSL/TLS をセットアップ
  • 本番ではダッシュボードを無効化、または認証で保護
  • OpenClaw を最新に保つ: 毎週 `openclaw update` または `docker compose pull`
  • OpenClaw の前段に Nginx または Caddy などのリバースプロキシを置く
  • ポート 3100 は決してインターネットに直接公開しない
# Quick firewall setup (Ubuntu/Debian)
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

# Verify
sudo ufw status

これは簡易版です。当社が全てのクライアント環境で適用する12項目のフルセキュリティ監査については、こちらをご覧ください: セキュリティガイド & セキュリティチェックリスト.

よくある質問

お手伝いが必要ですか?

当社チームがあなたのサーバーに OpenClaw をインストール、セキュリティ強化、設定します。永続メモリ、マルチチャネル設定、12項目セキュリティ監査込み。