Contents
スポンサードリンク
前提条件と環境準備
| 必要項目 | インストール方法 | 確認コマンド |
|---|---|---|
| Xcode Command Line Tools | xcode-select --install を実行し、表示されるダイアログで「インストール」 |
xcode-select -p → /Library/Developer/CommandLineTools が出れば OK |
| Homebrew（macOS のパッケージマネージャ） | bash<br>/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"<br> |
brew --version → Homebrew 4.x.x が表示 |
| Node.js（LTS 推奨） | 推奨: nvm 経由で管理 brew install nvm && mkdir ~/.nvm && echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc && echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc 再読込後に nvm install 20 && nvm use 20 |
node -v → v20.x.x、npm -v → 10.x.x |
| PATH の設定（Apple Silicon / Intel） | .zshrc に以下を追記し、ターミナルを再起動または source ~/.zshrc bash<br># Apple Silicon (Homebrew が /opt/homebrew) 例<br>export PATH="/opt/homebrew/bin:$PATH"<br># Intel Mac の場合は /usr/local を使用<br># export PATH="/usr/local/bin:$PATH"<br> |
echo $PATH に Homebrew の bin ディレクトリが含まれることを確認 |
ポイント
- Xcode Tools が無いと C/C++ コンパイラが利用できず、後続のビルドでエラーになります。
- Node.js は 20 LTS 系 を使用することで、OpenClaw の依存パッケージが期待通りに動作します（公式ドキュメントでも同バージョンを推奨）。
OpenClaw 本体の取得方法
1. Homebrew 版（最も簡単）
|
1 2 |
brew install openclaw |
インストールが完了したら以下でバージョンと実行パスを確認します。
|
1 2 3 4 5 6 |
$ openclaw --version openclaw version 0.9.3 (2026-04-10) $ which openclaw /opt/homebrew/bin/openclaw |
0.9.3 は執筆時点の最新安定版です。Homebrew が自動的に最新版を取得するため、手動でバージョン管理を行う必要はありません。
2. ソースからクローンして npm によるインストール
|
1 2 3 4 5 |
git clone https://github.com/openclaw/openclaw.git cd openclaw npm ci # package-lock.json の通りに正確に依存関係を解決 npm link # グローバルコマンドとして登録（任意） |
インストール後の確認例：
|
1 2 3 4 5 6 |
$ openclaw --version openclaw version 0.9.3 (2026-04-10) $ npm list -g --depth=0 | grep openclaw └── openclaw@0.9.3 |
留意点
- npm ci は CI 向けに最適化されたインストールコマンドで、ローカル環境のパッケージ差異を防ぎます。
- ソース版は自分でビルドフラグやプラグインを追加したい場合に便利です。
公式情報：OpenClaw の最新リリースは GitHub Releases（https://github.com/openclaw/openclaw/releases）および Homebrew tap に反映されています。
Gateway デーモンの初期設定と自動起動
1. 対話式セットアップ
|
1 2 |
openclaw setup |
実行すると次のようなプロンプトが表示されます。
| プロンプト | 説明 |
|---|---|
| API キー | OpenClaw の管理画面から取得したキーを貼り付けます。 |
| データ保存先 | デフォルトは ~/Library/Application Support/OpenClaw 。別ディレクトリに変更可能です。 |
| 使用モデル | gpt-4o-mini（推奨）やローカルのパスを入力できます。 |
設定完了後、以下で内容を確認できます。
|
1 2 3 4 5 6 7 8 |
openclaw config view # 例: # { # "apiKey": "***", # "dataDir": "/Users/you/Library/Application Support/OpenClaw", # "model": "gpt-4o-mini" # } |
2. launchd にデーモン登録（自動起動）
|
1 2 |
openclaw gateway install --install-daemon |
実行結果の抜粋：
|
1 2 3 4 |
✅ LaunchAgent plist を作成しました: /Users/you/Library/LaunchAgents/com.openclaw.gateway.plist 🔄 launchctl にロード中... ✅ Gateway デーモンが起動しました (PID 12345) |
起動状態の確認
|
1 2 3 4 |
launchctl list | grep com.openclaw.gateway # 出力例: - 0 com.openclaw.gateway |
ログの場所
- 標準ログ:
~/Library/Logs/OpenClaw/gateway.log - エラー時は上記ファイルを
tail -fでリアルタイム監視してください。
主要チャネルの接続と動作確認
OAuth を利用したサービス認証
|
1 2 |
openclaw channels login |
- ターミナルに表示された URL（例:
https://auth.openclaw.ai/...）をブラウザで開く。 - Slack、Discord などの認可画面が出るので「許可」ボタンをクリック。
- 成功すると以下のメッセージとともにトークンがローカル保存されます。
|
1 2 3 |
✅ Authentication successful 🔐 Token saved to /Users/you/.openclaw/tokens.json |
接続済みチャネル一覧
|
1 2 3 4 5 |
openclaw channels list # 出力例: # • Slack (workspace: my-team) # • Discord (server: dev-bot) |
基本コマンドでの動作テスト
1. 簡易質問
|
1 2 |
openclaw ask "Hello, OpenClaw!" |
期待される出力（JSON フォーマット）：
|
1 2 3 4 |
{ "answer": "Hello! How can I help you today?" } |
2. システム状態確認
|
1 2 3 4 5 6 |
openclaw status # 出力例: # gateway: running (pid 12345) # channels: 2 connected # model: gpt-4o-mini |
上記コマンドが期待通りに応答すれば、インストール・設定は完了です。
よくあるエラーと対処法
| 症状 | 原因例 | 解決手順 |
|---|---|---|
openclaw: command not found |
Homebrew の bin が PATH に未登録（特に Apple Silicon） | .zshrc に export PATH="/opt/homebrew/bin:$PATH" を追記し、source ~/.zshrc |
EACCES: permission denied (npm) |
/usr/local/lib/node_modules などが root 所有 |
bash<br>sudo chown -R $(whoami) $(brew --prefix)/lib/node_modules<br> |
unsupported engine（Node バージョン不一致） |
Node が LTS 以外、または nvm と brew の混在 | nvm use 20 または brew upgrade node |
| Gateway が起動しない | launchd plist が古い / 権限不足 | launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist && launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist |
| Slack/Discord 認証が失敗 | ブラウザのキャッシュやポップアップブロック | シークレットモードで URL を再度開く、または openclaw tokens clear 後に再実行 |
Node バージョンを統一する手順（nvm 推奨）
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
# nvm が未インストールの場合 brew install nvm mkdir ~/.nvm # シェル設定 (zsh の例) echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc source ~/.zshrc # LTS 20 系をインストール・デフォルト化 nvm install 20 nvm alias default 20 node -v # => v20.x.x |
最新版情報の取得方法
| 方法 | 手順 |
|---|---|
| Homebrew | brew update && brew upgrade openclaw |
| 公式サイト（ダウンロードページ） | https://openclaw.ai/download – リリースノートとインストーラが掲載 |
| GitHub Releases | https://github.com/openclaw/openclaw/releases – タグごとの変更点・バイナリが確認可能 |
| メールニュースレター | 公式サイト右下の「Subscribe」から購読すると、メジャーアップデートをメールで通知 |
定期的に上記いずれかで情報を取得すれば、セキュリティパッチや新機能追加によるトラブルを未然に防げます。
まとめ
- Xcode CLI + Homebrew + Node 20 LTS を揃えるだけで、macOS 上のビルド環境は完了。
- Homebrew 版 が手軽で推奨されるが、ソースからクローンすればカスタマイズも自由にできる。
openclaw setupとgateway install --install-daemonによって、Gateway デーモンを macOS 起動時に自動起動させられる。- チャネル認証 は一度だけ実行すればトークンが安全に保存され、以降は
openclaw ask等で即座に利用可能。 - PATH・権限・Node バージョン のミスマッチが最も多いエラー要因なので、上記表を参照しながら環境を整備すればトラブルは大幅に減ります。
これで macOS に OpenClaw と Gateway デーモンをインストールし、自動起動まで設定する手順は完了です。快適な AI アシスタント体験をお楽しみください！
スポンサードリンク