問題の説明
npm install -g openclaw でインストールが成功した後、ターミナルで openclaw コマンドを実行すると、コマンドが見つからないと表示されます。
$ openclaw --version
bash: openclaw: command not found
またはWindows上では：
'openclaw' は内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。
PowerShellの場合：
openclaw: The term 'openclaw' is not recognized as the name of a cmdlet, function, script file, or operable program.
npmでグローバルインストールされたパッケージは、特定のグローバルディレクトリに配置され、そのディレクトリ内に実行ファイルのシンボリックリンクが作成されます。このディレクトリがシステムの PATH 環境変数に含まれていない場合、ターミナルは openclaw コマンドを見つけることができません。
診断手順
ステップ1：npmグローバルインストールパスを確認する
以下のコマンドでnpmグローバルパッケージのインストールプレフィックスを確認します。
npm prefix -g
以下のようなパスが出力されます。
- Linux / macOS：
/usr/localまたは/home/ユーザー名/.nvm/versions/node/v22.x.x - Windows：
C:\Users\ユーザー名\AppData\Roaming\npm
グローバル実行ファイルは、このパスの bin（Linux/macOS）またはルートディレクトリ（Windows）にあります。
ステップ2：openclawバイナリファイルの存在を確認する
# Linux / macOS
ls -la $(npm prefix -g)/bin/openclaw
# Windows (Git Bash)
ls -la "$(npm prefix -g)/openclaw.cmd"
ファイルが存在する場合、インストール自体には問題がなく、PATH設定だけが正しくありません。ファイルが存在しない場合は、インストールプロセスでエラーが発生した可能性があり、再インストールが必要です。
ステップ3：PATH環境変数を確認する
echo $PATH
出力の中でnpmグローバルパスを探します。見つからない場合は、手動で追加する必要があります。
npmが提供するパス表示ツールも使用できます。
npm bin -g
これはグローバル実行ファイルが配置されているディレクトリパスを直接出力します。
解決方法
Linux / macOSユーザー
npmグローバルbinディレクトリをPATHに追加します。使用しているシェルに応じた設定ファイルを編集してください。
# Bashユーザー
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# Zshユーザー
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
nvmでNode.jsを管理している場合、通常nvmの初期化スクリプトが自動的にPATHを設定します。シェル設定ファイルにnvmの初期化コードが含まれているか確認してください。
grep -n "nvm" ~/.bashrc
以下のような行が確認できるはずです。
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
これらの行が存在しないか、コメントアウトされている場合は、コメントを解除するか再度追加してください。
Windowsユーザー
Windowsのnpmグローバルパスは通常 %APPDATA%\npm です。これをシステム環境変数PATHに追加する必要があります。
Win + Rを押してsysdm.cplと入力し、Enterキーを押す- 「詳細設定」タブに切り替えて「環境変数」をクリック
- 「ユーザー変数」の中から
Pathを見つけてダブルクリックして編集 - 新しいエントリを追加：
%APPDATA%\npm - OKで保存し、ターミナルを再度開く
PowerShellで素早く追加することもできます。
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:APPDATA\npm", "User")
追加後、ターミナルを再起動して変更を反映させる必要があります。
npxを一時的な代替として使用する
OpenClawをすぐに使用したいがPATHの修正がまだできない場合は、npxを通じて直接実行できます。
npx openclaw --version
npx openclaw start
npxは自動的にグローバルインストールされたパッケージを検索するか、一時的にダウンロードして実行します。ただしこれは長期的な解決策ではないため、できるだけ早くPATH設定を修正することをお勧めします。
pnpmまたはyarnでグローバルインストールする
pnpmまたはyarnをパッケージマネージャーとして使用している場合、グローバルインストールパスが異なる場合があります。
# pnpm
pnpm add -g openclaw
pnpm bin -g # グローバルbinパスを確認
# yarn
yarn global add openclaw
yarn global bin # グローバルbinパスを確認
対応するbinパスがPATHに含まれていることを確認してください。
修正の確認
PATHを修正した後、新しいターミナルウィンドウを開いてください（これは重要です。古いウィンドウでは更新された環境変数が読み込まれない場合があります）。
openclaw --version
which openclaw # Linux / macOS
where openclaw # Windows
バージョン番号と実行ファイルのパスが出力されれば、問題は解決しています。次に設定を初期化できます。
openclaw init
これにより、~/.openclaw/ ディレクトリにデフォルトの openclaw.json 設定ファイルが作成されます。