Contents
Windows で OpenClaw を安全にセットアップする完全ガイド
対象読者
- Windows 10 (1809 以降) または Windows 11 の PC を使用している方
- 管理者権限が付与されたユーザー アカウントを持っていることが前提です
1. 必要な前提条件
| 項目 | 推奨環境 / バージョン | 補足 |
|---|---|---|
| OS | Windows 10 (ビルド 1809 以降) または Windows 11 (64‑bit) | OpenClaw の公式テスト対象 OS【1】 |
| 管理者権限 | 必須 – インストーラがシステムディレクトリや PATH に書き込むため |
PowerShell/コマンドプロンプトを「管理者として実行」 |
| CPU / メモリ | x64 アーキテクチャ、最低 2 GB RAM(推奨 4 GB 以上) | 大規模モデルや同時タスクで増加します |
※ 出典
1. OpenClaw Docs – System Requirements (2026) https://docs.openclaw.ai/ja-JP/install#requirements
2. Node.js LTS のインストールとバージョン確認
2‑1 公式サイトから最新版 LTS を取得
- ブラウザで nodejs.org にアクセス
- 「LTS」ラベルが付いた Windows Installer (.msi) をクリック(2026 年時点は v22.16.0 LTS)
- ダウンロードした
node-v22.xx.x-x64.msiを右クリック → 「管理者として実行」
2‑2 インストール時の重要ポイント
| 設定項目 | 推奨値 |
|---|---|
| Add to PATH | ✔(デフォルトでチェック) |
| Node.js runtime | 完全にインストール (npm 同梱) |
| Chocolatey / nvm の同時導入 | なし – 競合回避のため公式 MSI を使用 |
注意:
nvm-windows等で別バージョン管理を行う場合は、インストーラが自動でPATHに書き込む処理を無効にして手動で切り替えてください。
2‑3 インストール後の確認
|
1 2 3 4 |
# PowerShell (管理者) で実行 node -v # => v22.16.0 (またはそれ以降) npm -v # => 10.x.x (LTS に同梱) |
公式が定める最低要件
- Node.js ≥ v20.0.0(OpenClaw のビルドに必要)【2】
- 推奨は最新 LTS(v22 系列)または将来リリースされる LTS
※ 出典
2. OpenClaw Docs – Node.js Requirements (2026) https://docs.openclaw.ai/ja-JP/install/node
3. Git for Windows の導入
OpenClaw のソースは GitHub にホストされているため、git が必須です。
| 手順 | 内容 |
|---|---|
| ダウンロード | https://git-scm.com/download/win から「Download」ボタンをクリック |
| インストール | Git-*-64-bit.exe を右クリック → 管理者として実行。ウィザードはデフォルト設定で完了 (「Git from the command line and also from 3rd‑party software」にチェック) |
| 動作確認 | powershell\n git --version # => git version 2.xx.x |
4. OpenClaw 本体の取得方法(最新情報)
4‑1 公式インストーラは npm パッケージ と PowerShell スクリプト の二通りが提供されています。
| 方法 | コマンド例 | 特徴 |
|---|---|---|
| npx (推奨) | npx openclaw@latest install |
npm レジストリから最新バージョンを取得し、依存関係を自動解決。Node が正しく検出できれば 1 行で完了 |
| PowerShell スクリプト | Invoke-WebRequest -Uri https://install.openclaw.ai -OutFile install.ps1; powershell -ExecutionPolicy Bypass -File .\install.ps1 |
インターネット接続が限定的な環境向け。スクリプトは GitHub のリリースページから最新バイナリをダウンロード |
2026 年 3 月時点の公式情報
OpenClaw Docs – Installation に記載されている唯一の配布方法はnpxとinstall.openclaw.aiスクリプトです。従来のcurl | bash方式は非推奨となり、Windows 環境では動作保証がありません【3】。※ 出典
3. OpenClaw Docs – Installation (2026) https://docs.openclaw.ai/ja-JP/install#download
4‑2 インストール実行例(管理者 PowerShell)
|
1 2 3 4 5 6 7 |
# 1️⃣ npx 方式 npx openclaw@latest install # 2️⃣ スクリプト方式 (PowerShell) Invoke-WebRequest -Uri https://install.openclaw.ai -OutFile $env:TEMP\openclaw-install.ps1 powershell -ExecutionPolicy Bypass -File $env:TEMP\openclaw-install.ps1 |
インストールが完了すると、デフォルトで C:\Program Files\OpenClaw に以下が配置されます。
openclaw.exe(CLI)service/ディレクトリ(バックグラウンドデーモン用)- 初期設定テンプレート (
.env.example,config.json)
5. インストール後の基本操作と設定ファイル
5‑1 環境変数・設定ファイルの配置場所
| ファイル | 推奨パス | 説明 |
|---|---|---|
.env |
C:\Program Files\OpenClaw\.env |
API キー、ポート番号、ログレベルなどを定義 |
config.json |
同上 | UI 表示や機能フラグ(例:Web ブラウジング)を JSON 形式で管理 |
.env のサンプル
|
1 2 3 4 5 |
# OpenClaw 用環境変数 (UTF-8) OPENCLAW_API_KEY=YOUR_API_KEY_HERE PORT=3000 LOG_LEVEL=info |
config.json のサンプル(抜粋)
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "assistant": { "name": "MyClaw", "language": "ja-JP" }, "features": { "webBrowsing": true, "fileAccess": true, "voiceOutput": false } } |
変更後は必ず
openclaw restart(またはstop && start)で設定を再読込してください。
5‑2 CLI の主要コマンド
| コマンド | 用途 |
|---|---|
openclaw start |
バックグラウンドサービスを起動 |
openclaw stop |
サービス停止 |
openclaw restart |
再起動(設定再読込) |
openclaw status |
現在の稼働状態確認 |
openclaw task run --name "test" --prompt "今日の天気は?" |
単発タスク実行例 |
openclaw --help |
全サブコマンドとオプション一覧 |
6. よくあるトラブルと対処フロー
6‑1 代表的エラー一覧
| エラーメッセージ | 主な原因 | 推奨対策 |
|---|---|---|
node: command not found |
PATH に Node が未登録 |
setx PATH "C:\Program Files\nodejs;%PATH%" /M を実行し、PowerShell 再起動 |
npm ERR! unsupported engine |
Node バージョンが最低要件未満 (v20) | 最新 LTS (v22.16.x) にアップデート |
EACCES: permission denied |
管理者権限なしでインストール実行 | PowerShell/コマンドプロンプトを 管理者として実行 |
openclaw: cannot find module 'node_modules/openclaw' |
npm グローバルパッケージが破損 | npm uninstall -g openclaw && npx openclaw@latest install |
6‑2 Node が検出されない場合の手順
-
PATH 確認
powershell
echo $Env:PATH
C:\Program Files\nodejsが含まれなければ次へ。 -
システム環境変数に追加(管理者 PowerShell)
powershell
setx PATH "C:\Program Files\nodejs;%PATH%" /M -
シェル再起動 →
node -vが正常に表示されるか確認。 -
再度インストールコマンド (
npx openclaw@latest install) を実行。
7. 動作確認チェックリスト
| 確認項目 | 手順 | 合格基準 |
|---|---|---|
| CLI が起動できる | openclaw start → openclaw status |
running と表示 |
| Web UI アクセス | ブラウザで http://localhost:3000 開く |
ログイン画面または「Hello, OpenClaw!」が表示 |
| ログ出力 | Get-Content "C:\Program Files\OpenClaw\logs\openclaw.log" -Tail 10 |
INFO Service started が含まれる |
| タスク実行 | openclaw task run --name test --prompt "今日の天気は?" |
JSON 形式でレスポンスが返る |
| 設定反映 | .env の PORT=4000 に変更 → 再起動 |
ブラウザで http://localhost:4000 が開く |
すべて合格すれば、Windows 環境での OpenClaw セットアップは完了です。
まとめ
| 項目 | 要点 |
|---|---|
| OS | Windows 10 (1809+) / Windows 11(64bit) |
| Node.js | 最低 v20、推奨最新 LTS (v22.16.x) を公式 MSI でインストール |
| Git | Git for Windows をデフォルト設定で導入 |
| OpenClaw 本体取得 | npx openclaw@latest install または PowerShell スクリプト (install.openclaw.ai) |
| PATH・権限 | インストーラ実行は必ず管理者、Node が PATH に登録されていることを確認 |
| 基本操作 | openclaw start / stop / status / task run |
| 設定ファイル | .env と config.json をインストールディレクトリ直下に配置し、変更後は再起動 |
| トラブル対策 | Node 未検出 → PATH 追加、バージョン不一致 → LTS 更新、権限エラー → 管理者実行 |
この手順に沿って作業すれば、Windows 上で OpenClaw を安全・確実に稼働させ、AI アシスタントとして即座に活用できるようになります。
本稿の情報は 2026 年 4 月時点の公式ドキュメントを基に作成しています。OS のアップデートや OpenClaw のバージョン変更があった場合は、必ず最新の公式リファレンスをご確認ください。