ホーム チュートリアル カテゴリ Skills サイトについて
ZH EN JA KO
インストール

macOSでOpenClawをインストールする完全ガイド

· 14 分で読了

はじめに

macOS は OpenClaw を実行するのに最適なプラットフォームの一つです。安定した Unix 環境と優れたターミナル体験を備えています。本記事では、Homebrew と npm の2つのインストール方法を紹介し、macOS の launchd を活用した自動起動設定について詳しく解説します。

動作環境

項目 最低要件 推奨構成
macOS バージョン macOS 13 Ventura macOS 14 Sonoma+
チップ Intel x86_64 / Apple Silicon Apple Silicon (M1+)
Node.js 22.0+ 22 LTS 最新版
メモリ 2 GB 空き 4 GB+ 空き
Xcode CLI Tools 必須 最新版

ステップ1：前提条件のインストール

Xcodeコマンドラインツールのインストール

OpenClaw の一部の依存関係はインストール時にネイティブモジュールのコンパイルが必要なため、Xcodeコマンドラインツールが必要です。

xcode-select --install

表示されるダイアログで「インストール」をクリックし、ダウンロードとインストールの完了を待ちます。

インストールの確認：

xcode-select -p
# 出力: /Library/Developer/CommandLineTools

Homebrewのインストール

Homebrew がまだインストールされていない場合は、以下のコマンドを実行します。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Apple Silicon ユーザーはインストール完了後、Homebrew を PATH に追加する必要があります。

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

ステップ2：Node.jsのインストール

方法1：Homebrewでインストール（推奨）

brew install node@22

# node@22をPATHにリンク
brew link --overwrite node@22

# バージョンを確認
node --version
npm --version

方法2：nvmでインストール

# nvmをインストール
brew install nvm

# nvm環境を設定
mkdir -p ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
source ~/.zshrc

# Node.js 22をインストール
nvm install 22
nvm use 22
nvm alias default 22

ステップ3：OpenClawのインストール

Homebrew または npm の2つの方法から選択できます。

方法1：Homebrewでインストール（推奨）

brew install openclaw

Homebrew を使用する利点は、依存関係が自動的に処理され、アップデートも簡単なことです。

方法2：npmでグローバルインストール

npm install -g openclaw@latest

インストールの確認

openclaw --version

ステップ4：初期設定

初期設定ウィザードを実行します。

openclaw onboard

以下の設定をガイドに従って完了します。

  1. AIモデルプロバイダの選択（Claude / OpenAI / Ollama / Gemini / OpenRouter）
  2. 対応するAPIキーの入力
  3. 連携するメッセージングチャネルの選択
  4. ゲートウェイポートの確認（デフォルト18789）

設定ファイルの保存場所：

~/.config/openclaw/openclaw.json5

VS Code やその他のエディタで開いて手動で調整できます。

code ~/.config/openclaw/openclaw.json5

ステップ5：OpenClawの起動

openclaw up

正常に起動すると、以下のように表示されます。

[OpenClaw] Gateway started on port 18789
[OpenClaw] Model provider: Claude (claude-sonnet-4-20250514)
[OpenClaw] Channels: ready
[OpenClaw] Dashboard: http://localhost:18789/dashboard

よく使う管理コマンド

# 動作状態と環境の診断
openclaw doctor

# 管理パネルを開く
openclaw dashboard

# リアルタイムログを確認
openclaw logs

# サービスを再起動
openclaw restart

# インストール済みスキルの一覧
openclaw skill list

ステップ6：launchdによる自動起動設定

macOS では launchd を使用してバックグラウンドサービスを管理します（Linux の systemd に相当します）。以下の手順で OpenClaw を launchd のユーザーレベルサービスとして登録します。

plistファイルの作成

mkdir -p ~/Library/LaunchAgents

