一般的なOpenClawのインストールエラーとその修正方法

OpenClawインストールトラブルシューティングガイド

r/openclawでの最近の投稿では、OpenClawツールのインストールおよび実行時に繰り返し発生するエラーについて、具体的なコマンドと修正方法を提供しています。

主な問題と修正方法

「インストール済みだがopenclawが見つからない」

これは、npmのグローバルbinディレクトリがPATHに含まれていない場合に発生します。バイナリは存在しますが、見つけることができません。

• npm prefix -gを実行してグローバルプレフィックスを確認します。
• .bashrcまたは.zshrcで<prefix>/binを$PATHに追加します。
• シェルをリロードすると、openclaw --versionが動作するはずです。

インストール時の「EACCES: permission denied」

これは、多くの場合rootが所有するnpmのデフォルトグローバルディレクトリのパーミッション問題です。

• sudoを使用しないでください。
• 代わりにユーザー所有のプレフィックスを設定します:

  mkdir -p ~/.npm-global
  npm config set prefix '~/.npm-global'
  export PATH="$HOME/.npm-global/bin:$PATH"

• エクスポートをシェル設定に追加し、sudoなしでインストールを再実行します。

古いNode.jsによるサイレント障害

OpenClawにはNode.js 22以上が必要です。古いバージョンではエラーなくインストールされることがありますが、実行時に壊れたバイナリが生成される可能性があります。

• 常に最初にnode --versionを確認してください。

「inappropriate ioctl for device」

これはTTYの問題で、Dockerコンテナや実際の端末がないCI環境でよく発生します。

• openclaw onboard --non-interactive --accept-riskを実行して、インタラクティブウィザードをスキップします。

Telegramプラグインが「利用不可」のまま固まる

以前の壊れたインストールによりTelegramプラグインが部分的に設定された状態で残っていると、固まることがあります。

• openclaw doctor --fixを実行して状態をクリアします。

「gateway connect pairing required」についての注意

このメッセージはインストールエラーではありません。これはDMポリシーに関連しており、OpenClawはデフォルトでDMに応答する前に手動でのペアリングを必要とします。チャンネル設定に関するOpenClawのドキュメントを参照してください。