OpenClaw

OpenClaw のインストール手順：Node.js v24 と開発環境設定ガイド

ⓘ本ページはプロモーションが含まれています

お得なお知らせ

スポンサードリンク
タイプ別にすぐ選べる

AIエージェント開発、どこから始める？

MCP・Claude・LangGraph…進化が速い領域こそ「体系学習 or 1冊集中」のどちらかを選ぶのが近道です。

▷ プロ講師から体系的に学んで"仕事で使えるAIエンジニア"になりたい人

DMM 生成AI CAMP 学び放題｜無料セミナー有り▶

▷ 独学派で、まず1冊を読み込んで手を動かしたいエンジニア

【kindle本】Claude CodeによるAI駆動開発入門 ▶

※スクールは説明会のみでもOK。書籍は紙・電子どちらでも

▶ 実装リファレンスには 【kindle本】実践Claude Code入門が便利です。

スポンサードリンク

1. 前提ツールのインストール

OpenClaw は Node.js と OS 標準のビルドツールが揃っていることが前提です。以下の表に、OS 別に最低限必要なツールとインストールコマンドをまとめました。

OS 必要ツール インストール手順
macOS Xcode Command Line Tools、Homebrew bash<br>xcode-select --install<br>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"<br>
Windows 10/11 PowerShell 7（任意）、WSL 2 + Ubuntu (or Debian) 1. PowerShell 7 をインストール（[Microsoft Store] または winget install --id Microsoft.PowerShell）
2. WSL と Ubuntu のセットアップ powershell<br>wsl --install -d Ubuntu<br>
Ubuntu / Debian build‑essential、curl、git bash<br>sudo apt update && sudo apt install -y build-essential curl git<br>

備考
- すべて無料で利用できます。
- macOS の Xcode ツールは git と C/C++ コンパイラを同梱しているため、別途インストールする必要はありません。

2. Node.js の導入

2‑1. 推奨バージョンと公式情報

  • 推奨: 現時点 (2026 年) の LTS は v22.x 系。OpenClaw のドキュメントは「Node ≥ 22.14 が必須」と明記しています。
  • 注意: 記事執筆当初に v24 と表記していましたが、2026 年 4 月時点では正式リリースされていません。そのため v24 系のインストール手順は削除し、代わりに LTS 系 (v22) を対象とします。

公式インストールガイド: https://nodejs.org/ja/download/
OpenClaw の Node.js 要件ページ（2026 年版）: https://openclaw.ai/docs/ja/install/node

2‑2. インストール方法の比較

方法 メリット デメリット
公式インストーラ (macOS / Windows) GUI で簡単にセットアップできる 複数バージョン管理がしづらい
nvm (Unix 系) バージョン切替が自由自在
プロジェクトごとに異なる Node を使える		 Windows 本体では利用不可（WSL 推奨）
Homebrew (macOS) パッケージ管理と自動更新が可能 Homebrew が未インストールの場合は先に導入が必要

2‑2‑1. 公式インストーラでのインストール（macOS / Windows）

  1. 上記公式ダウンロードページから LTS (v22.x) の macOS または Windows 用インストーラを取得。
  2. 画面の指示に従ってインストール → 完了後、ターミナル／PowerShell でバージョン確認:

2‑2‑2. nvm を使ったインストール（macOS / Linux / WSL）

2‑2‑3. Homebrew でのインストール（macOS）

Homebrew のリポジトリには node@24 は存在しません。代わりに 最新 LTS (node) または 特定バージョン (node@22) を利用します。

ポイント
- brew info node で利用可能なサブバージョンを確認できます。
- Homebrew が node@22 を提供しない場合は、公式インストーラまたは nvm の併用が安全です。

3. npm と pnpm の選択と導入

項目 npm pnpm
同梱状況 Node に標準同梱 別途インストール必要
インストール速度 標準的 高速（ハッシュキャッシュ）
ディスク使用量 パッケージごとに重複保存 ハードリンクで共有、節約効果大
ロックファイル形式 package-lock.json pnpm-lock.yaml
推奨シーン 小規模・学習向き 中〜大型プロジェクト、CI/CD

3‑1. npm はインストール不要

3‑2. pnpm の導入手順

(A) Corepack 経由（Node 22+ 推奨）

(B) インストーラスクリプト

どちらの方法でも、pnpm install / pnpm add <pkg> が利用できます。

4. OpenClaw 本体のインストールとオンボーディング

4‑1. グローバルインストール

パッケージマネージャ コマンド
npm npm i -g openclaw
pnpm pnpm add -g openclaw

インストール後は必ずバージョンを確認してください。

4‑2. 初期設定 (openclaw onboard)

openclaw onboard を実行すると、対話式プロンプトが表示されます。主な項目は以下の通りです。

プロンプト 説明・例
API キー OpenAI, Anthropic, Claude などの認証キー（必須）
エージェント名 任意の名前 (my-first-agent 等)
デフォルトモデル gpt-4o, claude-3.5-sonnet, gemma4 など
プロバイダー openai, anthropic, ollama など

設定が完了すると、~/.config/openclaw/config.json が自動生成されます。

4‑3. ローカル AI エージェント構築例（Ollama + Gemma 4）

  1. Ollama のインストール（公式サイト参照）
    bash
    curl -fsSL https://ollama.com/install.sh | sh
    ollama serve & # バックグラウンドでサーバ起動

  2. Gemma 4 モデルの取得
    bash
    ollama pull gemma4

  3. OpenClaw にプロバイダー設定
    bash
    openclaw config set provider ollama --model gemma4

  4. 動作確認
    bash
    openclaw run "こんにちは、OpenClaw！"
    # → 「こんにちは、OpenClaw！」 がそのまま返れば成功

ポイント：openclaw config set … はオンボーディング後でも随時変更可能です。

5. 動作確認とトラブルシューティング

5‑1. 基本的な動作チェック

期待される出力例: Hello OpenClaw がそのまま表示されます。

5‑2. よくあるエラーと対処法

エラーメッセージ 原因 解決策
Node バージョンが古い (>=22.14 が必要) 古い Node が PATH に残っている nvm use --lts、または brew link --overwrite node で最新版に切り替える
EACCES（権限不足） グローバルインストール時に書き込み権限が無い npm: npm i -g openclaw --location=global
pnpm: pnpm add -g openclaw --unsafe-perm
PATH に未登録 インストール先ディレクトリが環境変数に含まれない macOS/Linux: export PATH=$HOME/.npm-global/bin:$PATH を .zprofile 等に追記
Windows: 「システムのプロパティ」→「環境変数」→Path に %AppData%\npm を追加
pnpm のキャッシュ破損 ローカルストアが壊れている pnpm store prune && pnpm install

5‑3. OS 別の注意点

OS 注意ポイント 推奨コマンド例
Windows (PowerShell) PowerShell 7 が未インストールの場合は手動で入れる必要がある。WSL を使えば nvm も利用可能。 winget install --id Microsoft.PowerShell
wsl --install -d Ubuntu
macOS Homebrew 経由で Node@22 を入れたら必ずリンクを作成すること。シェルは zsh がデフォルトなので .zprofile にパスを書き込む。 bash<br>echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zprofile<br>source ~/.zprofile<br>
Ubuntu / Debian apt では Node 20 系までしか提供されないことが多いため、NodeSource リポジトリまたは nvm の使用を推奨。 bash<br>curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -<br>sudo apt-get install -y nodejs<br>

6. まとめ

項目 内容
必須ツール Xcode CLI / Homebrew（macOS）
PowerShell 7 + WSL (Windows)
build‑essential (Linux)
Node.js LTS の v22.x 系 をインストール。公式インストーラ、nvm、Homebrew のいずれかで導入し node -v で確認。
パッケージマネージャ npm は同梱で即使用可。pnpm は高速・省ディスクなのでプロジェクト規模に合わせて選択。
OpenClaw 本体 npm i -g openclaw または pnpm add -g openclaw → openclaw onboard で設定完了。
ローカルエージェント例 Ollama + Gemma 4 の組み合わせで、数分でローカル AI が動作。
検証 & トラブル対策 バージョン確認・簡易テストで動作保証。Node バージョン、権限、PATH の問題は上表の手順で解決可能。

これらのステップを順に実行すれば、2026 年最新版の開発環境が整い、OpenClaw を使った AI エージェント開発をすぐに開始できる状態になります。

最新情報は公式リポジトリとドキュメントで随時チェックしてください
- OpenClaw Docs（日本語）: https://openclaw.ai/docs/ja/install/node
- Node.js LTS ダウンロード: https://nodejs.org/ja/download/

Happy coding! 🚀

スポンサードリンク

お得なお知らせ

スポンサードリンク
タイプ別にすぐ選べる

AIエージェント開発、どこから始める？

MCP・Claude・LangGraph…進化が速い領域こそ「体系学習 or 1冊集中」のどちらかを選ぶのが近道です。

▷ プロ講師から体系的に学んで"仕事で使えるAIエンジニア"になりたい人

DMM 生成AI CAMP 学び放題｜無料セミナー有り▶

▷ 独学派で、まず1冊を読み込んで手を動かしたいエンジニア

【kindle本】Claude CodeによるAI駆動開発入門 ▶

※スクールは説明会のみでもOK。書籍は紙・電子どちらでも

▶ 実装リファレンスには 【kindle本】実践Claude Code入門が便利です。

-OpenClaw