OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Windows

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

推奨: Windows Hub

Windows Hub は、Windows 10 20H2 以降および Windows 11 向けのネイティブ WinUI コンパニオンアプリです。管理者権限なしでインストールでき、専用のリリースページから署名済みの x64 および ARM64 インストーラーが提供されます。

Windows Hub は、OpenClaw CLI および Gateway とは独立して公開されます。最新の安定版 Hub インストーラーは、 Windows Hub リリースページ または releases/latest/download から直接ダウンロードできます。

上記のリンクで 404 エラーが発生する場合は、Windows Hub リリースページ にアクセスし、最新の安定版 Windows Hub リリースを開いてください。通常の OpenClaw 安定版リリースにも、リリース検証済みの固定バージョンの Windows Hub ビルドがミラーされますが、このミラーは、 より新しい単独の Hub リリースより遅れる場合があります。

インストール後、スタートメニューまたはシステムトレイから OpenClaw Companion を起動します。インストーラーでは、Gateway Setup、Chat、Settings、 Check for Updates、およびアンインストール用のショートカットも追加されます。

Windows Hub に含まれる機能

  • システムトレイのステータス表示とログイン時起動。
  • アプリ所有のローカル WSL Gateway の初回セットアップ。
  • ローカル、リモート、および SSH トンネル経由の Gateway の接続設定。
  • ネイティブのチャットウィンドウとブラウザー版 Control UI へのアクセス。
  • セッション、使用量、チャンネル、Node、ペアリング、 および修復コマンドに関する Command Center の診断機能。
  • エージェント制御のキャンバス、画面、カメラ、 通知、デバイスステータス、トーク、および制御された system.run のための Windows Node モード。
  • Claude Desktop、Claude Code、 Cursor などの MCP クライアント向けのローカル MCP サーバーモード。

初回起動

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

すでに Gateway がある場合は、Advanced setup を選択するか、Connections タブを開きます。次のものに接続できます。

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

セットアップが完了すると、トレイアイコンが緑色になります。トレイから Command Center を開き、 接続、ペアリング、Node の状態、およびチャンネルの正常性を確認します。

Windows Node モード

Windows Hub は OpenClaw Node として登録できるため、エージェントは宣言された Windows ネイティブ機能を Gateway 経由で使用できます。Node コマンドを実行するには、そのコマンドが Node によって宣言され、Gateway ポリシーによって許可されている必要があります。完全な許可/拒否モデルについては、 Node を参照してください。

一般的なコマンド:

ファミリー コマンド
キャンバス 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
トーク talk.ptt.start, talk.ptt.stop, talk.ptt.cancel, talk.ptt.once, talk.speak

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

powershell
openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

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

ローカル MCP モード

Windows Hub は、同じ Windows ネイティブ機能レジストリを loopback 上のローカル MCP サーバーとして公開できるため、ローカル MCP クライアントは実行中の OpenClaw Gateway なしで Windows 機能を操作できます。

Windows Hub の Settings にある開発者向け/詳細設定セクションで有効にします。 サーバーが有効になると、アプリに loopback エンドポイントと bearer トークンが表示されます。

モード一覧:

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

ネイティブ Windows CLI と Gateway

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

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

確認:

powershell
openclaw --versionopenclaw doctoropenclaw gateway status --json

管理対象の起動では、利用可能な場合に Windows Scheduled Tasks を使用します。タスクは 読みやすい gateway.cmd スクリプトを OpenClaw の状態ディレクトリに保持しますが、生成された 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# またはディストリビューションを明示的に選択: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

再起動後、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 接続する場合は、Windows ホストの IP を指定します（例: ssh user@windows-host -p 2222）。
  • リモート Node は、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 からオペレーターまたは Node の要求を承認します。

powershell
openclaw devices listopenclaw devices approve <requestId>

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

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 やプルリクエストに貼り付けたりしないでください。

関連項目

Was this useful?
On this page

On this page