Windows PC に OpenClaw をインストールする完全ガイド:ゼロから AI アシスタントを起動まで
OpenClaw とは?
OpenClaw はセルフホスト型 AI アシスタントゲートウェイで、普段使っているチャットアプリ(WhatsApp、Telegram、Discord、iMessage など)と AI プログラミングアシスタントを接続できます。自分のマシンで実行し、データを完全にコントロール、ホスティングサービスに依存する必要はありません。
核心特徴:
- セルフホスト:あなたのハードウェアで実行、あなたのルール
- マルチチャネルサポート:1つのゲートウェイで複数のチャットプラットフォームに同時対応
- AI エージェント向け:ツール呼び出し、セッション管理、メモリーシステム、マルチエージェントルーティングをサポート
- オープンソース:MIT ライセンス、コミュニティ駆動
簡単に言えば、Node.js 22+、1つの API キー、5分の時間があれば、いつでも使える AI アシスタントを持てます。
Windows ユーザーの推奨方案:WSL2
OpenClaw は Windows 上でWSL2(Windows Subsystem for Linux)経由での実行を推奨、特に Ubuntu ディストリビューションがおすすめです。
なぜ WSL2?
- ランタイムの一貫性:WSL2 は完全な Linux 環境を提供、OpenClaw のランタイムが macOS/Linux 版と完全に一致することを保証
- ツール互換性が良い:Node.js、pnpm、スキルスクリプトなどのツールは Linux 環境でより良く動作
- インストールが簡単:
wsl --installコマンド1つで WSL2 インストール完了
注:ネイティブ Windows 版のコンパニオンアプリは計画中ですが、現在は WSL2 の使用を推奨します。
完全インストールフロー
ステップ1:WSL2 と Ubuntu をインストール
PowerShell を管理者モードで開く
Win + Xを押し、「Windows PowerShell(管理者)」または「Windows ターミナル(管理者)」を選択
WSL2 をインストール
1
wsl --install
明確に Ubuntu 24.04 を指定したい場合:
1
2
3
4
5# 利用可能なディストリビューションを確認
wsl --list --online
# Ubuntu 24.04 をインストール
wsl --install -d Ubuntu-24.04PC を再起動
インストール完了後、Windows が再起動を促したら再起動してください。
Ubuntu を初回起動
再起動後、「スタートメニュー」を開き、「Ubuntu」を検索して起動。初回起動時に以下を求められます:
- Linux ユーザー名を設定(小文字推奨)
- パスワードを設定(入力時は表示されません、これは正常です)
ステップ2:systemd を有効化(必須)
OpenClaw の Gateway サービスは systemd サポートが必要です。
Ubuntu ターミナルで以下のコマンドを実行:
1
2
3
4sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOFWSL2 をシャットダウン
PowerShell(管理者)に戻り、実行:
1
wsl --shutdown
Ubuntu を再度開く
スタートメニューから再び Ubuntu を起動。
systemd が有効化されたか確認
1
systemctl --user status
systemd の状態出力が見えれば(エラーでも問題なし、「command not found」でなければOK)、有効化成功です。
ステップ3:Node.js 22+ をインストール
OpenClaw は Node.js 22 以降が必要です。
推奨:nvm(Node Version Manager)を使用
nvm をインストール
1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
ターミナルを再起動またはシェル設定を再読込
1
2
3source ~/.bashrc
# または、zsh を使用している場合
source ~/.zshrcNode.js 22 をインストール
1
2
3nvm install 22
nvm use 22
nvm alias default 22インストール確認
1
2node --version # v22.x.x が表示されるはず
npm --version
ステップ4:OpenClaw をインストール
OpenClaw CLI をグローバルインストール
1
npm install -g @openclaw/cli
インストール確認
1
openclaw --version
バージョン番号が表示されれば成功です。
ステップ5:OpenClaw Gateway を初期化
Gateway を初期化
1
openclaw gateway init
プロンプトが表示されます:
- Agent ID を入力(例:
main、デフォルトでOK) - Model provider を選択(例:
anthropic、openai、zenmuxなど) - API キーを入力(あなたの AI provider の API キー)
- Agent ID を入力(例:
設定ファイルを確認
初期化後、設定ファイルは
~/.openclaw/openclaw.jsonに生成されます。1
cat ~/.openclaw/openclaw.json
ステップ6:Gateway を起動
Gateway を起動
1
openclaw gateway start
起動状態を確認
1
openclaw gateway status
active (running)と表示されれば成功です。ログを確認
1
openclaw gateway logs
リアルタイムでログを確認できます(Ctrl+C で終了)。
ステップ7:WebChat で試す
OpenClaw には組み込みの WebChat インターフェースがあります。
ブラウザを開く
アドレスバーに以下を入力:
1
http://localhost:17550
(デフォルトポート。設定で変更している場合は対応するポートを使用)
AI とチャット開始
WebChat インターフェースで、あなたの AI アシスタントと直接会話できます!
トラブルシューティング
Node.js バージョンが古い
問題:node --version が v22 未満を表示
解決:
1 | nvm install 22 |
systemd が有効化されていない
問題:Gateway 起動時に systemd エラー
解決:
/etc/wsl.confを確認- WSL をシャットダウン(PowerShell で
wsl --shutdown) - Ubuntu を再起動
ポート競合
問題:Port 17550 is already in use
解決方法1:他のプログラムを停止
1 | # どのプログラムがポートを使用しているか確認 |
解決方法2:ポートを変更~/.openclaw/openclaw.json を編集、port フィールドを変更。
API キーエラー
問題:Invalid API key または Authentication failed
解決:
- API キーが正しいか確認
- API キーに十分なクレジットがあるか確認
- 設定ファイルを再編集:
1
openclaw gateway config.patch
次のステップ
Gateway が正常に動作したら、以下を試せます:
- チャネルを追加:Telegram、Discord、WeChat などを接続
- Skills を探索:OpenClaw のスキルシステムを使用して AI の能力を拡張
- カスタマイズ:
~/.openclaw/openclaw.jsonを編集して動作を調整 - コミュニティに参加:Discord、GitHub で他のユーザーと交流
参考リンク
- 公式ドキュメント:https://docs.openclaw.ai
- GitHub リポジトリ:https://github.com/openclaw/openclaw
- Discord コミュニティ:https://discord.com/invite/clawd
- スキルハブ:https://clawhub.com
おめでとうございます! あなたは今、自分の AI アシスタントを持っています。
何か問題があれば、公式ドキュメントを確認するか、コミュニティで質問してください。
楽しんでください!🎉
関連読書:

