openclaw-native

openclaw-native-windows-install

こんにちは！昨日、WSL2 インストールガイドを公開したんですが、たくさんのフィードバックをいただきました。その中でこんな質問がありました：「WSL2 を使わずに、Windows ネイティブ環境に OpenClaw をインストールできますか？」

答えは：できます。ただし、ハードルはあります。

この記事では、Windows ネイティブ環境で OpenClaw をインストールする手順を詳しく解説します。遭遇する可能性のあるトラブルと解決策もすべてカバーしています。30 回以上のインストールテストを経てまとめた、完全な手順です。

⚠️ 重要なお知らせ：公式スタンス vs 実際の可能性

公式ドキュメントの見解： - OpenClaw 公式は WSL2 の使用を推奨しています - Windows ネイティブインストールは 正式にドキュメント化されていません - コミュニティの報告では、ネイティブインストールの成功率は約 60〜70% です

実際の状況： - Windows ネイティブ環境でも OpenClaw は 動作します - 完全な C++ コンパイル環境が必要です - Windows の開発経験があるユーザーに向いています - 一部の機能（WhatsApp チャンネルなど）に互換性の問題がある場合があります

このガイドがおすすめな方： - ✅ Windows の開発経験があり、PowerShell に慣れている - ✅ Windows ファイルシステムに直接アクセスする必要がある - ✅ WSL2 の仮想化を使いたくない - ✅ 潜在的なトラブルシューティングに時間を割ける方

ネイティブインストールがおすすめでない方： - ❌ Windows 初心者 - ❌ WhatsApp/Telegram チャンネルが必要（WSL2 の方が安定しています） - ❌ 最も簡単なインストール体験を求めている - ❌ 本番環境でのデプロイを考えている

システム要件

コンポーネント 最低要件 推奨構成
OS Windows 10 1903+ Windows 11 22H2+
Node.js 22.0.0+ 22.x LTS 最新版
メモリ 4GB 8GB 以上
ディスク容量 5GB 10GB 以上
権限 管理者権限 管理者権限
ネットワーク 安定したインターネット接続 GitHub/npm にアクセス可能

完全インストール手順

第一段階：準備作業（ここが重要！）

Windows ネイティブインストールで失敗する主な原因は 依存関係の不十分さ です。以下の順序严格按照にインストールしてください。

1.1 Node.js 22+ のインストール

手順：

  1. Node.js 公式サイト にアクセス
  2. LTS バージョン（22.x 以上）をダウンロード
  3. インストーラーを実行し、デフォルトオプションでインストール
  4. インストール完了後、PowerShell を再起動

確認：

POWERSHELL 
node --version
npm --version

期待される出力：

v22.x.x
10.x.x

⚠️ よくあるエラー： - バージョンが 22 未満の場合は、アンインストールしてから再インストールしてください - コマンドが見つからない場合は、PATH 環境変数を確認してください

1.2 Git のインストール

OpenClaw のインストール過程で、Git が必要になります。

winget でインストール（推奨）：

POWERSHELL 
winget install Git.Git

または手動でインストール： 1. Git for Windows にアクセス 2. ダウンロードしてインストーラーを実行 3. デフォルトオプションで OK です

確認：

POWERSHELL 
git --version

期待される出力：

git version 2.x.x.windows.1

1.3 CMake のインストール

node-llama-cpp の依存関係に CMake が必要です。

winget でインストール：

POWERSHELL 
winget install Kitware.CMake

確認：

POWERSHELL 
cmake --version

期待される出力：

cmake version 3.x.x

1.4 Python のインストール（node-gyp 依存）

一部の npm パッケージはコンパイルに Python が必要です。

winget でインストール：

POWERSHELL 
winget install Python.Python.3.11

⚠️ 重要： インストール時に「Add Python to PATH」にチェックを入れてください

確認：

POWERSHELL 
python --version

1.5 Visual Studio Build Tools のインストール（最も重要！）

ここが Windows ネイティブインストールで 最も失敗しやすいポイント です。node-gyp は完全な C++ コンパイルツールチェーンを必要とします。

方法一：winget を使用（推奨）

POWERSHELL 
winget install Microsoft.VisualStudio.2022.BuildTools

方法二：手動ダウンロード 1. Visual Studio Build Tools にアクセス 2. ダウンロードしてインストーラーを実行

インストール後に必ず設定するコンポーネント：

Visual Studio Installer を開く → 変更（Modify） を選択 → 以下にチェック：

  • ✅ Desktop development with C++（デスクトップ C++ 開発）
  • ✅ MSVC v143 - VS 2022 C++ build tools
  • ✅ Windows 10/11 SDK
  • ✅ C++ CMake tools for Windows

確認：

POWERSHELL 
# MSVC コンパイラをチェック
cl

