OpenClaw Windows インストールガイド (WSL2)

OpenClaw は、互換性と一貫性を確保するために Windows 上の WSL2（Windows Subsystem for Linux）を介して動作するオープンソースの AI エージェントプラットフォームです。セキュリティのため、隔離された環境でのインストールを推奨します。このガイドは、Windows 10/11 ユーザー向けのステップバイステップの手順です。

システム要件

OS: Windows 10/11 (ビルド 19041 以降)。
WSL2: 有効化されており、Ubuntu ディストリビューションを推奨。
Node.js: バージョン 22 以上。
ハードウェア: 最低 8GB の RAM と AI モデル用の十分なストレージ。
API キー: モデル連携のための OpenAI または Anthropic のキー。

インストール手順

1. WSL2 の有効化

PowerShell を管理者として開きます。
コマンド wsl --install を実行します（WSL がまだインストールされていない場合）。
再起動後、Microsoft Store から Ubuntu をインストールするか、wsl --install -d Ubuntu を実行します。
Ubuntu を起動し、初期設定を完了させます。

2. Node.js のインストール

WSL ターミナルでパッケージを更新します: sudo apt update && sudo apt upgrade
Node.js をインストールします: sudo apt install nodejs npm 或いは最新バージョンのために NVM を使用します。

3. OpenClaw インストールスクリプトの実行

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

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

スクリプトが自動的にシステムを検出し、依存関係をインストールして、オンボーディングウィザードを起動します。

4. ゲートウェイサービスのインストール

OpenClaw をバックグラウンドサービスとして 24 時間年中無休で動作させるために、以下を実行します：

openclaw onboard --install-daemon

5. 連携の設定

Web UI または CLI を使用して、Telegram、WhatsApp などを設定します。
@BotFather を介して Telegram ボットを作成し、トークンを OpenClaw に貼り付けます。
ボットにメッセージを送信して、接続をテストします。

よくある質問と解決策

問題	詳細	解決策
WSL2 の失敗	WSL2 のインストールが失敗する、または検出されない。	BIOS で仮想化（Virtualization）を有効にします。DISM コマンドを実行して WSL と VirtualMachinePlatform 機能を有効にし、再起動します。
スクリプトのエラー	インストール中に権限拒否或いはネットワーク問題が発生する。	ターミナルを管理者として実行します。`curl` がインストールされていることを確認します。ファイアウォールの設定を確認するか、ネットワークが制限されている場合は VPN を使用してください。
API 設定	キーの読み込みに失敗する、またはモデルが起動しない。	プロバイダーのダッシュボードでキーを確認します。`openclaw test-model` を実行して特定のキーを確認します。クォータ（例：Google Antigravity）を確認してください。
セキュリティリスク	データ漏洩或いはプロンプトインジェクションへの懸念。	強く推奨：専用の VM (Azure など) または隔離された PC にインストールしてください。読み取り専用権限を使用し、定期的に OpenClaw を更新してください。
ゲートウェイの問題	サービスの起動に失敗する、またはクラッシュする。	`openclaw logs` でログを確認します。Node.js のバージョンの互換性を確認してください。必要に応じて WSL を再起動します。

クラウドデプロイ

より高度な隔離のために、Azure の Windows 11 VM へのデプロイを検討してください。Azure CLI とデプロイスクリプトを使用して、プロセス全体を安全に自動化できます。