【2026年2月最新】OpenClaw を WSL2 にインストールする完全ガイド（トラブルシューティング付き）

はじめに

OpenClaw は、LLM（大規模言語モデル）をローカル環境に接続し、Telegram・WhatsApp・Discord などのメッセージングプラットフォームと連携できるセルフホスト型AIエージェントです。

Windows ではネイティブ実行は非推奨であり、WSL2（Ubuntu）が唯一の公式サポートパスです。

本記事では、WSL2 環境へのインストールから、よくあるエラーの解決まで、実際に動作確認済みの手順をまとめます。

動作要件

項目	要件
OS	Windows 10 / 11
RAM	4GB以上推奨（最低1GB）
Node.js	22 以上（必須）
WSL	バージョン 2（必須）

Step 1：WSL2 を有効化する

PowerShell を管理者として起動し、以下を実行します。

wsl --install

デフォルトで Ubuntu 24.04 がインストールされます。完了後、PCを再起動してください。

再起動後、スタートメニューから「Ubuntu」を起動し、ユーザー名とパスワードを設定します。

WSL バージョンの確認

wsl --list --verbose

VERSION が 1 の場合はアップグレードが必要です：

wsl --set-version Ubuntu 2

Step 2：Node.js 22 をインストールする（WSL Ubuntu 内）

以降のコマンドはすべて WSL Ubuntu のターミナル内で実行してください。
プロンプトが username@...:~$ であることを確認してください（PS C:\... は PowerShell なので NG）。

nvm（Node Version Manager）を使うのが推奨です：

# nvm をインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc

# Node.js 22 をインストール
nvm install 22
nvm use 22

# バージョン確認（v22.x.x であればOK）
node --version

Step 3：OpenClaw をインストールする

npm install -g openclaw@latest

バージョンを確認：

openclaw --version

Step 4：オンボーディング（初期設定）

openclaw onboard --install-daemon

--install-daemon フラグにより、OpenClaw が systemd のバックグラウンドサービスとして登録され、OS再起動後も常駐します。

ウィザードでは以下を設定します：

セキュリティ警告の確認
Config handling → Update values を選択
Model/auth provider → 使いたい LLM プロバイダーを選択
API キーの入力
Gateway サービスの選択

主要な LLM プロバイダーと API キー取得先

プロバイダー	API キー取得先
Anthropic（Claude）	https://console.anthropic.com/
OpenAI（GPT）	https://platform.openai.com/api-keys
Google（Gemini）	https://aistudio.google.com/apikey

API キーには課金が必要なプロバイダーもあります。残高不足だとメッセージを送っても応答がありません。

Step 5：API キーが正しいか確認する

モデル設定の確認：

openclaw models status

設定ファイル内のモデル情報を確認：

cat ~/.openclaw/openclaw.json | grep -A 5 -i model

何も表示されない場合、モデルが未設定です。 Step 4 のオンボーディングをやり直してください。

curl で直接 API キーをテストする

Anthropic（Claude）の場合：

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: ここにAPIキーを貼る" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

OpenAI（GPT）の場合：

curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer ここにAPIキーを貼る" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-4o-mini","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

結果の見方：

レスポンス	意味
JSON で応答が返る	✅ 正常
`401 Unauthorized`	❌ API キーが無効
`429 Rate limit`	⚠️ 利用制限に到達
`insufficient_quota`	❌ 残高不足（課金が必要）

Step 6：ダッシュボード（Web UI）にアクセスする

ここが最もハマりやすいポイントです。

❌ よくある失敗

ブラウザで http://127.0.0.1:18789 を開くと、以下のエラーが表示されます：

disconnected (1008): unauthorized: gateway token missing
(open the dashboard URL and paste the token in Control UI settings)

✅ 正しいアクセス方法

トークン付きの URL でアクセスする必要があります。

openclaw dashboard --no-open

このコマンドで、トークンが付与された URL が出力されます：

http://127.0.0.1:18789/?token=xxxxxxxxxxxxxxxx

この URL をそのまま Windows 側のブラウザ（Chrome 等）にコピー＆ペーストしてアクセスしてください。

トークンを手動で確認する方法

grep -i token ~/.openclaw/openclaw.json

出力されたトークンを使って、以下の形式でブラウザにアクセスします：

http://127.0.0.1:18789/?token=ここにトークンを貼る

トークンの再生成

それでもダメな場合：

openclaw doctor --generate-gateway-token

