Windows環境でOpenClawをインストールする詳細ガイド

はじめに

OpenClaw は、オープンソースのセルフホスト型AIアシスタントプラットフォームです。WhatsApp、Telegram、Discord などの主要なメッセージングサービスと連携し、Claude、OpenAI、Ollama などの大規模言語モデルに対応しています。本記事では、Windows環境でOpenClawをインストール・設定する方法を詳しく解説します。

動作環境

インストールを始める前に、以下の要件を満たしていることをご確認ください。

項目	最低要件	推奨構成
OS	Windows 10 21H2	Windows 11 23H2+
Node.js	22.0+	22 LTS 最新版
メモリ	2 GB	4 GB+
ディスク容量	500 MB	2 GB+
ネットワーク	インターネット接続可能	安定したブロードバンド接続

ステップ1：Node.jsのインストール

OpenClaw には Node.js 22 以上が必要です。nvm-windows を使用してNode.jsのバージョンを管理することをお勧めします。複数のバージョンを簡単に切り替えることができます。

方法1：nvm-windowsを使用（推奨）

nvm-windows リリースページから最新の nvm-setup.exe をダウンロードします。
インストーラーを実行し、指示に従ってインストールを完了します。
管理者として PowerShell を開き、以下のコマンドを実行します。

# 利用可能なNode.jsバージョンを確認
nvm list available

# Node.js 22 LTSをインストール
nvm install 22

# Node.js 22に切り替え
nvm use 22

# インストールの確認
node --version
npm --version

方法2：Node.jsを直接インストール

Node.js公式サイトから22 LTS版のWindowsインストーラーをダウンロードし、「必要なツールを自動的にインストールする」オプションにチェックを入れて実行します。

インストール完了後、新しいPowerShellウィンドウを開いて確認します。

node --version
# 出力は v22.x.x であること

npm --version
# 出力は 10.x.x 以上であること

ステップ2：OpenClawのインストール

PowerShell を開き、グローバルインストールコマンドを実行します。

npm install -g openclaw@latest

インストール完了後、正常にインストールされたことを確認します。

openclaw --version

バージョン番号が表示されれば、インストール成功です。

よくあるインストール時の問題

権限エラーが発生した場合は、以下の方法をお試しください。

# 方法1：npmグローバルインストールディレクトリを設定
npm config set prefix "$env:APPDATA\npm"

# 方法2：管理者としてPowerShellを実行し、再度インストールコマンドを実行
npm install -g openclaw@latest

ネットワークの問題が発生した場合は、npmミラーを設定できます。

# 淘宝ミラーソースを使用
npm config set registry https://registry.npmmirror.com

# インストール完了後、公式ソースに戻す
npm config set registry https://registry.npmjs.org

ステップ3：初期設定

初回起動時に、初期設定ウィザードを完了する必要があります。

openclaw onboard

ウィザードでは以下の設定を行います。

AIモデルプロバイダの選択 — Claude、OpenAI、Ollama、Gemini、OpenRouter などに対応
APIキーの入力 — 選択したモデルプロバイダに応じたキーを入力
通信チャネルの選択 — 連携するメッセージングプラットフォームを選択
ゲートウェイポートの設定 — デフォルトは18789

設定完了後、ファイルは以下の場所に保存されます。

%USERPROFILE%\.config\openclaw\openclaw.json5

任意のテキストエディタでこのファイルを開いて手動で編集できます。

ステップ4：OpenClawの起動

openclaw up

起動後、以下のような出力が表示されます。

[OpenClaw] Gateway started on port 18789
[OpenClaw] Model provider: Claude (claude-sonnet-4-20250514)
[OpenClaw] Channels: ready
[OpenClaw] Dashboard: http://localhost:18789/dashboard

ブラウザで http://localhost:18789/dashboard にアクセスすると、管理パネルに入ることができます。

動作状態の確認

# 動作状態を確認
openclaw doctor

# 実行ログを確認
openclaw logs

# サービスを再起動
openclaw restart

ステップ5：Windows環境変数の設定

