
OpenClaw 使い方 Windows ガイド
2026年3月21日
title: "OpenClaw 使い方 Windows ガイド" slug: "openclaw-how-to-use-windows" date: "2026-03-21" description: "OpenClawをWindowsで使う方法を初心者向けに解説。WSL2を前提に、事前準備、インストール、初期設定、トラブル対処、安全な運用ポイントまで順番に整理します。" primaryKeyword: "openclaw 使い方 windows" secondaryKeywords:
- "OpenClaw Windows"
- "OpenClaw WSL2"
- "OpenClaw インストール Windows"
- "OpenClaw dashboard" searchIntent: "howto" audience: "WindowsでOpenClawを安全に使い始めたい初心者"
OpenClaw 使い方 Windows ガイド
openclaw 使い方 windows を調べているなら、最初に押さえたい結論はひとつです。2026年3月21日時点の公式ドキュメントでは、WindowsはWSL2経由で使う方法が強く推奨されています。流れとしては、wsl --install で Ubuntu を用意し、WSL2 内で OpenClaw をインストールして、openclaw onboard --install-daemon、openclaw gateway status、openclaw dashboard の順に確認するのが分かりやすいです。
この記事では、Windowsユーザー向けに、前提条件、セットアップ手順、初回の使い方、トラブルシューティング、安全に使うための注意点までをまとめます。ネイティブ Windows 向けの PowerShell インストーラーも公式にはありますが、まずは WSL2 を前提に進めるほうが安定しやすいです。
TL;DR
- Windows での OpenClaw は、公式では WSL2 + Ubuntu 推奨 です。
- 事前準備は
wsl --install、Ubuntu 初期設定、systemd有効化の3つを押さえると進めやすいです。 - OpenClaw の初回セットアップは
openclaw onboard --install-daemonが最短です。 - 動作確認は
openclaw gateway statusとopenclaw dashboardを先に使うと切り分けしやすくなります。 - セキュリティ面では、トークン認証を無効化しないこと、DM 公開を急がないことが大切です。
目次
- Windows で OpenClaw を使う前提条件
- Windows でのセットアップ手順
- 初回起動後の使い方
- Windows でよくあるトラブルと対処法
- 安全に使うためのセキュリティ注意点
- FAQ
- まとめ
Windows で OpenClaw を使う前提条件
Windows では、OpenClaw 本体をそのままネイティブ実行するより、WSL2 上の Linux 環境で動かすほうが公式に近い運用になります。OpenClaw の Windows 向けページでも、WSL2 が推奨 と案内されています。理由は、Node.js や pnpm、Linux 向けの周辺ツールと相性がよく、Gateway の常駐運用もしやすいからです。
事前に確認したい前提条件は次のとおりです。
- Windows 11 もしくは WSL2 が使える Windows 環境
- 管理者権限で PowerShell を開けること
- Ubuntu などの WSL ディストリビューションをインストールできること
- OpenClaw 用のモデル認証情報や API キーを後で入力できること
OpenClaw 側のランタイム要件としては、公式 FAQ で Node.js 22 以上 が必要とされています。導入スクリプト側では Node 24 を既定で用意する案内もあります。細かい版差で迷うより、まずは公式インストーラーや公式手順に寄せるのが安全です。
Windows でのセットアップ手順
ここでは、Windows ユーザーが一番詰まりにくい WSL2 ベースの流れを順に見ていきます。
1. WSL2 と Ubuntu を入れる
まずは管理者権限の PowerShell を開きます。公式 Windows ページでは、次のコマンドが案内されています。
wsl --install
Ubuntu を明示したい場合は、公式例として次のような流れがあります。
wsl --list --online wsl --install -d Ubuntu-24.04
Windows から再起動を求められたら、その指示に従います。ここで無理に進めず、再起動後に Ubuntu を初回起動して初期ユーザー作成まで済ませるのが大切です。
2. WSL2 側で systemd を有効にする
OpenClaw の Gateway サービス導入では、公式 Windows ページで systemd が必要 とされています。WSL の Ubuntu ターミナルで次を実行します。
sudo tee /etc/wsl.conf >/dev/null <<'EOF' [boot] systemd=true EOF
そのあと、PowerShell 側で WSL を一度停止します。
wsl --shutdown
再度 Ubuntu を開き、次で確認します。
systemctl --user status
ここが通らないと、--install-daemon を付けた OpenClaw 初期設定で詰まりやすくなります。
3. OpenClaw をインストールする
OpenClaw の Getting Started では、WSL を含む Linux 系での最短導線としてインストールスクリプトが案内されています。WSL2 の Ubuntu 側で次を実行します。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows ネイティブの PowerShell インストーラーも公式にあります。
iwr -useb https://openclaw.ai/install.ps1 | iex
ただし、Windows 向け公式ページではネイティブ実行は未検証寄りで問題が起きやすい旨が示されています。Windows ユーザーでも、本番の使い方は WSL2 を中心に考えるほうが無難です。
4. 初期設定をまとめて済ませる
CLI が入ったら、次は Onboarding を実行します。
openclaw onboard --install-daemon
公式の CLI Onboarding では、このウィザードがモデル認証、Gateway 設定、ワークスペース、チャネル、スキルなどをまとめて案内してくれます。Windows では最初から連携を増やしすぎず、まずはローカルで会話できる状態を作るのがおすすめです。
5. Gateway が起動しているか確認する
セットアップ後は、まず Gateway の状態を確認します。
openclaw gateway status
公式 Getting Started では、ここで ポート 18789 で待ち受けていることを確認する流れになっています。Dashboard がうまく開かないときも、先にここを見ると原因を切り分けやすくなります。
初回起動後の使い方
セットアップが終わったら、Windows での最初の使い方はとてもシンプルです。CLI の全部を覚える必要はなく、まずは「Dashboard で会話できるか」を確認すれば十分です。
1. Dashboard を開く
openclaw dashboard
公式 Onboarding ガイドでも、最初の会話は Control UI をブラウザで開いて試す方法が最速とされています。チャネル設定なしで使い始められるので、初期導入には向いています。
2. 認証を求められたらトークンを確認する
公式 FAQ では、ローカル接続でも OpenClaw は既定でトークン認証を要求すると説明されています。Dashboard 側で認証を求められたら、WSL 側で次を確認します。
openclaw config get gateway.auth.token
トークンが無い、または不整合が疑わしい場合は、次で再生成できます。
openclaw doctor --generate-gateway-token
3. 問題があれば診断コマンドを使う
Windows での詰まりは、WSL 側の状態確認を先にすると解決が早くなります。最初に覚えたい確認コマンドは次の3つです。
openclaw status --deep openclaw doctor openclaw health --json
status --deep は詳細確認、doctor は修復候補の洗い出し、health --json は機械的に状態を見たいときに便利です。
Windows でよくあるトラブルと対処法
openclaw コマンドが見つからない
Windows の PowerShell インストーラー説明では、openclaw が見つからない場合は PATH 周りを疑うよう案内されています。公式 Troubleshooting では、npm config get prefix の結果をユーザー PATH に追加し、PowerShell を開き直す方法が紹介されています。
WSL2 運用なら、まず「PowerShell ではなく Ubuntu 側でコマンドを打っているか」を見直すだけで直ることがあります。
Windows で npm error spawn git / ENOENT が出る
公式 Installer Internals では、このエラーが出た場合は Git for Windows をインストールし、PowerShell を開き直して再実行 とされています。ネイティブ Windows での依存関係が原因なので、WSL2 へ寄せたほうが再現性は高いです。
Dashboard が開くのに接続できない
このときは UI 側より先に Gateway 側を確認します。
openclaw gateway status openclaw status --deep
あわせて、認証トークンがずれていないかを確認します。ローカルでもトークン認証が既定なので、「localhost だから認証不要」と考えないほうが安全です。
--install-daemon 周りで詰まる
Windows では WSL2 の systemd 有効化が前提になるため、ここが未設定だと Gateway サービス導入で失敗しやすくなります。systemctl --user status が通るかを先に確認してください。
まず何から疑えばよいか迷う
迷ったときは、次の順で見ると整理しやすいです。
wsl --statusや Ubuntu 起動が正常か- Ubuntu 側で
openclaw --helpが見えるか openclaw gateway statusが通るかopenclaw dashboardで UI が開くかopenclaw doctorで修復提案が出ないか
安全に使うためのセキュリティ注意点
トークン認証を無効化しない
公式 Security と FAQ では、OpenClaw は loopback でも既定でトークン認証を使うと明記されています。Windows ローカルだけで使う場合でも、この既定をそのまま維持するのが安全です。認証を切ると、同じマシン上の別プロセスから Gateway へ接続できる余地が増えます。
トークンを URL や共有メモに貼らない
Dashboard はトークンを URL に直接埋め込む運用を避ける前提で案内されています。トークンは WSL 側で取得し、必要なときだけ UI 設定欄に貼る運用が無難です。
最初から DM を公開しない
OpenClaw では DM 受信の既定が pairing で、未知の送信者は承認コードが必要です。Windows で試す段階では、公開 DM や広い allowlist を急がず、まずは自分だけが触れるローカル構成で動かすほうが安全です。
承認フローの例は次のようになります。
openclaw pairing list --channel telegram openclaw pairing approve --channel telegram <code>
チャンネル名や実際の運用フローは環境によって変わるので、必要に応じてこの形を起点に調整してください。
リモート公開は Windows ローカル安定化の後に考える
Tailscale や SSH トンネルを使ったリモート接続は便利ですが、最初のセットアップとしては情報量が増えます。まずは Windows + WSL2 の同一マシン内で OpenClaw が安定して返答することを確認し、そのあとでリモート接続へ広げるほうが失敗しにくいです。
FAQ
Windows ネイティブだけで OpenClaw を使えますか?
公式には PowerShell 用 install.ps1 が用意されています。ただし、Windows 向けドキュメントでは WSL2 が強く推奨されているため、初心者は WSL2 を前提にしたほうが無難です。
最初に覚えるコマンドは何ですか?
Windows ユーザーなら、まずは openclaw onboard --install-daemon、openclaw gateway status、openclaw dashboard、openclaw status --deep、openclaw doctor の5つで十分です。
認証トークンはどこで確認しますか?
ローカル Gateway のトークンは、公式 FAQ にあるとおり次で確認できます。
openclaw config get gateway.auth.token
WSL2 と PowerShell のどちらで操作すべきですか?
OpenClaw の実運用を WSL2 に寄せるなら、基本操作も Ubuntu 側で行うほうが混乱しにくいです。PowerShell は WSL のインストールや停止、再起動確認など Windows 側の準備に使うイメージで考えると整理しやすくなります。
まとめ
Windows での OpenClaw の使い方は、公式どおり WSL2 を前提に組むとかなり分かりやすくなります。wsl --install で Ubuntu を用意し、systemd を有効にして、WSL2 内で openclaw onboard --install-daemon を実行し、openclaw gateway status と openclaw dashboard で確認する。この流れがいちばん失敗しにくいです。
最初の目標は、Windows 上で複雑な連携を一気に作ることではなく、ローカルで安全に会話できる状態を作ることです。そこまで確認できたら、必要に応じてチャネル連携やリモート公開へ広げていくのがおすすめです。
関連記事

AIエージェントのメモリスタックとは?2026年に重要度が上がる理由をやさしく解説
2026年4月8日
OpenClaw vs Hermes vs Claude、創業者はどれを選ぶべき?2026年版の実務比較
2026年4月8日