OpenClawが入らない？私が踏んだ7つの罠と解決法

2026-06-08 更新：設定例のモデル名を現行版に更新しました（Anthropic は claude-sonnet-4-6、OpenAI は gpt-5）。Node 要件（v22.14+、推奨 v24）、リソース要件、トラブルシュート用コマンドも 2026 年 6 月時点で再確認済みです。詳細は docs.openclaw.ai/install を優先してください。

ターミナルに何度目かの赤いエラーが表示される。OpenClawを試してみたいだけなのに、npmの権限エラー、Dockerコンテナの再起動ループ、APIキーが効かない……一つ直すとまた三つ出てくる。同じところで詰まっている人も多く、インストールのハードルは想像以上だと気づく。

公式ドキュメント通りに進めても動かない。コマンドラインのエラーが多すぎて、どこから手を付ければいいか分からない——そんな経験はありませんか。

週末いっぱいすべての罠を踏み抜いた結果、ここにトラブル回避ガイドをまとめました。OpenClawインストールで最も多い7大カテゴリの問題を取り上げ、それぞれに明確な診断手順と解決策を載せています。手順だけでなく、なぜ失敗するのかも説明するので、次に似た症状が出ても切り分けやすくなります。

低コスト「エビ飼育」ガイド：ArkClaw で AI エージェントを本当に身近に

話題の OpenClaw（ロブスタ／エビ）は便利ですが、設定のハードルが高い。ByteDance 火山引擎の ArkClaw はその敷居を一気に下げました。サーバーや Token 設定をいじらず、1 クリックで 24 時間オンライン、ブラウザ操作・スクリプト実行・カレンダー管理ができる「AI 下請け」が手に入ります。

月額 9.9 元と本当に安く、招待コード ZLKUK54M（こちらから登録）なら 8.9 元。プログラマーなら Coding Plan Pro に入ると無料で使える特典もあります。

Node.jsバージョン問題（最も多い）

OpenClawを入れる前にまず Node.js のバージョンを確認してください。最初はシステム同梱の Node 16 を使っていて、意味不明な構文エラーに遭いました。

まずバージョンを確認：

node -v

明らかに古いなら、ここを疑います。docs.openclaw.ai/install では 最低 Node.js v22.14+、推奨 Node.js v24 です。低いバージョンでは構文やランタイム API の非互換が出ます。

典型的な非互換エラー：

SyntaxError: Unexpected token '?'
TypeError: fetch is not a function

前者はランタイムが古くオプショナルチェーン等に未対応のとき、後者は v22.14 未満 か、シェルが想定と違う node を使っている（nvm 未適用など）ときに多いです。

解決策：nvm で管理するのがいちばん楽

nvm（Node Version Manager）ならバージョンを切り替えられ、他プロジェクトへの影響も少ないです。

🪟 Windows ユーザー：

nvm-windows からインストール。既存 Node.js は先にアンインストールし、PATH 競合を避けてください。

🐧 Linux / macOS ユーザー：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

nvm 導入後、公式推奨に合わせて Node.js 24 を入れる：

nvm install 24
nvm use 24
nvm alias default 24

最後の行で 24 を既定にし、新しいターミナルでも同じバージョンが使われます。

npm権限エラー（WSL2 / Linux で多発）

WSL2 では npm install のたびに EACCES が出て、本当に困りました。

エラーの例：

EACCES: permission denied, mkdir '/usr/local/lib/node_modules/openclaw'
EACCES: permission denied, open 'package.json'

前者はグローバルインストール時、後者は WSL2 の /mnt/c 配下でよく出ます。

❌ やってはいけないこと：

Vultr - 高性能NVMeクラウドサーバー、世界32拠点、Dockerワンクリック展開対応

価格を見る →広告

• sudo npm install — ファイル所有者が乱れ、後からさらに面倒になります
• chmod 777 — セキュリティ上非常に危険です
• npm config set unsafe-perm true — 根本解決になりません

✅ 正しい解決策（状況に応じて3択）：

案A：npm グローバルディレクトリを変更（Linux 全般で推奨）

グローバルインストール先をホーム配下に移します。

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

ターミナルを開き直してから再試行してください。

案B：WSL2 ファイルシステム権限の修正（WSL2 向け）

WSL2 が Windows 側（/mnt/c）をマウントするとき、Linux と権限モデルがずれます。

sudo nano /etc/wsl.conf

以下を追加：

[automount]
options = "metadata,umask=22,fmask=11"