OpenClaw がどのターミナルウィンドウでも正常に使用できるように、システム環境変数を確認・設定することをお勧めします。

# 現在のPATHにnpmグローバルディレクトリが含まれているか確認
$env:PATH -split ';' | Where-Object { $_ -like '*npm*' }

# 含まれていない場合は手動で追加
[System.Environment]::SetEnvironmentVariable(
    'PATH',
    "$env:PATH;$env:APPDATA\npm",
    'User'
)

ステップ6：Windowsサービスとして設定（任意）

OpenClaw をシステム起動時に自動実行したい場合は、node-windows を使用してWindowsサービスとして登録できます。

node-windowsのインストール

npm install -g node-windows

サービスインストールスクリプトの作成

任意のディレクトリに install-service.js ファイルを作成します。

const { Service } = require('node-windows');
const path = require('path');

// openclawの実際のパスを取得
const openclawPath = path.join(
  process.env.APPDATA, 'npm', 'node_modules', 'openclaw', 'bin', 'openclaw.js'
);

const svc = new Service({
  name: 'OpenClaw',
  description: 'OpenClaw AI Assistant Platform',
  script: openclawPath,
  scriptOptions: 'up',
  nodeOptions: [],
  workingDirectory: process.env.USERPROFILE,
});

svc.on('install', () => {
  console.log('OpenClawサービスのインストールが完了しました。起動中...');
  svc.start();
});

svc.on('start', () => {
  console.log('OpenClawサービスが起動しました');
});

svc.install();

管理者として実行します。

node install-service.js

サービスの管理

インストール完了後、Windowsサービスマネージャーで OpenClaw サービスを確認できます。コマンドラインでも管理可能です。

# サービス状態を確認
Get-Service -Name 'OpenClaw'

# サービスを停止
Stop-Service -Name 'OpenClaw'

# サービスを起動
Start-Service -Name 'OpenClaw'

# サービスを再起動
Restart-Service -Name 'OpenClaw'

ステップ7：Windowsファイアウォールの設定

LAN内の他のデバイスからOpenClawにアクセスする必要がある場合は、ファイアウォールのポートを開放する必要があります。

# 管理者として実行
New-NetFirewallRule `
  -DisplayName "OpenClaw Gateway" `
  -Direction Inbound `
  -Protocol TCP `
  -LocalPort 18789 `
  -Action Allow

開放後、LAN内の他のデバイスから http://あなたのIP:18789 でOpenClaw Dashboardにアクセスできます。

PowerShell実行ポリシーについて

OpenClaw の実行時に「スクリプトを読み込めません」というエラーが発生した場合は、PowerShell の実行ポリシーを調整する必要があるかもしれません。

# 現在のポリシーを確認
Get-ExecutionPolicy

# ローカルスクリプトの実行を許可
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Windows Terminalの活用テクニック

Windows Terminal で OpenClaw を使用することをお勧めします。専用のプロファイルを作成できます。

Windows Terminal の設定を開く
「新しいプロファイルを追加」をクリック
名前を OpenClaw に設定
コマンドラインに pwsh -NoExit -Command "openclaw up" と入力
開始ディレクトリを %USERPROFILE% に設定

このプロファイルを開くたびに、OpenClaw が自動的に起動します。

インストールの検証

上記のステップが完了したら、診断コマンドを実行してすべてが正常であることを確認します。

openclaw doctor

このコマンドは以下をチェックします。

Node.js のバージョンが要件を満たしているか
設定ファイルが有効か
ネットワーク接続が正常か
設定済みのモデルプロバイダが利用可能か
設定済みの通信チャネルが接続可能か

まとめ

以上で、Windows環境でのOpenClawのインストールと設定が完了しました。次のステップとして以下をお勧めします。

設定ファイルガイドを読み、openclaw.json5 の各種設定を詳しく理解する
お好みのメッセージングプラットフォームと連携する
カスタムスキルプラグインを作成する
複数のAIモデルをデプロイし、インテリジェントルーティングを設定する

問題が発生した場合は、openclaw doctor を実行して自己診断を行うか、トラブルシューティングドキュメントをご参照ください。