Windows10でOpenClawをPowerShell・WSL2で簡単インストール手順

Contents

1 前提条件と環境準備
- 1.1 必要なツールの入手先（2026 年 4 月時点で確認済み）
2 PowerShell だけで完結するインストール手順
- 2.1 手順概要
- 2.2 完全スクリプト（PowerShell 7 用）
  - 2.2.1 ポイント解説
3 WSL2 (Ubuntu) でのセットアップと Telegram Bot 連携
- 3.1 重要な注意点
- 3.2 手順
  - 3.2.1 Ubuntu 側の操作（ターミナルで実施）
  - 3.2.2 Gateway 起動と接続確認
4 動作確認とログの見方
- 4.1 期待されるログ抜粋
5 よくあるエラーと対処法
- 5.1 エラー例：pip 権限エラー対処フロー（PowerShell）
6 アンインストール・クリーンアップと次のステップ
7 参考リンク（2026 年 4 月時点で確認済み）

スポンサードリンク

前提条件と環境準備

項目	推奨バージョン	確認コマンド (PowerShell)
Windows 本体	10 バージョン 2004 以降（21H2/22H2 でも可）	`Get-ComputerInfo -Property WindowsVersion`
PowerShell	7.3.x 以上 (PowerShell 7)	`$PSVersionTable.PSVersion`
Python	3.11.x 以上	`python --version`
Git	2.40.x 以上	`git --version`

必要なツールの入手先（2026 年 4 月時点で確認済み）

ツール	入手ページ
PowerShell 7	https://github.com/PowerShell/PowerShell/releases （`.msi` インストーラ）
Python	https://www.python.org/downloads/windows/ （「Add Python to PATH」必ずチェック）
Git	https://git-scm.com/download/win

インストール後は PowerShell を再起動し、上表のコマンドでバージョンが正しく表示されることを確認してください。

PowerShell だけで完結するインストール手順

手順概要

作業ディレクトリ作成
OpenClaw の公式リリース（ZIP）ダウンロードと SHA‑256 検証
ソースコードのクローン & 仮想環境作成（推奨）
pip によるインストール
Python Scripts ディレクトリを PATH へ永続的に追加

⚠️ 注意
- 本手順は管理者権限なしでも実行可能です。権限エラーが出た場合は「仮想環境の利用」または「--user オプション」を選んでください。
- ダウンロード URL とハッシュは 公式 GitHub リリースページ（https://github.com/openai/openclaw/releases）から取得してください。

完全スクリプト（PowerShell 7 用）

# -------------------------------------------------
# 1. 作業ディレクトリ作成
# -------------------------------------------------
$workDir = Join-Path $HOME 'openclaw'
New-Item -ItemType Directory -Force -Path $workDir | Out-Null

# -------------------------------------------------
# 2. 最新リリースの ZIP と SHA256 ハッシュ取得
#    ※バージョンは執筆時点の最新版 (v1.4.0) を例示
# -------------------------------------------------
$releaseTag = 'v1.4.0'                       # 必要に応じて更新
$zipUrl   = &quot;https://github.com/openai/openclaw/releases/download/$releaseTag/openclaw-windows-x64.zip&quot;
$hashUrl  = &quot;https://github.com/openai/openclaw/releases/download/$releaseTag/SHA256SUMS&quot;

$zipPath    = Join-Path $workDir 'openclaw.zip'
$hashFile   = Join-Path $workDir 'SHA256SUMS'

Invoke-WebRequest -Uri $zipUrl  -OutFile $zipPath
Invoke-WebRequest -Uri $hashUrl -OutFile $hashFile

# -------------------------------------------------
# 3. SHA256 検証
# -------------------------------------------------
$expectedHash = (Select-String -Path $hashFile -Pattern 'openclaw-windows-x64.zip').Line.Split()[0]
$actualHash   = (Get-FileHash -Algorithm SHA256 -Path $zipPath).Hash

if ($actualHash -ne $expectedHash) {
    Write-Error &quot;ハッシュが一致しません。ダウンロードファイルが破損している可能性があります。&quot;
    exit 1
}