~/Library/LaunchAgents/com.openclaw.agent.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.agent</string>

    <key>ProgramArguments</key>
    <array>
        <string>/opt/homebrew/bin/openclaw</string>
        <string>up</string>
    </array>

    <key>RunAtLoad</key>
    <true/>

    <key>KeepAlive</key>
    <true/>

    <key>WorkingDirectory</key>
    <string>/Users/YOUR_USERNAME</string>

    <key>StandardOutPath</key>
    <string>/Users/YOUR_USERNAME/.openclaw/logs/stdout.log</string>

    <key>StandardErrorPath</key>
    <string>/Users/YOUR_USERNAME/.openclaw/logs/stderr.log</string>

    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
    </dict>
</dict>
</plist>

YOUR_USERNAME をご自身のユーザー名に置き換えてください。npm でインストールした場合は、/opt/homebrew/bin/openclaw を which openclaw の出力パスに置き換える必要があります。

ログディレクトリの作成とサービスの読み込み

# ログディレクトリを作成
mkdir -p ~/.openclaw/logs

# サービスを読み込み
launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

# サービスが起動したことを確認
launchctl list | grep openclaw

launchdサービスの管理

# サービスを停止
launchctl unload ~/Library/LaunchAgents/com.openclaw.agent.plist

# サービスを起動
launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

# サービス状態を確認（macOS 13+）
launchctl print gui/$(id -u)/com.openclaw.agent

macOS向け最適化テクニック

バックグラウンドネットワーク接続の許可

OpenClaw を初めて起動すると、macOS がファイアウォールの確認ダイアログを表示する場合があります。「許可」をクリックしてください。

ダイアログを見逃した場合は、手動で追加できます。

  1. 「システム設定」>「ネットワーク」>「ファイアウォール」を開く
  2. 「オプション」をクリック
  3. Node.js または OpenClaw を見つけ、「受信接続を許可」に設定

macOSのスリープによるサービス中断の防止

Mac で OpenClaw を長時間実行する場合は、システムのスリープを無効にすることをお勧めします。

# システムスリープを防止（ターミナルで実行）
caffeinate -s &

# またはシステム設定で調整
# システム設定 > ロック画面 > ディスプレイオフ後にロックしない

Apple Siliconのパフォーマンス最適化

Apple Silicon Mac でローカルモデル（Ollama など）を実行する場合は、Metal アクセラレーションを活用できます。

# Ollamaをインストール
brew install ollama

# Ollamaを起動（Metal GPUアクセラレーションが自動的に使用されます）
ollama serve

# openclaw.json5でOllamaをモデルプロバイダとして設定

iTerm2での監視

iTerm2 の分割ペイン機能を使用して、OpenClaw のログとシステムリソースを同時に監視することをお勧めします。

# 左ペイン：OpenClawログを確認
openclaw logs

# 右ペイン：システムリソースを監視
top -pid $(pgrep -f openclaw)

Homebrewでのアップデート

Homebrew でインストールした場合、アップデートは非常に簡単です。

# Homebrewインデックスを更新
brew update

# OpenClawをアップグレード
brew upgrade openclaw

# サービスを再起動
openclaw restart

アンインストール

OpenClaw をアンインストールする必要がある場合：

# Homebrewでインストールした場合
brew uninstall openclaw

# npmでインストールした場合
npm uninstall -g openclaw

# 設定ファイルの削除（任意）
rm -rf ~/.config/openclaw
rm -rf ~/.openclaw

# launchdサービスの削除
launchctl unload ~/Library/LaunchAgents/com.openclaw.agent.plist
rm ~/Library/LaunchAgents/com.openclaw.agent.plist

まとめ

macOS は安定した Unix 基盤と優れたハードウェア性能を備えており、OpenClaw を実行するのに最適な選択肢です。Homebrew でインストールすると最もスムーズな体験が得られ、launchd による自動起動と組み合わせることで、AIアシスタントを常時オンラインに保つことができます。続いて、チャネル連携やスキルプラグインに関するチュートリアルを読み、OpenClaw の可能性をさらに引き出してください。

OpenClawは無料のオープンソースAIアシスタント。WhatsApp、Telegram、Discordなど多数のプラットフォームに対応
他のチュートリアル Skillsダウンロード

関連チュートリアル

OpenClawのインストール方法
OpenClaw Dockerデプロイ完全ガイド
OpenClaw VPSサーバーデプロイ完全ガイド