Contents
前提条件と環境準備
| 必要項目 | 目的 |
|---|---|
| Xcode Command Line Tools | clang・make などビルドに必要なコンパイラ群を提供 |
| Homebrew (macOS の事実上のパッケージマネージャ) | 依存ライブラリや Node.js を簡単にインストール |
| Node.js ≥ 20（できれば最新 LTS） | OpenClaw は Node.js アプリとして提供されているため必須 |
ポイント
- 現在 Homebrew の公式リポジトリにはnode@22がまだ存在しない場合があります。最新版 (node) をインストールすれば LTS 系 (v20 以降) が手に入ります。特定バージョンが必要なときは nvm や fnm を併用してください。
Xcode Command Line Tools のインストール
|
1 2 |
xcode-select --install |
- ダイアログが出たら「インストール」をクリックし、完了まで待ちます。
- 正しくインストールされたかは次で確認：
|
1 2 |
xcode-select -p # → /Library/Developer/CommandLineTools が表示されれば OK |
Homebrew と Node.js の導入
1. Homebrew のインストール
公式インストーラを実行します。CPU アーキテクチャに応じてパスが変わりますので、両方のケースを書いておきます。
|
1 2 |
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" |
2. パス設定（シェルごとに一度だけ）
| 環境 | 推奨シェル設定ファイル | 設定コマンド |
|---|---|---|
| Apple Silicon (M1/M2…) macOS 13 以降 |
~/.zprofile（Zsh がデフォルト） |
bash echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && eval "$(/opt/homebrew/bin/brew shellenv)" |
| Intel Mac /usr/local 配下 |
~/.zprofile または ~/.bash_profile（使用シェルに合わせて） |
bash echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile && eval "$(/usr/local/bin/brew shellenv)" |
確認
bash
brew --version # バージョンが表示されれば成功
3. Node.js のインストール
(A) Homebrew が提供する最新版を利用（最も手軽）
|
1 2 |
brew install node # LTS 系の最新バージョンが入ります |
(B) 特定バージョン (例: v22) が必要なときは nvm で管理
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# Homebrew 経由で nvm をインストール brew install nvm # シェル設定に追記（~/.zprofile の例） echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zprofile echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zprofile source ~/.zprofile # Node v22 をインストール & デフォルトに設定 nvm install 22 nvm alias default 22 |
動作確認
bash
node -v # v22.x.x（またはインストールしたバージョン）が表示されれば OK
OpenClaw を Homebrew でインストールする方法
1. パッケージの所在を確認
2026 年 2 月時点では openclaw が 公式タップ (homebrew/core) に含まれている可能性があります。まず検索してみましょう。
|
1 2 |
brew search openclaw |
- 結果に
openclawが表示されたら、追加の tap は不要です。 - 表示されない場合は、開発元が提供する カスタムタップ が必要になることがあります。その際は公式ドキュメントで最新情報を確認してください。
2. インストールコマンド（公式タップがあるケース）
|
1 2 |
brew install openclaw |
インストール完了の目安
==> Installing openclaw
...
🍺 /opt/homebrew/Cellar/openclaw/<バージョン>
3. カスタムタップが必要な場合（例）
|
1 2 3 4 |
# 公式情報で tap が提供されているときだけ実行 brew tap openclaw/openclaw # 存在しない場合はエラーになるので無視して OK brew install openclaw |
注意：タップ名やリポジトリは予告なく変更・削除されることがあります。常に
brew searchで確認する習慣をつけましょう。
4. パスが自動登録されないときの対処
Homebrew のインストール先は CPU アーキテクチャによって異なります。
| 環境 | 実行ファイル例 |
|---|---|
| Apple Silicon | /opt/homebrew/opt/openclaw/bin |
| Intel | /usr/local/opt/openclaw/bin |
|
1 2 3 4 |
# 例: Apple Silicon の場合 echo 'export PATH="/opt/homebrew/opt/openclaw/bin:$PATH"' >> ~/.zprofile source ~/.zprofile |
5. バージョン確認
|
1 2 |
openclaw -V # → OpenClaw vX.Y.Z が表示されれば完了 |
npm／Git からソースコードでインストールする手順
Homebrew が利用できない、または最新版を自前でビルドしたい場合に便利です。
1. リポジトリ取得
|
1 2 3 |
git clone https://github.com/openclaw/openclaw.git cd openclaw |
Git のインストール（未導入の場合）
bash
brew install git # または Xcode に同梱の git を使用
2. Node バージョンの確認
|
1 2 |
node -v # v20 以上が推奨。v22 が必要なら上記 nvm 手順で取得 |
3. 依存パッケージをインストール
package-lock.json にロックされた正確なバージョンをそのままインストールします。
|
1 2 |
npm ci # npm が自動で node_modules を作成 |
npm の最新版が必要
bash
brew install npm # Homebrew 経由で更新可能
4. ビルド & 起動
| 操作 | コマンド例 |
|---|---|
| ローカル開発環境で起動 | npm run build && npm start |
| グローバルにインストールしてどこからでも実行 | npm i -g .（リポジトリ内）openclaw start |
Tip: グローバルインストール時に権限エラーが出たら、Homebrew の Node が入っているパス (
/opt/homebrew/bin) に書き込み権限があるか確認してください。
5. バージョン・アップデート
|
1 2 3 |
# ソースコードを最新に pull → 再度 npm ci git pull origin main && npm ci |
.env 設定とサーバ起動
OpenClaw は環境変数で API キーやポート番号などを取得します。.env が無いと起動直後にエラーになるので必ず作成してください。
1. 必須変数例
プロジェクトルート（Homebrew インストールでも同様）に .env を作成し、以下を記入します。自分の情報に置き換えてください。
|
1 2 3 4 5 6 7 8 9 |
# OpenAI の API キー（必須） OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxx # 任意：外部ゲートウェイ URL GATEWAY_URL=https://my-gateway.example.com # ポート番号（デフォルト 3000） PORT=3000 |
ベストプラクティス
-.gitignoreに必ず/.envを追加し、リポジトリにコミットしない。
- キー漏洩防止のため、ターミナルでcat .env | pbcopyとすれば安全にコピーできます。
2. 起動コマンド
| インストール方法 | 起動コマンド |
|---|---|
| Homebrew 版 | openclaw start |
| npm グローバル | npx openclaw または openclaw start |
|
1 2 3 |
# 実行例（Homebrew 版） openclaw start |
起動に成功すると次のようなメッセージが出ます。
|
1 2 |
🚀 OpenClaw server listening on http://localhost:3000 |
ブラウザで http://localhost:3000 にアクセスし、ログイン画面やダッシュボードが表示されれば完了です。
トラブルシューティングと自動起動 (launchd)
1. よくあるエラーと対処法
| エラーメッセージ | 原因 | 解決策 |
|---|---|---|
EACCES: permission denied |
Homebrew ディレクトリの所有者が root になっている | bash sudo chown -R $(whoami) /opt/homebrew # Apple Siliconbash sudo chown -R $(whoami) /usr/local # Intel |
node: command not found |
PATH に Node が入っていない | .zprofile（または .bash_profile）に以下を追記し、再読み込みexport PATH="/opt/homebrew/opt/node@22/bin:$PATH"（Homebrew版）もしくは nvm use 22 |
OPENAI_API_KEY is undefined |
.env が読めていない |
dotenv-cli をインストールし、起動時に明示的に読み込むnpm i -g dotenv-cli && dotenv -e .env -- openclaw start |
brew: command not found |
Homebrew のパスが設定されていない | 前述の「パス設定」セクションを再実行し、ターミナルを再起動 |
2. launchd による自動起動（macOS 起動時に OpenClaw を立ち上げる）
(A) plist ファイル作成
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
<!-- ~/Library/LaunchAgents/com.openclaw.server.plist --> <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key><string>com.openclaw.server</string> <!-- Homebrew 版か npm 版かでパスを書き換えてください --> <key>ProgramArguments</key> <array> <string>/opt/homebrew/opt/openclaw/bin/openclaw</string> <!-- Apple Silicon の例 --> <!-- Intel Mac 用は /usr/local/opt/openclaw/bin/openclaw に変更 --> <string>start</string> </array> <key>RunAtLoad</key><true/> <key>WorkingDirectory</key><string>/Users/${USER}</string> <key>StandardOutPath</key><string>/tmp/openclaw.out.log</string> <key>StandardErrorPath</key><string>/tmp/openclaw.err.log</string> </dict> </plist> |
- npm 版の場合は
ProgramArgumentsの最初の文字列を、グローバルにインストールした実行ファイルのフルパス（例:/opt/homebrew/bin/openclaw）に置き換えてください。
(B) plist をロード
|
1 2 |
launchctl load ~/Library/LaunchAgents/com.openclaw.server.plist |
(C) 起動確認
|
1 2 3 |
launchctl list | grep com.openclaw.server # 0 が表示されれば「Running」状態です。 |
(D) アンロード（削除したいとき）
|
1 2 3 |
launchctl unload ~/Library/LaunchAgents/com.openclaw.server.plist rm ~/Library/LaunchAgents/com.openclaw.server.plist |
まとめ
- 開発環境の土台
xcode-select --install→ Xcode Command Line Tools- Homebrew のインストールと CPU アーキテクチャ別パス設定
-
Node.js は Homebrew の最新版か、必要なら nvm で任意バージョンを取得
-
OpenClaw 本体の導入
- Homebrew 推奨：
brew install openclaw（公式タップが無い場合はbrew tap …を確認） -
npm／Git：
git clone → npm ci → npm startまたはnpm i -g . -
必須設定
- プロジェクト直下に
.envを作成し、OPENAI_API_KEYなどを記入 -
起動は
openclaw start（Homebrew）またはnpx openclaw（npm） -
トラブル対策
- 権限エラー → ディレクトリ所有者の修正
- PATH が通っていない → シェル設定に追記
-
環境変数が読めない →
dotenv-cliの活用 -
自動起動（任意）
~/Library/LaunchAgents/com.openclaw.server.plistを作成し、launchctl loadで登録。CPU アーキテクチャに合わせて実行ファイルパスだけを書き換えるだけで OK。
以上の手順を踏めば、Intel Mac でも Apple Silicon でも最新 macOS 環境で OpenClaw を問題なくインストール・起動できるはずです。質問や不明点があれば、公式リポジトリの Issue ページか本稿コメント欄へお気軽にどうぞ！