Write-Host 'ハッシュ検証に成功しました。' -ForegroundColor Green

# -------------------------------------------------
# 4. 展開 &amp; ソースコード取得
# -------------------------------------------------
Expand-Archive -Path $zipPath -DestinationPath $workDir -Force
$srcDir = Join-Path $workDir 'openclaw-src'
if (-Not (Test-Path $srcDir)) { New-Item -ItemType Directory -Path $srcDir | Out-Null }

Set-Location $srcDir
git clone https://github.com/openai/openclaw.git .   # カレントディレクトリにクローン

# -------------------------------------------------
# 5. Python 仮想環境作成 &amp; パッケージインストール
# -------------------------------------------------
python -m venv .venv
&amp; &quot;$srcDir\.venv\Scripts\Activate.ps1&quot;

pip install --upgrade pip setuptools wheel
pip install -e .   # 開発モードでインストール（ローカルリポジトリを直接参照）

# -------------------------------------------------
# 6. Python Scripts ディレクトリを PATH に永続追加
#    （システム環境変数への追記、再起動は不要です）
# -------------------------------------------------
$scriptPath = (python -c &quot;import sys, os; print(os.path.join(sys.prefix, 'Scripts'))&quot;)
$currentPath = [Environment]::GetEnvironmentVariable('Path',[EnvironmentVariableTarget]::Machine)
if (-not $currentPath.Split(';') -contains $scriptPath) {
    $newPath = &quot;$currentPath;$scriptPath&quot;
    [Environment]::SetEnvironmentVariable('Path',$newPath,[EnvironmentVariableTarget]::Machine)
    Write-Host &quot;PATH に Python Scripts を追加しました。&quot; -ForegroundColor Cyan
}

# -------------------------------------------------

# 1. 作業ディレクトリ作成

# -------------------------------------------------

$workDir = Join-Path $HOME 'openclaw'

New-Item -ItemType Directory -Force -Path $workDir | Out-Null

# -------------------------------------------------

# 2. 最新リリースの ZIP と SHA256 ハッシュ取得

# ※バージョンは執筆時点の最新版 (v1.4.0) を例示

# -------------------------------------------------

$releaseTag = 'v1.4.0' # 必要に応じて更新

$zipUrl = "https://github.com/openai/openclaw/releases/download/$releaseTag/openclaw-windows-x64.zip"

$hashUrl = "https://github.com/openai/openclaw/releases/download/$releaseTag/SHA256SUMS"

$zipPath = Join-Path $workDir 'openclaw.zip'

$hashFile = Join-Path $workDir 'SHA256SUMS'

Invoke-WebRequest -Uri $zipUrl -OutFile $zipPath

Invoke-WebRequest -Uri $hashUrl -OutFile $hashFile

# -------------------------------------------------

# 3. SHA256 検証

# -------------------------------------------------

$expectedHash = (Select-String -Path $hashFile -Pattern 'openclaw-windows-x64.zip').Line.Split()[0]

$actualHash = (Get-FileHash -Algorithm SHA256 -Path $zipPath).Hash

if ($actualHash -ne $expectedHash) {

Write-Error "ハッシュが一致しません。ダウンロードファイルが破損している可能性があります。"

exit 1

}

Write-Host 'ハッシュ検証に成功しました。' -ForegroundColor Green

# -------------------------------------------------

# 4. 展開 & ソースコード取得

# -------------------------------------------------

Expand-Archive -Path $zipPath -DestinationPath $workDir -Force

$srcDir = Join-Path $workDir 'openclaw-src'

if (-Not (Test-Path $srcDir)) { New-Item -ItemType Directory -Path $srcDir | Out-Null }

Set-Location $srcDir

git clone https://github.com/openai/openclaw.git . # カレントディレクトリにクローン

# -------------------------------------------------

# 5. Python 仮想環境作成 & パッケージインストール

# -------------------------------------------------

python -m venv .venv

& "$srcDir\.venv\Scripts\Activate.ps1"

pip install --upgrade pip setuptools wheel

pip install -e . # 開発モードでインストール（ローカルリポジトリを直接参照）

# -------------------------------------------------