保存後、Windows の PowerShell で：

wsl.exe --shutdown

WSL2 を開き直すと、多くの権限問題は解消します。

案C：WSL ホームで作業（いちばん単純）

/mnt/c で開発しないのが最も楽です。~/projects など WSL ネイティブパスなら npm も速く、権限トラブルも少ないです。

mkdir ~/projects
cd ~/projects
# ここで OpenClaw をセットアップ

Docker関連の問題

Docker は原因が複数ありがちで、ここでもしばらく止まりました。

診断の基本3ステップ：

# 1. コンテナ状態
docker compose ps

# 2. ログ確認
docker compose logs openclaw-gateway

# 3. エラー抽出
docker compose logs openclaw-gateway | grep -i "error"

問題A：ヘルスチェック失敗・再起動ループ

起動数秒で止まり、また起動を繰り返す症状です。ログ例：

Health check failed: container unhealthy
Container openclaw-gateway exited with code 137

多くはリソース不足です。OpenClaw は 最低 2 vCPU / 4 GB RAM、推奨 4 vCPU / 8 GB RAM です。

🪟 Windows / Mac： Docker Desktop → Settings → Resources で CPU / メモリを増やす。

🐧 Linux： 通常はホスト資源をそのまま使えます。

マシンが足りない場合の応急策（非推奨）：

# docker-compose.yml を編集
healthcheck:
  disable: true

問題B：Docker 権限エラー（Linux）

permission denied while trying to connect to the Docker daemon socket

ユーザーが docker グループに入っていません：

sudo usermod -aG docker $USER
newgrp docker

⚠️ セキュリティ注意： docker グループは実質 root 級の権限です。本番や共有サーバーでは rootless Docker を検討してください。

問題C：ポート 18789 が使用中

前回の OpenClaw プロセスが残っていることがあります。

🐧 Linux / Mac：

lsof -i :18789

🪟 Windows：

netstat -ano | findstr 18789

PID が分かったら、まずは：

openclaw gateway stop

それでもダメなら（PID は実際の値に置き換え）：

kill -9 <PID>

問題D：ARM64（Apple Silicon）

M1 / M2 Mac では Chromium パス不一致などが出ることがあります。GitHub Issues に ARM64 向け Dockerfile 例がまとまっているので参照してください。

🔥 需要のない製品に3ヶ月も無駄にするな！少額の予算で Adsterra を使い、SaaS の訴求を今すぐ検証 ➡️

今すぐ検証 →広告

APIキー設定の問題

設定したはずなのに OpenClaw がキーを見つけない——よくあるパターンです。

よく見るエラー：

No API key found for anthropic
Invalid API key format
API key validation failed

落ち着いて、下のチェックリストを順に確認してください。

チェック1：環境変数は効いているか？

echo $ANTHROPIC_API_KEY
echo $OPENAI_API_KEY

空なら未設定です。

# 一時（現在のターミナルのみ）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 永続（~/.bashrc に追記）
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc

🔧 WSL2 注意： WSL 内の環境変数と Windows は共有されません。Windows 側だけ設定しても WSL では見えません。

チェック2：設定ファイルの JSON は正しいか？

~/.openclaw/openclaw.json を使う場合、JSON 構文を厳密に守ってください。現行の状態ディレクトリは ~/.openclaw/ です。~/.clawdbot/ だけ残している場合は、シリーズの改名記事を読んでから移行してください。

よくあるミス：

• 余分なスペースや引用符
• カンマ抜け
• 最後の要素の後ろに余計なカンマ

cat ~/.openclaw/openclaw.json | jq .

jq がエラーなら JSON が壊れています。

# Ubuntu / Debian
sudo apt install jq

# macOS
brew install jq

チェック3：キー自体は有効か？

• Anthropic Claude：https://console.anthropic.com/settings/keys
• OpenAI GPT：https://platform.openai.com/api-keys

Active か、利用上限に達していないか確認します。

ヒント：プロバイダー切り替え例

{
  "defaultProvider": "anthropic",
  "anthropic": {
    "apiKey": "sk-ant-xxxxx",
    "model": "claude-sonnet-4-6"
  },
  "openai": {
    "apiKey": "sk-xxxxx",
    "model": "gpt-5"
  }
}

WSL2 環境の特別な設定

Windows で WSL2 を使うと、Linux 向け記事がそのまま当てはまらないことがあります。

主な3つの差：

