GitHub で31万スター超のオープンソース AI アシスタント OpenClaw。Mac・Linux ならワンコマンドで簡単にインストールできます。

📑目次
  1. システム要件【2026年最新】
  2. macOS / Linux へのインストール(推奨)
  3. Windows へのインストール(WSL2 必須)
  4. Docker でのインストール
  5. VPS を使ったセットアップ
  6. インストール後の初期設定
  7. アップデート方法
  8. FAQ — OpenClaw のインストールについて
  9. まとめ

本記事では、macOS / Linux / Windows それぞれの環境でのインストール手順を解説します。セキュリティの観点から専用環境での運用を強くおすすめしており、VPS や Docker を使ったセットアップ方法も紹介します。

システム要件【2026年最新】

項目 内容
Node.js Node 24(推奨)または Node 22 LTS(22.16以上)
パッケージマネージャー npm / pnpm / bun いずれか
対応 OS macOS / Linux / Windows(WSL2 経由)

OS 別の対応状況

OS 対応度 推奨度 備考
macOS フル対応 ★★★ 最推奨 ネイティブアプリ、TCC 権限管理、Voice Wake 対応
Linux フル対応 ★★★ 推奨 Docker / K8s での隔離運用に最適
Windows WSL2 経由のみ ★☆☆ 非推奨 セキュリティ境界が曖昧、制約が多い

方法①:インストーラースクリプト(最も簡単)

🏆 おすすめ ― ワンコマンドで完了

Node.js の検出・インストール・初期設定まですべて自動で行われます。最も簡単な方法です。

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

実行すると初期設定ウィザード(onboard)が自動で起動し、Gateway・ワークスペース・チャネル・スキルを対話的に設定できます。macOS では launchd、Linux では systemd にデーモンとして自動登録されます。

方法②:npm / pnpm / bun でインストール

既に Node.js がインストール済みの場合は、パッケージマネージャー経由でもインストールできます。

npm の場合:

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm の場合:

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun の場合:

bun add -g openclaw@latest
openclaw onboard --install-daemon

⚠️ Sharp のビルドエラーが出る場合

システムに libvips がインストールされていると Sharp のビルドに失敗することがあります。以下のように環境変数を設定してください:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方法③:ソースからビルド(開発者向け)

OpenClaw をカスタマイズしたい場合や、開発に参加したい場合はソースからビルドできます。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global

ビルド後に pnpm link --global を実行すると、openclaw コマンドがグローバルで使えるようになります。

Windows へのインストール(WSL2 必須)

⚠️ Windows ネイティブでは動作しません

OpenClaw は Windows ネイティブ環境では動作しません。WSL2(Windows Subsystem for Linux 2)が必須です。また、WSL2 とホスト Windows 間のセキュリティ境界が曖昧なため、筆者としてはWindows での運用はおすすめしません。可能であれば Mac か Linux 環境を推奨します。

WSL2 がセットアップ済みであれば、2つの方法でインストールできます。

方法 A:PowerShell からインストーラーを実行

iwr -useb https://openclaw.ai/install.ps1 | iex

方法 B:WSL2 内で Linux と同じ手順を実行

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

Docker でのインストール

🛡️ セキュリティ重視 ― コンテナで隔離運用

Docker を使えば、OpenClaw をホスト OS から完全に隔離した状態で運用できます。セキュリティを重視する場合に推奨される選択肢です。詳しいセキュリティ設定はOpenClawセキュリティガイドもご覧ください。

  • 公式 Docker ドキュメント:docs.openclaw.ai/install/docker
  • Podman(ルートレスコンテナ)での運用も可能
  • Kubernetes でのデプロイもサポート

VPS を使ったセットアップ

🌐 おすすめ ― 自宅 PC から完全分離