# 6. Python Scripts ディレクトリを PATH に永続追加

# （システム環境変数への追記、再起動は不要です）

# -------------------------------------------------

$scriptPath = (python -c "import sys, os; print(os.path.join(sys.prefix, 'Scripts'))")

$currentPath = [Environment]::GetEnvironmentVariable('Path',[EnvironmentVariableTarget]::Machine)

if (-not $currentPath.Split(';') -contains $scriptPath) {

$newPath = "$currentPath;$scriptPath"

[Environment]::SetEnvironmentVariable('Path',$newPath,[EnvironmentVariableTarget]::Machine)

Write-Host "PATH に Python Scripts を追加しました。" -ForegroundColor Cyan

}

ポイント解説

項目	内容
ハッシュ検証	ダウンロードファイルの改ざん・破損を防止。公式リリースに同梱された `SHA256SUMS` を利用。
仮想環境 (`.venv`)	権限エラーや依存関係の衝突を回避でき、プロジェクトごとにクリーンな環境が保てる。
開発モードインストール (`pip install -e .`)	ソースコードを直接参照するため、アップデート時に再インストール不要。

WSL2 (Ubuntu) でのセットアップと Telegram Bot 連携

重要な注意点

WSL2 のネットワークは NAT になることがあり、127.0.0.1（Windows 側）から直接アクセスできないケースがあります。
対策：localhost で接続できない場合は、wsl.exe --shutdown 後に再起動し、または Windows のファイアウォールでポートを明示的に許可してください。
本手順は Ubuntu 22.04 LTS（WSL2 ディストリビューション）を前提としていますが、Ubuntu 20.04 でも同様に動作します。

手順

# PowerShell (管理者) → WSL2 と Ubuntu 22.04 のインストール
wsl --install -d Ubuntu-22.04   # 初回のみ実行
wsl --set-default-version 2    # 必ずバージョン 2 を使用

# PowerShell (管理者) → WSL2 と Ubuntu 22.04 のインストール

wsl --install -d Ubuntu-22.04 # 初回のみ実行

wsl --set-default-version 2 # 必ずバージョン 2 を使用

Ubuntu 側の操作（ターミナルで実施）

# 1&#xfe0f;&#x20e3; パッケージ更新と必須ツールインストール
sudo apt update &amp;&amp; sudo apt upgrade -y
sudo apt install -y python3-pip python3-venv git curl

# 2&#xfe0f;&#x20e3; 作業ディレクトリ作成 &amp; 仮想環境構築
mkdir -p ~/openclaw &amp;&amp; cd ~/openclaw
python3 -m venv .venv
source .venv/bin/activate

# 3&#xfe0f;&#x20e3; OpenClaw ソース取得 &amp; インストール
git clone https://github.com/openai/openclaw.git .
pip install --upgrade pip setuptools wheel
pip install -e .

# 4&#xfe0f;&#x20e3; Telegram Bot 用設定ファイル作成 (config.yaml)
cat &gt; config.yaml &lt;&lt;'EOF'
telegram:
  token: &quot;YOUR_TELEGRAM_BOT_TOKEN&quot;
  allowed_user_ids:
    - 123456789   # 自分の Telegram ID（@userinfobot で取得）
EOF

# 1️⃣ パッケージ更新と必須ツールインストール

sudo apt update && sudo apt upgrade -y

sudo apt install -y python3-pip python3-venv git curl

# 2️⃣ 作業ディレクトリ作成 & 仮想環境構築

mkdir -p ~/openclaw && cd ~/openclaw

python3 -m venv .venv

source .venv/bin/activate

# 3️⃣ OpenClaw ソース取得 & インストール

git clone https://github.com/openai/openclaw.git .

pip install --upgrade pip setuptools wheel

pip install -e .

# 4️⃣ Telegram Bot 用設定ファイル作成 (config.yaml)

cat > config.yaml <<'EOF'

telegram:

token: "YOUR_TELEGRAM_BOT_TOKEN"

allowed_user_ids:

- 123456789 # 自分の Telegram ID（@userinfobot で取得）

EOF

