WindowsでOpenClawをセットアップする方法

Windows環境で新しいツールを導入しようとすると、パスの設定や依存関係の解決に意外と時間が取られてしまうものです。特に、Linuxベースで開発されたツールをWindowsで動かす際は、OS特有の挙動に悩まされることが少なくありません。

OpenClawをWindowsで動かす場合も、スムーズに進めるためのいくつかのコツがあります。私はネイティブのPowerShellとWSL2の両方をテストしましたが、結論から言うとWSL2が唯一の公式に安定したルートです。PowerShellはクイックなテストには向いていますが、いくつかの制限があります。

必要なもの

開始する前に、以下の準備ができているか確認してください。

Windows 10 (version 1903以上) または Windows 11
PowerShell 5.1 以降（最近のWindowsには標準搭載されています）
API key（Anthropic, OpenAI, Googleのいずれか。または無料でローカルモデルを動かせる Ollama）
Node.js（インストールされていない場合は、インストーラーが自動で処理します）

Method 1: PowerShell（手軽な方法）

⚠️ 注意: PowerShellでのネイティブインストールは公式チームによるテストが十分ではなく、ツールの互換性に問題が発生する可能性があります。本番環境での利用には WSL2 を推奨します。

管理者権限で PowerShell を開き、以下のコマンドを実行してください。

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

インストーラーの動作内容

Node.js 22以上がインストールされているか確認し、不足していれば winget/Chocolatey/Scoop 経由でインストールします。また、npm install -g openclaw@latest を実行します。
セットアップウィザードを起動します。

インストール方法の選択

PowerShellインストーラーでは、以下のオプションも指定できます。

# デフォルト: npm install (推奨)
iwr -useb https://openclaw.ai/install.ps1 | iex

# 代替案: GitHubソースからインストール
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git

# gitインストール時のディレクトリ指定
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\openclaw"

Method 2: WSL2（推奨）

OpenClawを本格的に使いたい場合や、最も安定した動作を求める場合は WSL2 を選択してください。Windowsの中に完全な Linux 環境を構築できます。

Step 1: WSL2 のインストール

管理者権限で PowerShell を開き、以下を実行します。

wsl --install

実行後、指示に従ってコンピュータを再起動してください。

Step 1.5: systemd の有効化（必須）

再起動後、Ubuntu を開き、以下の設定を行います。

# OpenClaw Gateway のために systemd を有効にします
sudo nano /etc/wsl.conf

ファイルに以下の内容を追記します。

[boot]
systemd=true

保存（Ctrl+O, Enter, Ctrl+X）したら、PowerShell から WSL を再起動します。

# PowerShellで実行
wsl --shutdown
wsl

Step 2: Ubuntu のセットアップ

再起動後、Ubuntu が自動的に起動します。ユーザー名とパスワードを作成してください。

Step 3: WSL 内で OpenClaw をインストール

Ubuntu のターミナルで以下のコマンドを実行します。

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

これで、適切な Linux 環境で OpenClaw が動作するようになります。

インストール後のセットアップウィザード

インストールが完了すると、セットアップウィザードが自動的に始まります。以下の項目を設定してください。

1. AI Model Provider

Provider	備考
Anthropic (Claude)	総合的に最も優れています。API key が必要です。
OpenAI	コーディングに最適です。
Google Gemini	無料枠があります。
Ollama	100% 無料で、ローカル環境で動作します。

2. Chat Channel

OpenClaw と対話する方法を選択します。

WhatsApp, Telegram, Discord, または iMessage

3. Gateway Daemon

確認画面が出たら、Gateway をデーモンとしてインストールすることを選択してください。

openclaw onboard --install-daemon

これにより、OpenClaw がバックグラウンドで常駐するようになります。

インストールの確認

以下のコマンドで正しく設定されたか確認しましょう。

# バージョンの確認
openclaw --version

# 診断の実行
openclaw doctor

# ダッシュボードを開く
openclaw dashboard

トラブルシューティング

「openclaw は認識されていません」と表示される

npm のグローバル bin フォルダが PATH に含まれていません。

解決策:

# npm の prefix を確認
npm config get prefix

# 表示された結果に \bin を付けたものを PATH に追加してください
# 通常は %AppData%\npm です

設定後、PowerShell を再起動してください。

「spawn git ENOENT」エラー

ソースからインストールする場合、Git for Windows が必要です。

解決策:

git-scm.com/download/win から Git をダウンロードします。
デフォルト設定でインストールします。
PowerShell を再起動してやり直してください。

Node.js のバージョンに関する問題

古い Node.js が入っている場合は、以下の方法で更新してください。

# winget を使う場合
winget install OpenJS.NodeJS.LTS

# Chocolatey を使う場合
choco install nodejs-lts

# Scoop を使う場合
scoop install nodejs-lts

Windows Defender がインストールをブロックする

OpenClaw のディレクトリを除外設定に追加してください。

Windows セキュリティ → ウイルスと脅威の防止を開きます。
「設定の管理」をクリックします。
「除外」項目の「除外の追加または削除」をクリックします。
以下のフォルダを追加します: %AppData%\npm\node_modules\openclaw

解決しない場合は？ 私たちの AI Setup Assistant はすべてのドキュメントを学習しており、Windows 特有の問題をリアルタイムで解決するお手伝いができます。

PowerShell と WSL2 のどちらを選ぶべきか？

項目	PowerShell	WSL2
セットアップ時間	約2分	約10分
安定性	良好	非常に高い
シェルツール	制限あり	Linuxの全ツールが利用可能
アップデート	簡単	簡単
推奨対象	素早く試したい方	ヘビーユーザー

私のアドバイス: まずは PowerShell で試してみてください。もし問題が発生したり、より詳細なコントロールが必要になったりした場合は、WSL2 に切り替えるのが良いでしょう。

次のステップ

インストールガイド全般 → — すべてのプラットフォーム向け
Telegram と連携する → — スマートフォンから操作
Docker でデプロイする → — 隔離されたコンテナ環境での構築
ローカル AI を使用する → — API コストをゼロにする方法

お困りですか？ OpenClaw Discord に参加するか、公式ドキュメントを確認してください。

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。