English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Platforms overview

Windows

OpenClaw は、ネイティブの Windows Hub コンパニオンアプリと Windows CLI サポートを同梱しています。 セットアップ、トレイステータス、チャット、Command Center 診断、Windows ノード機能を備えたデスクトップアプリが必要な場合は Windows Hub を使用します。CLI/Gateway を直接使いたい場合は PowerShell インストーラーを使用します。最も Linux 互換性の高い Gateway ランタイムが必要な場合は WSL2 を使用します。

推奨: Windows Hub

Windows Hub は、Windows 10 20H2+ と Windows 11 向けのネイティブ WinUI コンパニオンアプリです。管理者権限なしでインストールでき、OpenClaw リリースで署名済みの x64 および ARM64 インストーラーとして公開されています。

最新の安定版インストーラーを OpenClaw リリースページ からダウンロードします。

上記のダウンロードリンクが 404 を返す場合は、リリースページ にアクセスし、最新リリースの OpenClawCompanion-Setup-* アセットを探してください。

インストール後、スタートメニューまたはシステムトレイから OpenClaw Companion を起動します。インストーラーは、Gateway セットアップ、チャット、設定、 更新確認、アンインストール用のショートカットも追加します。

Windows Hub に含まれるもの

  • システムトレイステータスとログイン時起動
  • ローカルのアプリ所有 WSL Gateway 向け初回セットアップ
  • ローカル、リモート、SSH トンネル経由 Gateway の接続設定
  • ネイティブチャットウィンドウとブラウザー Control UI へのアクセス
  • セッション、使用状況、チャンネル、ノード、ペアリング、修復コマンド向けの Command Center 診断
  • エージェント制御のキャンバス、画面、カメラ、通知、デバイスステータス、テキスト読み上げ、音声認識、制御された system.run のための Windows ノードモード
  • Claude Desktop、Claude Code、Cursor などの MCP クライアント向けローカル MCP サーバーモード

初回起動

初回起動時、使用可能な保存済み Gateway がない場合、Windows Hub はセットアップを開きます。 最速の方法は ローカルにセットアップ で、アプリ所有の OpenClawGateway WSL ディストリビューションをプロビジョニングし、その内部に Gateway をインストールして、アプリをペアリングします。 これは既存の Ubuntu ディストリビューションをエクスポートしたり変更したりしません。

すでに Gateway がある場合は、高度なセットアップ を選択するか、接続タブを開きます。 次に接続できます。

  • この PC 上のローカル Gateway
  • この PC 上の WSL Gateway
  • URL とトークンまたはセットアップコードによるリモート Gateway
  • SSH トンネル経由で到達する Gateway

セットアップが完了すると、トレイアイコンが緑になります。トレイから Command Center を開き、接続、ペアリング、ノードステータス、チャンネルの健全性を確認します。

Windows ノードモード

Windows Hub は、ファーストクラスの OpenClaw ノードとして登録できます。その後、エージェントは Gateway を通じて宣言済みの Windows ネイティブ機能を使用できます。

一般的なコマンドには次が含まれます。

  • canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot
  • screen.snapshot、および明示的なオプトイン時の screen.record
  • camera.list、および明示的なオプトイン時の camera.snap, camera.clip
  • system.notify, system.run, system.run.prepare, system.which
  • location.get, device.info, device.status
  • stt.transcribe, tts.speak

ノードモードには Gateway ペアリングが必要です。アプリにペアリング要求が表示された場合は、 Gateway ホストから承認します。

powershell
openclaw devices listopenclaw devices approve <request-id>openclaw nodes status

Gateway は、ノードが宣言しサーバーポリシーで許可されたコマンドのみを転送します。screen.record、camera.snap、camera.clip などのプライバシーに関わるコマンドには、明示的な gateway.nodes.allowCommands オプトインが必要です。

ローカル MCP モード

Windows Hub は、同じ Windows ネイティブ機能レジストリを、ループバック上のローカル MCP サーバーとして公開できます。これは、実行中の OpenClaw Gateway なしでローカル MCP クライアントから Windows 機能を操作したい場合に便利です。

Windows Hub 設定の開発者/高度なセクションで有効にします。サーバーを有効にすると、アプリにループバックエンドポイントとベアラートークンが表示されます。

モード一覧:

ノードモード MCP サーバー 動作
オフ オフ オペレーター専用デスクトップアプリ
オン オフ Gateway 接続済み Windows ノード
オフ オン ローカル MCP サーバーのみ
オン オン Gateway ノードとローカル MCP サーバー

ネイティブ Windows CLI と Gateway

ターミナル中心で使用する場合は、PowerShell から OpenClaw をインストールします。

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

確認:

powershell
openclaw --versionopenclaw doctoropenclaw gateway status --json

ネイティブ Windows CLI と Gateway のフローはサポートされており、改善が続いています。 管理対象の起動は、利用可能な場合 Windows Scheduled Tasks を使用します。タスクは OpenClaw 状態ディレクトリ内に読み取り可能な gateway.cmd スクリプトを保持しますが、生成された gateway.vbs WScript ラッパーを通じて起動するため、バックグラウンド Gateway は可視のコンソールウィンドウを開きません。タスク作成が拒否された場合、OpenClaw はユーザーごとの Startup フォルダーのログイン項目にフォールバックします。