エラーメッセージ内の「Control UI settings」は実際には存在しません（GitHub Issue #2032）。トークン入力欄は Overview → Gateway Access にあります。

Step 7：動作確認

ダッシュボードにアクセスできたら、チャット欄にメッセージを入力して送信します。

応答がない場合は、以下をチェックしてください：

① Gateway のログを確認

openclaw logs --follow

この状態でメッセージを送り、エラーが出るか確認します。Ctrl+C で終了。

② 全体の状態を確認

openclaw status --all

③ 診断を実行

openclaw doctor

④ モデル設定をやり直す

openclaw onboard

→ Update values を選択 → プロバイダーと API キーを再設定 → Gateway 再起動：

openclaw gateway restart

ターミナル UI で動作確認する（ブラウザ不要）

ブラウザに依存せず、ターミナル上で直接対話もできます：

openclaw tui

Gateway 自体が正常に動いているかの切り分けに便利です。

トラブルシューティングまとめ

症状	原因	対処
`1008: gateway token missing`	トークンなしで URL にアクセス	`openclaw dashboard --no-open` で取得した URL を使う
メッセージに応答がない	モデル/API キー未設定	`openclaw models status` で確認 → `openclaw onboard` で再設定
`401 Unauthorized`（ログ内）	API キーが無効	curl で直接テスト → キーを再取得
`insufficient_quota`	プロバイダーの残高不足	プロバイダーサイトで課金
Gateway が起動しない	ポート競合	`sudo lsof -i :18789` で確認 → 古いプロセスを停止
コマンドが見つからない	PowerShell で実行している	WSL Ubuntu ターミナル内で実行する

注意事項

OpenClaw はまだベータ段階のプロジェクトです。ツールを有効にするとファイルの読み書きやシェルコマンドの実行が可能になります。セキュリティリスクを理解した上で使用してください。

Bun は WSL2 では非推奨です。WhatsApp・Telegram との互換性問題があるため、Node.js を使ってください。
Tailscale がオフであれば、ネットワーク関連の問題は基本的に発生しません。Tailscale がオンの場合、Gateway が 127.0.0.1 ではなく Tailscale の IP にバインドされる既知の問題があります。
設定ファイルは ~/.openclaw/openclaw.json に保存されています。

＜重要＞

OpenClawでAnthropicモデルを使う：setup-tokenの設定方法

概要

OpenClawでAnthropicのモデル（Claude Opus、Sonnet等）を利用する場合、通常のAPIキー（sk-ant-api03-*）ではなく、セットアップトークン（sk-ant-oat01-*）が必要です。

これはClaude Pro/Maxサブスクリプションの認証トークンで、claude CLI（Claude Code）を使って発行します。

前提条件

Claude Pro または Max のサブスクリプションに加入していること
Node.js（v18以上）がインストール済みであること

手順

1. Claude Code（claude CLI）のインストール

npm install -g @anthropic-ai/claude-code

2. セットアップトークンの発行

claude setup-token

ブラウザが開いて認証を求められます。ログイン後、sk-ant-oat01-* 形式のトークンが発行されます。

3. OpenClawにトークンを設定

以下のいずれかのコマンドでトークンをOpenClawに登録します。

# 対話形式で設定
openclaw models auth setup-token --provider anthropic

# または、トークンを直接貼り付け
openclaw models auth paste-token --provider anthropic

4. 設定の確認

openclaw models status

正常に設定されていれば、Anthropicモデルが利用可能として表示されます。

なぜAPIキー（sk-ant-api03-*）ではだめなのか？

OpenClawはAnthropicのサブスクリプション認証（OAuth系）を使用しており、通常のAPI課金用キー（sk-ant-api03-*）とは認証方式が異なります。

キー形式	用途	OpenClawで使えるか
`sk-ant-api03-*`	API直接利用（従量課金）	❌
`sk-ant-oat01-*`	サブスクリプション認証トークン	✅

トークンの有効期限

セットアップトークンには有効期限があります。期限切れの場合は、再度 claude setup-token を実行してトークンを再発行し、OpenClawに再登録してください。

トラブルシューティング

`claude` コマンドが見つからない

# Node.jsのパスを確認
which node

# グローバルインストールを再実行
npm install -g @anthropic-ai/claude-code

トークン設定後もモデルが使えない

# OpenClawを再起動
openclaw gateway restart

# ステータスを再確認
openclaw models status

複数アカウントを使い分けたい場合

OpenClawは複数の認証プロファイルに対応しています。詳細はOpenClaw公式ドキュメントを参照してください。

参考リンク