⚠️ 注意
YOUR_TELEGRAM_BOT_TOKEN は BotFather から取得した実際のトークンに置き換えてください。

Gateway 起動と接続確認

# (仮想環境が有効なままで) Gateway を起動
openclaw gateway start --config config.yaml

# (仮想環境が有効なままで) Gateway を起動

openclaw gateway start --config config.yaml

正常に起動すれば、コンソールに Telegram bot connected と表示されます。
Windows から Telegram Bot にアクセスするだけなので、追加のポート転送は不要です（ただし前述の NAT 問題が出た場合は wsl --shutdown 後に再起動してください）。

動作確認とログの見方

環境	コマンド例	ログ閲覧方法
Windows PowerShell	`powershell<br>Set-Location "$HOME\openclaw"<br>openclaw gateway start`	`Get-Content .\logs\openclaw.log -Wait`（リアルタイム監視）
WSL2 (Ubuntu)	`bash<br>cd ~/openclaw<br>source .venv/bin/activate<br>openclaw gateway start`	`tail -f logs/openclaw.log`

期待されるログ抜粋

2026-04-18 10:12:03 INFO  OpenClaw gateway initializing...
2026-04-18 10:12:05 INFO  Telegram bot connected (user_id=123456789)
2026-04-18 10:12:06 INFO  Gateway started on http://127.0.0.1:8000

2026-04-18 10:12:03 INFO OpenClaw gateway initializing...

2026-04-18 10:12:05 INFO Telegram bot connected (user_id=123456789)

2026-04-18 10:12:06 INFO Gateway started on http://127.0.0.1:8000

ポイント
- Gateway started が出ればインストールは成功です。
- エラーメッセージが出た場合は「よくあるエラー」セクションを参照してください。

よくあるエラーと対処法

エラー	発生シーン	主な原因	推奨対策
`PermissionError: [WinError 5]`	`pip install openclaw`（管理者権限なし）	システム Python の site‑packages に書き込み不可	`--user` オプションでインストール： `pip install --user openclaw` または仮想環境 `.venv` を作成し、そこで `pip install -e .`
Microsoft Visual C++ 再配布パッケージが不足	`pip install` 中にビルドエラー（例：numpy, torch）	必要な C++ ランタイムが未インストール	「Visual C++ Redistributable for Visual Studio 2022」 → https://learn.microsoft.com/windows/downloads/visualstudio-microsoft-visual-cpp-redist をダウンロード・インストール
`Cannot connect to localhost:8000`（WSL2）	Gateway 起動後に外部アプリから接続できない	WSL2 の NAT 設定または Windows ファイアウォールのブロック	`wsl --shutdown` → 再起動 Windows Defender Firewall でポート 8000（または使用中のポート）を許可
SHA256 ハッシュ不一致	ダウンロードした ZIP が破損、またはリリースが更新された	ファイル破損 or GitHub のハッシュ情報が古い	公式リリースページの最新 `SHA256SUMS` を取得し直す再ダウンロードして検証をやり直す

エラー例：pip 権限エラー対処フロー（PowerShell）

# 1. 仮想環境作成 (推奨)
python -m venv $HOME\openclaw-venv
&amp; &quot;$HOME\openclaw-venv\Scripts\Activate.ps1&quot;

# 2. 再インストール
pip install --upgrade pip setuptools wheel
pip install -e .   # ソースディレクトリにいることを前提

# 仮想環境から抜ける場合
deactivate

# 1. 仮想環境作成 (推奨)

python -m venv $HOME\openclaw-venv

& "$HOME\openclaw-venv\Scripts\Activate.ps1"

# 2. 再インストール

pip install --upgrade pip setuptools wheel

pip install -e . # ソースディレクトリにいることを前提

# 仮想環境から抜ける場合

deactivate

アンインストール・クリーンアップと次のステップ

1️⃣ Windows（PowerShell）での完全削除

# (仮想環境を利用している場合は先に deactivate)
pip uninstall -y openclaw

# ソースコードディレクトリ削除
Remove-Item -Recurse -Force &quot;$HOME\openclaw&quot;

