GitHub で31万スター超のオープンソース AI アシスタント OpenClaw。Mac・Linux ならワンコマンドで簡単にインストールできます。
📑目次
本記事では、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 経由のみ | ★☆☆ 非推奨 | セキュリティ境界が曖昧、制約が多い |
macOS / Linux へのインストール(推奨)
方法①:インストーラースクリプト(最も簡単)
🏆 おすすめ ― ワンコマンドで完了
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 のインストールについて
まとめ
macOS / Linux ならワンコマンドで簡単インストール
セキュリティのために専用環境(専用 Mac・VPS・Docker)での運用がベスト。
Windows は WSL2 必須で制約が多いため、可能なら Mac か Linux を推奨します。
インストール後は openclaw doctor で設定を確認しましょう。
セキュリティ設定の詳細については、こちらの記事も参考にしてください:
👉 OpenClawは危険?安全に使うための設定と運用ガイド
公式ドキュメント:https://docs.openclaw.ai/install
著者
krona23
IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。







コメントを残す