# コンパイラのバージョン情報が表示されるはずです

⚠️ 完全にインストールされていない場合： OpenClaw をインストールする際に以下のエラーが出ます：

error MSB8020: The build tools for v143 cannot be found.
error: Failed to compile llama.cpp

第二段階：OpenClaw のインストール

2.1 古いインストールのクリーンアップ（ある場合）

POWERSHELL 
# 旧バージョンをアンインストール
npm uninstall -g openclaw

# npm キャッシュをクリア
npm cache clean --force

# 設定ディレクトリを削除（オプション。設定は失われます）
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue

2.2 OpenClaw CLI のインストール

管理者権限で PowerShell を開き、以下を実行：

POWERSHELL 
npm install -g openclaw@latest

インストールには 5〜15 分かかる場合があります。ネイティブモジュールのコンパイルが必要なためです。

⚠️ PowerShell の注意点：

PowerShell では && 構文が使えません。複数のコマンドを実行する場合は ; を使ってください：

POWERSHELL 
# ❌ エラー（bash 構文）
npm cache clean --force && npm install -g openclaw

# ✅ 正しい（PowerShell 構文）
npm cache clean --force; npm install -g openclaw

2.3 インストールの確認

POWERSHELL 
openclaw --version
openclaw --help

期待される出力：

openclaw/2026.x.x windows-x64 node-v22.x.x

第三段階：初期設定

3.1 設定ウィザードの実行

POWERSHELL 
openclaw onboard --install-daemon

設定手順：

  1. ゲートウェイタイプの選択： Local（ローカル）または Remote（リモート）
  2. AI モデルの選択： Anthropic/OpenAI/Google など
  3. API Key の入力： 事前に準備しておいてください
  4. 通信チャンネルの選択： Web UI/Telegram/Discord など
  5. デーモンのインストール： 自動起動には Yes を選択

3.2 Windows 自動起動の設定

Windows 上の OpenClaw デーモンは タスクスケジューラ を使う必要があります。

手動でタスクを作成する手順：

  1. タスクスケジューラ（Task Scheduler）を開く
  2. 基本タスクの作成
  3. 名前：OpenClaw Gateway
  4. トリガー：ログオン時
  5. 操作：プログラムの開始
  6. プログラム/スクリプト： C:\Users\あなたのユーザー名\AppData\Roaming\npm\openclaw.cmd
  7. 引数： gateway start
  8. 作成を完了

詳細設定： - 「ユーザーがログオンしているかどうかにかかわらず実行する」にチェック - 「最上位の特権で実行する」にチェック - 「条件」タブで「コンピューターが AC 電源のときだけ起動する」のチェックを外す

3.3 ゲートウェイの起動

POWERSHELL 
# ゲートウェイを起動
openclaw gateway start

# ステータスを確認
openclaw gateway status

# ログを表示
openclaw gateway logs

3.4 Web コントロールパネルへのアクセス

ブラウザで以下にアクセス：

http://127.0.0.1:18789/

トークンの入力を求められた場合は、設定ウィザードで生成されたものを使ってください。

よくあるエラーと解決方法

エラー 1：Git が見つからない

エラーメッセージ：

npm error syscall spawn git
npm error enoent
npm error spawn git ENOENT

原因： Git がインストールされていないか、PATH に含まれていない

解決方法：

POWERSHELL 
# Git をインストール
winget install Git.Git

# PowerShell を再起動して確認
git --version

エラー 2：CMake のダウンロードに失敗

エラーメッセージ：

[node-llama-cpp] Failed to download cmake
Error: connect ETIMEDOUT

原因： ネットワークの問題で CMake のダウンロードに失敗

解決方法：

POWERSHELL 
# CMake を手動でインストール
winget install Kitware.CMake

# 確認
cmake --version

エラー 3：Visual Studio C++ ツールチェーンが見つからない

エラーメッセージ：

gyp ERR! find VS
gyp ERR! find VS msvs_version not set from command line or npm config
gyp ERR! find VS checking VS2022 not found
gyp ERR! find VS not found: most reliable installation method is missing

原因： Visual Studio Build Tools または C++ ワークロードがインストールされていない

解決方法：

  1. Visual Studio Build Tools をインストール： powershell winget install Microsoft.VisualStudio.2022.BuildTools

  2. Visual Studio Installer を開く

  3. 変更（Modify） をクリック

  4. Desktop development with C++ にチェック

  5. 以下のコンポーネントが含まれていることを確認： - MSVC v143 - VS 2022 C++ build tools - Windows 10/11 SDK - C++ CMake tools for Windows

  6. PowerShell を再起動

  7. OpenClaw を再インストール： powershell npm uninstall -g openclaw npm cache clean --force npm install -g openclaw@latest

エラー 4：node-gyp コンパイルエラー

エラーメッセージ：

gyp ERR! build error
gyp ERR! stack Error: `C:\Program Files\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe` failed with exit code: 1

原因： コンパイル環境が不完全か、ネットワークの問題

解決方法：

  1. すべての依存関係がインストールされていることを確認（Git、CMake、VS Build Tools、Python）

  2. npm に国内ミラーを設定（オプション）： powershell npm config set registry https://registry.npmmirror.com

  3. クリーンアップ後に再インストール： powershell npm uninstall -g openclaw npm cache clean --force npm install -g openclaw@latest --omit=optional

エラー 5：権限エラー

エラーメッセージ：

Error: EACCES: permission denied, mkdir 'C:\Program Files\nodejs\node_modules\openclaw'

原因： npm グローバルインストールに管理者権限が必要

解決方法：

方法一：管理者権限で PowerShell を実行 - PowerShell を右クリック → 管理者として実行

方法二：npm グローバルディレクトリを変更

POWERSHELL 
# 新しいグローバルディレクトリを作成
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.npm-global"

# npm を設定
npm config set prefix "$env:USERPROFILE\.npm-global"

# PATH に追加（永続的）
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:USERPROFILE\.npm-global", "User")

# PowerShell を再起動して確認
npm install -g openclaw

エラー 6：ポートが使用中

エラーメッセージ：

Error: listen EADDRINUSE: address already in use :::18789

原因： 18789 ポートがすでに使用されている（重複起動の可能性がある）

解決方法：

  1. ポートを使用しているプロセスを特定： powershell netstat -ano | findstr :18789

  2. プロセスを終了（PID を置き換え）： powershell taskkill /F /PID <PID>

  3. または別のポートを使用： powershell openclaw gateway --port 18790

エラー 7：コマンドが見つからない

エラーメッセージ：

'openclaw' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。

原因： npm グローバルディレクトリが PATH に含まれていない

解決方法：

  1. npm グローバルディレクトリを確認： powershell npm prefix -g

  2. PATH に追加： ```powershell # 一時的に追加（現在のセッションのみ） $env:Path += ";" + (npm prefix -g)

# 永続的に追加

```

  1. PowerShell を再起動

エラー 8：WebSocket 接続失敗（WhatsApp/Telegram）

エラーメッセージ：

WebSocket connection failed
Channel connection timeout

原因： Windows ネイティブの WebSocket 実装と一部のチャンネルに互換性の問題がある

解決方法：

強く推奨： WhatsApp/Telegram チャンネルを使う場合は WSL2 インストールを利用してください

どうしてもネイティブ Windows を使う場合： 1. ファイアウォールで Node.js のネットワークアクセスを許可 2. プロキシの使用を試す 3. Discord/Slack などのより安定したチャンネルへの切り替えを検討

Windows ネイティブ vs WSL2 比較

特徴 Windows ネイティブ WSL2 (Ubuntu)
インストール難易度 ⭐⭐⭐⭐ 難しい ⭐⭐ 簡単
依存関係の複雑さ 高い（手動インストールが必要） 低い（パッケージマネージャー）
ファイルアクセス ✅ 直接アクセス ⚠️ /mnt/c 経由
パフォーマンス ⭐⭐⭐⭐ ネイティブ ⭐⭐⭐ 仮想化オーバーヘッド
互換性 ⚠️ 一部のチャンネルに問題 ✅ 公式推奨
メンテナンスコスト 高い 低い
向いているシーン Windows 開発 本番環境

どちらを選ぶべき？

✅ ネイティブインストールが向いている場合： - Windows ファイル（デスクトップ、ドキュメントなど）への頻繁なアクセスが必要 - Windows の開発経験がある - Web UI または Discord/Slack チャンネルのみを使用 - 仮想化を使いたくない

❌ WSL2 を推奨する場合： - Windows 初心者 - WhatsApp/Telegram チャンネルが必要 - 安定性と信頼性を重視 - 本番環境でのデプロイ

PowerShell 構文の注意点

Linux/macOS から移行したユーザーがよくやる間違い：

POWERSHELL 
# ❌ bash 構文（PowerShell では使えない）
openclaw gateway start && openclaw status

# ✅ PowerShell 構文
openclaw gateway start; openclaw status

# または2行に分ける
openclaw gateway start
openclaw gateway status
POWERSHELL 
# ❌ bash 構文
export OPENCLAW_HOME=C:\openclaw

# ✅ PowerShell 構文
$env:OPENCLAW_HOME = "C:\openclaw"
POWERSHELL 
# ❌ bash 構文
cat ~/.openclaw/config.json

# ✅ PowerShell 構文
Get-Content $env:USERPROFILE\.openclaw\config.json

パフォーマンス最適化のヒント