Gateway サービスをインストールするには:

powershell
openclaw gateway installopenclaw gateway status --json

管理対象 Gateway サービスなしで CLI のみを使用したい場合:

powershell
openclaw onboard --non-interactive --skip-healthopenclaw gateway run

WSL2 Gateway

WSL2 は、Windows 上で最も Linux 互換性の高い Gateway ランタイムであり続けています。Windows Hub でアプリ所有の WSL Gateway をセットアップすることも、自分のディストリビューション内に手動でインストールすることもできます。

手動セットアップ:

powershell
wsl --install# Or pick a distro explicitly:wsl --list --onlinewsl --install -d Ubuntu-24.04

WSL 内で systemd を有効にします。

bash
sudo tee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF

PowerShell から WSL を再起動します。

powershell
wsl --shutdown

その後、Linux クイックスタートを使用して WSL 内に OpenClaw をインストールします。

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

Windows ログイン前の Gateway 自動起動

ヘッドレス WSL セットアップでは、Windows に誰もログインしていない場合でも完全なブートチェーンが実行されるようにします。

WSL 内:

bash
sudo apt-get install -y dbus-x11sudo loginctl enable-linger "$(whoami)"openclaw gateway install

管理者として PowerShell で:

powershell
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

Ubuntu を、次のコマンドで確認した自分のディストリビューション名に置き換えます。

powershell
wsl --list --verbose

注: 古い手順からの変更点は 2 つあります。

  • /bin/true ではなく dbus-launch true — WSL ≥ 2.6.1.0 では、回帰 (microsoft/WSL #13416) により、linger が有効でも最後のクライアントが終了してから 15〜20 秒後にディストリビューションがアイドル終了します。dbus-launch true は、回避策として child-of-init プロセスを生存させます (コミュニティでの議論, microsoft/WSL #9245)。
  • /ru SYSTEM ではなく /ru "$env:USERNAME" — ユーザーごとの WSL ディストリビューション（既定のセットアップ）は SYSTEM アカウントから見えません。タスクは実行されたように見えますが、ディストリビューションは起動されません。自分のアカウントとして実行するとこれを回避できます。タスク作成時に Windows がパスワードを求めます。

再起動後、WSL から確認します。

bash
systemctl --user is-enabled openclaw-gateway.servicesystemctl --user status openclaw-gateway.service --no-pager

LAN 経由で WSL サービスを公開する

WSL には独自の仮想ネットワークがあります。別のマシンから WSL 内のサービスに到達する必要がある場合は、Windows ポートを現在の WSL IP に転送します。WSL IP は再起動後に変わることがあるため、必要に応じて転送ルールを更新してください。

管理者として PowerShell での例:

powershell
$Distro = "Ubuntu-24.04"$ListenPort = 2222$TargetPort = 22 $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]if (-not $WslIp) { throw "WSL IP not found." } netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `  connectaddress=$WslIp connectport=$TargetPort New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `  -Protocol TCP -LocalPort $ListenPort -Action Allow

注:

  • 別のマシンからの SSH は、たとえば ssh user@windows-host -p 2222 のように Windows ホスト IP を対象にします。
  • リモートノードは 127.0.0.1 ではなく、到達可能な Gateway URL を指す必要があります。
  • LAN アクセスには listenaddress=0.0.0.0 を使用します。ローカル専用アクセスには 127.0.0.1 を使用します。

トラブルシューティング

トレイアイコンが表示されない

タスクマネージャーで OpenClaw.Tray.WinUI.exe を確認します。実行中の場合は、隠れているトレイアイコン領域を開いてピン留めします。実行されていない場合は、スタートメニューから OpenClaw Companion を起動します。

ローカルセットアップが失敗する

Windows Hub からセットアップログを開くか、次を確認します。

powershell
notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

一般的な原因は、WSL が無効、仮想化がブロックされている、アプリ所有 WSL 状態が古い、または Gateway パッケージのインストール中のネットワーク障害です。

アプリがペアリングが必要だと表示する

Gateway からオペレーターまたはノード要求を承認します。

powershell
openclaw devices listopenclaw devices approve <request-id>

デバイスにすでにトークンがある場合は、承認後に接続タブから再接続します。

Web チャットがリモート Gateway に到達できない

リモート Web チャットには HTTPS または localhost が必要です。自己署名証明書の場合は、 Windows で証明書を信頼するか、localhost URL への SSH トンネルを使用します。

screen.snapshot、カメラ、または音声コマンドが失敗する

カメラ、マイク、画面キャプチャ、通知の Windows 権限を確認します。パッケージ版インストールでは保護された機能を宣言しますが、Windows はコマンドが初めてそれらを使用するときに依然として確認を求める場合があります。

Git または GitHub 接続が失敗する

一部のネットワークでは、GitHub への HTTPS がブロックまたはスロットリングされます。git clone または gh auth login が失敗する場合は、別のネットワーク、VPN、または HTTP/HTTPS プロキシを試してください。

現在のセッションでトークンベースの gh 認証を使う場合:

powershell
$env:GH_TOKEN="<your-token>"gh auth statusgh auth setup-git

トークンをコミットしたり、issue や pull request に貼り付けたりしないでください。

関連

Was this useful?
On this page

On this page