Contents
WindowsでOpenClawを導入する前に確認すべきシステム要件
現在、OpenClawの安定した動作にはNode.js 22以上が必須です。これは、プロジェクトが頻繁に更新される特性上、最新バージョンのNode.jsがAPIの互換性やパフォーマンスを保証するためです。また、OSについてはWindows 10/11が対応しており、メモリは最低8GB以上を推奨します。これはモデルの複雑化に伴う処理負荷に対応するためで、特に大規模なデータ処理を行う場合は16GB以上が望ましいです。
Node.js 22以上のインストール確認
Node.jsバージョンを確認するには、コマンドプロンプトまたはPowerShellを開き、以下を実行します：
|
1 2 3 |
node -v npm -v |
v22.0.0以上が表示されない場合は、後述の手順で最新版をインストールしてください。
推奨されるOSバージョンとメモリ制限
- Windows 10（21H2以降）または Windows 11（23H2以降）が推奨されます。
- メモリは8GB以上を前提としていますが、複数のタスクを並行して実行する場合は16GB以上を用意してください。
Node.jsのインストール方法比較
Node.jsの導入には、パッケージマネージャーによるインストールが効率的です。winget、Chocolatey、Scoopそれぞれに特徴があり、開発環境の管理スタイルや手順によって選択肢が分かれます。以下に比較表を示します。
| ツール | 特徴 | 推奨用途 |
|---|---|---|
| winget | Windows公式サポート、簡単なコマンド | 初心者向け、素早く導入したい場合 |
| Chocolatey | 管理型インストール、バージョン管理可能 | 企業環境や複数プロジェクトを管理する場合 |
| Scoop | カスタム環境構築に強い | 高度なカスタマイズが必要な開発者向け |
wingetによる公式インストーラー利用
-
PowerShellを管理者として実行し、以下を入力：
bash
winget install --id=OpenJS.Node.js -v 22.0.0 -
インストールが完了したら、
node -vでバージョンを確認してください。
Chocolateyでの管理型インストール
- Chocolateyのインストールが済んでいない場合は、以下のコマンドで導入：
bash
Set-ExecutionPolicy Bypass -Scope CurrentUser -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager+SecurityProtocolType]::Tls12, [System.Net.ServicePointManager+SecurityProtocolType]::Tls13; iex (Invoke-WebRequest -UseBasicParsing https://community.chocolatey.org/install.ps1)
注意: Chocolateyのインストールスクリプトは信頼できるソースから実行する必要があります。不正なスクリプトの実行はセキュリティリスクを伴います。
- Node.jsのインストール：
bash
choco install nodejs --version 22.0.0
Scoopを用いたカスタム環境構築
-
Scoopを導入（PowerShellで実行）：
bash
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | Invoke-WebRequest -OutFile C:\scoop.ps1; & C:\scoop.ps1 -
Node.jsのインストール：
bash
scoop install nodejs
npmコマンドでOpenClawをグローバルインストールする手順
npmを用いたOpenClawのインストールは、Node.jsが正しく導入されている前提で簡単に行えます。ただし、事前の準備とエラー時のチェックポイントに注意が必要です。
npmのバージョン確認と更新
-
コマンドプロンプトまたはPowerShellを開き、以下のコマンドを実行：
bash
npm install -g npm@latest -
npm -vで最新版がインストールされているか確認してください。
openclaw@latestのインストールコマンド実行
-
OpenClawをグローバルにインストールするには、以下を入力：
bash
npm install -g openclaw@latest -
インストールが完了したら、
openclaw --versionでバージョンを確認してください。
注意点
- 権限不足エラーが発生した場合、管理者としてコマンドプロンプトを開いて再度実行してください。
- ネットワーク環境によっては、npmの設定（
npm config set proxy）が必要な場合があります。
セットアップウィザードのオプション設定ガイド
OpenClawをインストールした後、セットアップウィザードを起動することで、追加の設定や機能を有効化できます。特にインストール先パスと環境変数自動設定は初期設定でよく間違えるポイントです。
インストール先パスのカスタマイズ
- デフォルトでは
C:\Program Files\OpenClawにインストールされます。 - 特定のプロジェクトごとに別途導入したい場合は、Custom Install Pathを選択し、任意のディレクトリを指定してください。
環境変数自動設定の有無選択
- Onを選択すると、システム環境変数にOpenClawが自動で追加され、コマンドラインから直接実行可能になります。
- Offを選択した場合は、手動でPATHを編集する必要があります（例：
C:\Program Files\OpenClaw\binを追加）。
Docker vs WSL2でのOpenClaw導入比較
DockerやWSL2は、複数の開発環境を管理する際の選択肢として有効です。それぞれの特徴を理解し、自分のシーンに合った方法を選んでください。
Dockerイメージのプル手順
- Docker Desktopがインストールされていることを確認します（公式サイトより導入）。
- コマンドプロンプトで以下を実行：
bash
docker pull openclaw/ai:latest
注意: Dockerイメージ名
openclaw/ai:latestの正当性は、公式リポジトリまたはプロジェクトドキュメントで確認してください。
- 実行例：
bash
docker run -it openclaw/ai:latest bash
WSL2環境構築の簡単な流れ
- Windows 10/11でWSL2を有効化（公式ガイド参照）。
- UbuntuなどのLinuxディストリビューションをインストールします。
- Node.jsとOpenClawをWSL環境内で導入：
bash
sudo apt update && sudo apt install nodejs npm
npm install -g openclaw@latest
| メリット | Docker | WSL2 |
|---|---|---|
| クロスプラットフォーム性 | 高（Linux/macOS環境と互換性あり） | 中（Windows専用だが、一部Linuxツールが利用可能） |
| 開発コスト | 中（イメージサイズが大きい場合あり） | 低（Lightweightな設定が可能） |
| リモートデバッグ | 簡易（ネットワーク経由で接続可能） | 高（完全なLinux環境が利用可能） |
OpenClaw導入時のよくあるエラーと対処法
最新バージョンでも発生する代表的なエラーには、権限不足や依存関係の不整合があります。以下にQ&A形式で解決策をまとめました。
Q1: 「Permission denied」エラーが発生します
A: 管理者としてコマンドプロンプトを開いて再度実行してください。または、npm install -g openclaw@latest --prefix ~/.openclawのようにローカルプレフィックスを指定し、システムパスに依存しないようにインストールしてください。
Q2: 「Dependency error」が表示されます
A: 以下のコマンドで依存関係を再構築します：
|
1 2 |
npm install -g openclaw@latest --force |
または、npm cache clean --forceでキャッシュを削除し、再度インストールしてください。