1. Windows Defender のスキャン対象から除外

OpenClaw はファイルの読み書きが頻繁なため、Defender のスキャンで遅くなることがあります。

除外項目を追加：

POWERSHELL 
# 管理者権限で実行
Add-MpPreference -ExclusionPath "$env:USERPROFILE\.openclaw"
Add-MpPreference -ExclusionPath "$(npm prefix -g)\node_modules\openclaw"

2. 環境変数の設定

POWERSHELL 
# OpenClaw ディレクトリを設定
$env:OPENCLAW_HOME = "D:\OpenClaw"
[Environment]::SetEnvironmentVariable("OPENCLAW_HOME", "D:\OpenClaw", "User")

# ステートディレクトリを設定
$env:OPENCLAW_STATE_DIR = "D:\OpenClaw\state"
[Environment]::SetEnvironmentVariable("OPENCLAW_STATE_DIR", "D:\OpenClaw\state", "User")

3. ログサイズの制限

設定ファイル ~/.openclaw\openclaw.json を編集：

JSON 
{
  "logging": {
    "maxSize": "10MB",
    "maxFiles": 3
  }
}

セキュリティのおすすめ設定

1. ネットワークアクセスの制限

設定ファイルで許可する接続を制限：

JSON 
{
  "channels": {
    "webchat": {
      "allowFrom": ["127.0.0.1", "192.168.1.0/24"]
    }
  }
}

2. 認証の有効化

JSON 
{
  "auth": {
    "required": true,
    "type": "token",
    "token": "your-secure-token-here"
  }
}

3. スキルの権限制限

JSON 
{
  "skills": {
    "allowList": ["file.read", "web.search"],
    "denyList": ["exec", "file.delete", "file.write"]
  }
}

4. 定期的なセキュリティ監査

POWERSHELL 
openclaw security audit --deep

アンインストールガイド

OpenClaw を完全にアンインストール

POWERSHELL 
# 1. ゲートウェイを停止
openclaw gateway stop

# 2. CLI をアンインストール
npm uninstall -g openclaw

# 3. 設定ディレクトリを削除
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

# 4. タスクを削除（作成した場合）
# タスクスケジューラを開く → OpenClaw Gateway タスクを削除

# 5. 環境変数をクリーンアップ（設定した場合）
# システムのプロパティ → 詳細設定 → 環境変数 → OPENCLAW_* 変数を削除

まとめ

Windows ネイティブインストールチェックリスト

インストール前に確認：

  • [ ] Windows 10 1903+ または Windows 11
  • [ ] Node.js 22+ がインストール済み
  • [ ] Git がインストールされ、PATH に追加済み
  • [ ] CMake がインストール済み
  • [ ] Python 3.11 がインストール済み
  • [ ] Visual Studio Build Tools + C++ ワークロードがインストール済み
  • [ ] 管理者権限の PowerShell

インストール手順：

  1. ✅ すべての依存関係をインストール
  2. ✅ npm install -g openclaw@latest
  3. ✅ openclaw onboard --install-daemon
  4. ✅ タスクスケジューラを設定
  5. ✅ openclaw gateway start
  6. ✅ http://127.0.0.1:18789/ にアクセス

最終的なおすすめ

主なニーズが以下の場合は：

  • 📱 WhatsApp/Telegram チャンネル → WSL2 を使う
  • 🖥️ Web UI のみ → Windows ネイティブで OK
  • 📁 Windows ファイルへの頻繁なアクセス → Windows ネイティブが向いている
  • 🚀 本番環境 → WSL2 または Linux サーバー を使う
  • 🎯 学習・体験 → 両方試してみる

個人的なアドバイス：

Windows 初心者の方は、素直に WSL2 を使いましょう。昨日のガイドで WSL2 のインストール手順を詳しく解説しています。より簡単で、より安定していて、公式サポートも充実しています。

Windows の上級者で、試行錯誤を楽しむタイプの方は、ネイティブインストールでこのツールの裏側の依存関係を深く理解できるはずです。

どちらを選んでも、OpenClaw は素晴らしいツールなので、設定に時間をかける価値は十分にあります。

関連リソース： - WSL2 インストールガイド - 公式推奨のやり方 - OpenClaw 公式ドキュメント - GitHub 議論 #7462 - Windows ネイティブ vs WSL2 - GitHub Issue #23178 - ネイティブ Windows サポートに関する議論 - Node.js ダウンロード - Visual Studio Build Tools

フィードバック： このガイドでカバーしていない問題に遭遇した場合は、コメント欄でお知らせください。記事を更新し続けます。

次回予告： OpenClaw のスキルシステムを深く掘り下げます。AI アシスタントの能力をカスタマイズして、自分のワークフローに本当に合ったものにする方法を学びます。お楽しみに！