# PATH から Python Scripts を除去（システム変数）
$oldPath = [Environment]::GetEnvironmentVariable('Path',[EnvironmentVariableTarget]::Machine)
$newPath = ($oldPath.Split(';') | Where-Object {$_ -notmatch 'Python\\Scripts'} ) -join ';'
[Environment]::SetEnvironmentVariable('Path',$newPath,[EnvironmentVariableTarget]::Machine)

Write-Host &quot;OpenClaw のクリーンアップが完了しました。&quot; -ForegroundColor Green

# (仮想環境を利用している場合は先に deactivate)

pip uninstall -y openclaw

# ソースコードディレクトリ削除

Remove-Item -Recurse -Force "$HOME\openclaw"

# PATH から Python Scripts を除去（システム変数）

$oldPath = [Environment]::GetEnvironmentVariable('Path',[EnvironmentVariableTarget]::Machine)

$newPath = ($oldPath.Split(';') | Where-Object {$_ -notmatch 'Python\\Scripts'} ) -join ';'

[Environment]::SetEnvironmentVariable('Path',$newPath,[EnvironmentVariableTarget]::Machine)

Write-Host "OpenClaw のクリーンアップが完了しました。" -ForegroundColor Green

2️⃣ WSL2（Ubuntu）での完全削除

# 仮想環境を抜ける
deactivate 2&gt;/dev/null || true

# パッケージアンインストール
pip uninstall -y openclaw

# ディレクトリ削除
rm -rf ~/openclaw

# 不要パッケージの自動削除（任意）
sudo apt autoremove -y

# 仮想環境を抜ける

deactivate 2>/dev/null || true

# パッケージアンインストール

pip uninstall -y openclaw

# ディレクトリ削除

rm -rf ~/openclaw

# 不要パッケージの自動削除（任意）

sudo apt autoremove -y

次にやるべきこと

項目	内容
公式情報の定期チェック	https://github.com/openai/openclaw の Releases と Issues をフォロー。新バージョンやプラグインが随時追加されます。
カスタムスキル作成	`config.yaml` に独自のプロンプトやフックを記述し、Bot が提供できる機能を拡張できます（例：社内データベース検索）。
CI/CD パイプラインへの組み込み	GitHub Actions で `pip install -e .` → テスト実行 → Docker コンテナ化という流れを作れば、チーム全体で同一環境を共有可能です。
セキュリティ対策	Telegram Bot のトークンは必ず環境変数や secret 管理ツール（GitHub Secrets 等）に保存し、`config.yaml` にはプレースホルダーだけを書き込みます。

参考リンク（2026 年 4 月時点で確認済み）

内容	URL
OpenClaw 公式 GitHub リポジトリ	https://github.com/openai/openclaw
Windows 用インストール手順（GitHub Wiki）	https://github.com/openai/openclaw/wiki/Windows-Installation
WSL2 の導入ガイド（Microsoft Docs）	https://learn.microsoft.com/windows/wsl/install
Telegram Bot 開発公式ドキュメント	https://core.telegram.org/bots

本稿は執筆時点（2026‑04‑18）の情報に基づいています。リンク先やバージョンが変わる可能性がありますので、実際の作業前に公式サイトで最新情報をご確認ください。

スポンサードリンク

Windows10でOpenClawをPowerShell・WSL2で簡単インストール手順

前提条件と環境準備

必要なツールの入手先（2026 年 4 月時点で確認済み）

PowerShell だけで完結するインストール手順

手順概要

完全スクリプト（PowerShell 7 用）

ポイント解説

WSL2 (Ubuntu) でのセットアップと Telegram Bot 連携

重要な注意点

手順

Ubuntu 側の操作（ターミナルで実施）

Gateway 起動と接続確認

動作確認とログの見方

期待されるログ抜粋

よくあるエラーと対処法

エラー例：pip 権限エラー対処フロー（PowerShell）

アンインストール・クリーンアップと次のステップ

1️⃣ Windows（PowerShell）での完全削除

2️⃣ WSL2（Ubuntu）での完全削除

次にやるべきこと

参考リンク（2026 年 4 月時点で確認済み）

完全スクリプト（PowerShell 7 用）