1. ファイル権限モデル — 前述の npm 権限問題
2. 独立したネットワーク — localhost が通らないことがある
3. Docker Desktop 連携 — Windows と WSL2 で Docker が噛み合わないことがある

推奨 /etc/wsl.conf：

sudo nano /etc/wsl.conf

[automount]
enabled = true
root = /mnt/
options = "metadata,umask=22,fmask=11"

[interop]
enabled = true
appendWindowsPath = true

[network]
generateResolvConf = true

PowerShell で再起動：

wsl.exe --shutdown

Docker Desktop for Windows の WSL 統合：

1. Docker Desktop を開く
2. Settings → Resources → WSL Integration
3. 使っているディストリビューション（Ubuntu など）にチェック
4. Apply & Restart

性能：クロスファイルシステムを避ける

最初は Windows の D 盤（WSL では /mnt/d）で作業していて、npm install が異常に遅かった——これは WSL2 から Windows ファイルにアクセスすると I/O が 50〜90% 低下するためです。

正しいやり方：

cd ~
mkdir projects
cd projects
git clone https://github.com/openclaw/openclaw.git

作業は /home/username 配下（WSL ネイティブ）で行ってください。

リソース制限（任意）

メモリが足りない PC では C:\Users\ユーザー名\.wslconfig に：

[wsl2]
memory=4GB
processors=2
swap=2GB

ただし OpenClaw 自体がリソースを食うので、制限しすぎると動きません。

スキルインストールのタイムアウトと依存関係

初回のスキルインストールでタイムアウトし、固まったように見えることがあります。

診断：

KiloClaw - 企業向けマネージド OpenClaw、AI エージェントのオーケストレーションとスマートルーティングを加速

今すぐ始める →広告

openclaw skill check <skill-name>

Gateway ログ：

docker compose logs openclaw-gateway | grep -i "skill"

問題A：バイナリ依存が未インストール

Go などが必要なスキルは、依存がないと読み込めません。ログに従って：

sudo apt install golang-go
sudo apt install python3-dev

問題B：ネットワークタイムアウト（最多）

初回は依存のダウンロードに時間がかかり、進捗が止まって見えます。

対処はシンプル：再試行。

openclaw skill install <skill-name>

国内からなら npm ミラー：

npm config set registry https://registry.npmmirror.com

Docker イメージも国内ミラーに差し替える方法は多数あります。

問題C：OS 設定の不一致

特定ディストリビューション向けにテストされたスキルは、他環境で動かないことがあります。GitHub Issues で同様の報告を探してください。

ヒント： Go 依存スキルの初回インストールは 5〜10 分かかることもあります。ログが流れ続けていれば正常です。すぐ Ctrl+C しないでください。

体系的なトラブルシューティングフロー

個別問題のあと、全体の切り分け順序を押さえておきましょう。

OpenClaw 組み込みコマンド：

openclaw status
openclaw health
openclaw doctor

openclaw doctor は Node.js、Docker、API キー、ポートなどを一括チェックし、レポートを出してくれます。

ログの読み方：

• ERROR — grep -i "error" で抽出
• 最初のエラー — 以降は連鎖することが多い
• スタックトレース — 発生箇所の特定に有効

GitHub Issue を出す前に：

• OS とバージョン（例：Windows 11 + WSL2 Ubuntu 22.04）
• node -v
• openclaw --version
• エラーログ全文（コードブロックで）
• 再現手順

情報が多いほど、メンテナーが助けやすくなります。

まとめ

7大カテゴリの要点：

1. Node.js — nvm で v24（最低 v22.14+）を公式要件に合わせる
2. npm 権限 — グローバル先を home に変更するか、WSL ネイティブで作業
3. Docker — ログで原因を特定。多くはリソース不足かポート競合
4. API キー — 環境変数、JSON、キー有効性を確認
5. WSL2 — wsl.conf を整え、クロス FS を避ける
6. スキル — タイムアウトは再試行、依存はログに従って追加
7. 体系診断 — openclaw doctor を最初に、順番に潰す

OpenClaw のインストールは少し手間ですが、一度踏んだ罠は同じ形では再発しにくいです。エラーが出ても、どの層（Node / npm / Docker / キー / WSL / スキル）かを切り分ける習慣がいちばん大事です。

このチェックリストを保存しておけば、次回もすぐ対照できます。役に立ったら、同じように試している人にも共有してください。

記事にない問題があれば、コメントで教えてください。随時更新します。