VPS(仮想専用サーバー)を使えば、自宅の PC とは完全に分離された環境で OpenClaw を運用できます。24時間稼働が前提の VPS なら、Gateway の常時稼働にも最適です。

  • 公式ドキュメントでは「サードパーティのマーケットプレイスイメージは避け、クリーンな Ubuntu LTS にインストーラースクリプトを直接実行」を推奨
  • インストール手順は Linux と同じ:curl -fsSL https://openclaw.ai/install.sh | bash
  • 月額数百円〜で始められるサービスも多く、手軽に試せる

インストール後の初期設定

設定の確認

インストールが完了したら、まず以下のコマンドで正しくセットアップされているか確認しましょう。

# 設定の問題を検出
openclaw doctor

# Gateway の状態を確認
openclaw status

# ブラウザインターフェースを起動
openclaw dashboard

基本的な使い方

# Gateway を起動
openclaw gateway --port 18789 --verbose

# エージェントと対話
openclaw agent --message "Hello" --thinking high

# メッセージを送信
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

環境変数の設定(オプション)

必要に応じて以下の環境変数でパスをカスタマイズできます。

環境変数 用途
OPENCLAW_HOME 内部ディレクトリパス
OPENCLAW_STATE_DIR 可変状態の保存場所
OPENCLAW_CONFIG_PATH 設定ファイルの場所

アップデート方法

# 安定版にアップデート
openclaw update --channel stable

# ベータ版に切り替え
openclaw update --channel beta

# 開発版に切り替え
openclaw update --channel dev

OpenClaw はセキュリティ修正が頻繁にリリースされています。定期的なアップデートを強く推奨します。

FAQ — OpenClaw のインストールについて

Node.js のバージョンはどれが必要?

Node.js 24(推奨)または Node.js 22 LTS(22.16以上)が必要です。Node 20 以下では依存関係エラーが多発するため、Node 24 へのアップグレードを推奨します。

Sharp / libvips のビルドエラーが出る

macOS で Homebrew の libvips がインストールされていると発生しやすい問題です。SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest で解決できます。

インストール後に「openclaw: command not found」と出る

npm のグローバル bin ディレクトリが PATH に含まれていません。npm prefix -g で確認し、~/.zshrc~/.bashrc に PATH を追加してください。

npm, pnpm, bun のどれを使うべき?

グローバルインストールには npm が最も安定しています。pnpm はソースビルド/開発向きです。bun は動作しますが、シンボリックリンク解決の問題で Control UI が見つからないケースがあります。

WSL2 内で npm install が失敗する

/mnt/c/(Windows ファイルシステム)からではなく、必ず Linux ネイティブのファイルシステム(例: ~/projects/)で作業してください。Windows パスと WSL の混在が原因の約4割を占めます。

Docker とネイティブインストールはどちらがいい?

macOS/Linux での個人利用ならネイティブ(速くてシンプル)がおすすめです。VPS デプロイやセキュリティ隔離が必要なら Docker を選びましょう。macOS 上の Docker は VM レイヤーのオーバーヘッドがあるため、ローカル用途ではネイティブが有利です。

VPS に必要なスペックは?

最低 2GB RAM / 2 vCPU / 20GB ストレージが必要です。複数エージェントやプラグインを同時利用するなら 4GB RAM を推奨します。

まとめ

macOS / Linux ならワンコマンドで簡単インストール

セキュリティのために専用環境(専用 Mac・VPS・Docker)での運用がベスト。
Windows は WSL2 必須で制約が多いため、可能なら Mac か Linux を推奨します。
インストール後は openclaw doctor で設定を確認しましょう。

セキュリティ設定の詳細については、こちらの記事も参考にしてください:

👉 OpenClawは危険?安全に使うための設定と運用ガイド

公式ドキュメント:https://docs.openclaw.ai/install

krona23

著者

krona23

IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。

DevGENT について →

コメントを残す

Trending

DevGENTをもっと見る

今すぐ購読し、続きを読んで、すべてのアーカイブにアクセスしましょう。

続きを読む