2026年8月20日更新
📑目次
OpenClaw公式インストーラーの現行ドキュメントでは、Node.js 22.22.3以上、24.15以上、または25.9以上が対応ラインです。macOS/Linuxの新規セットアップではNode 26が導入される場合があります。Windowsは公式のPowerShellインストーラー(install.ps1)も案内されているため、OSやリリースにより手順を選んでください。公式インストーラー仕様を基準に確認してください。
GitHub で31万スター超のオープンソース AI アシスタント OpenClaw。Mac・Linux ならワンコマンドで簡単にインストールできます。
本記事では、macOS / Linux / Windows それぞれの環境でのインストール手順を解説します。セキュリティの観点から専用環境での運用を強くおすすめしており、VPS や Docker を使ったセットアップ方法も紹介します。
システム要件【2026年最新】
| 項目 | 内容 |
|---|---|
| Node.js | Node 22.22.3以上、24.15以上、または25.9以上(対応ライン) |
| パッケージマネージャー | npm / pnpm / bun いずれか |
| 対応 OS | macOS / Linux / Windows(WSL2 経由) |
OS 別の対応状況
| OS | 対応度 | 推奨度 | 備考 |
|---|---|---|---|
| macOS | フル対応 | ★★★ 最推奨 | ネイティブアプリ、TCC 権限管理、Voice Wake 対応 |
| Linux | フル対応 | ★★★ 推奨 | Docker / K8s での隔離運用に最適 |
| Windows | ネイティブ対応(公式PowerShellインストーラー)/ WSL2 も可 | ★★☆ 対応 | 2026年に 公式PowerShellインストーラー(管理者権限不要のネイティブアプリ)が追加され導入しやすくなった |
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 へのインストール
🆕 2026年アップデート ― ネイティブ対応
以前は Windows ネイティブでは動作せず WSL2 が必須でしたが、2026年に公式PowerShellインストーラー(WinUI 製の公式ネイティブアプリ)が追加され、管理者権限なしでインストールできるようになりました。用途に応じて以下の3つの方法から選べます。
方法 A:公式PowerShellインストーラー(推奨・GUI)
Windows 10 20H2 以降・Windows 11 対応のネイティブアプリ。OpenClaw の GitHub リリースページから署名済みの x64 / ARM64 インストーラーをダウンロードします。システムトレイ常駐、チャット画面、Command Center での診断機能を備え、初回起動時に自動で専用の WSL Gateway をセットアップします(既存の Ubuntu 環境には影響しません)。
方法 B:PowerShell CLI インストーラー(ターミナル操作向け)
iwr -useb https://openclaw.ai/install.ps1 | iex
インストール後は以下で動作確認します。
openclaw --version
openclaw doctor
openclaw gateway status --json
方法 C:WSL2 Gateway(Linux 互換性重視・サーバー用途向け)
最も Linux 互換性の高い実行環境が必要な場合や、ヘッドレスサーバーとして常時稼働させたい場合は WSL2 が引き続き選択肢になります。WSL2 とホスト Windows 間のセキュリティ境界は曖昧な点があるため、セキュリティを重視するなら専用環境(VPS・Docker)での運用も検討してください。
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 gateway 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 は 2026年に追加された 公式PowerShellインストーラー(ネイティブアプリ)または WSL2 経由で導入できます。
インストール後は openclaw doctor で設定を確認しましょう。
セキュリティ設定の詳細については、こちらの記事も参考にしてください:
👉 OpenClawは危険?安全に使うための設定と運用ガイド
公式ドキュメント:https://docs.openclaw.ai/install
著者
krona23
IT業界20年以上の実務経験を持ち、日本国内有数のPVを誇る大規模Webサービスで事業部長・CTOを複数社で歴任。Windows/iOS/Android/Webと技術の変遷を経験し、現在はAIネイティブへの変革に注力。DevGENTでは、AIコードエディタ・自動化ツール・LLMの実践的な使い方を日英西3言語で発信中。










コメントを残す