OpenClaw on macOS VM(サンドボックス)

推奨のデフォルト(ほとんどのユーザー向け)

  • 小規模 Linux VPS — 常時稼働の Gateway を低コストで運用。VPS ホスティングを参照。
  • 専用ハードウェア(Mac mini や Linux マシン)— 完全な制御と住宅用 IP でのブラウザ自動化が必要な場合。多くのサイトはデータセンター IP をブロックするため、ローカルブラウジングの方が成功率が高いです。
  • ハイブリッド:安価な VPS に Gateway を配置し、ブラウザ/UI 自動化が必要な場合に Mac をノードとして接続。ノードGateway リモートを参照。

macOS VM は、macOS 固有の機能(iMessage/BlueBubbles)が必要な場合や、普段使いの Mac からの厳密な分離が必要な場合に使用してください。

macOS VM のオプション

ローカル VM(Apple Silicon Mac 上、Lume を使用)

Lume を使って、既存の Apple Silicon Mac 上でサンドボックス化された macOS VM 内で OpenClaw を実行できます。

これにより以下が得られます:

  • 分離されたフル macOS 環境(ホストはクリーンなまま)
  • BlueBubbles 経由の iMessage サポート(Linux/Windows では不可能)
  • VM クローンによる即時リセット
  • 追加のハードウェアやクラウドコストが不要

ホスト型 Mac プロバイダー(クラウド)

クラウド上の macOS が必要な場合、ホスト型 Mac プロバイダーも利用できます:

  • MacStadium(ホスト型 Mac)
  • その他のホスト型 Mac ベンダーも対応可能。各プロバイダーの VM + SSH ドキュメントに従ってください

SSH アクセスを取得したら、以下のステップ 6 から続けてください。


クイックパス(Lume、経験者向け)

  1. Lume をインストール
  2. lume create openclaw --os macos --ipsw latest
  3. セットアップアシスタントを完了し、リモートログイン(SSH)を有効化
  4. lume run openclaw --no-display
  5. SSH で接続し、OpenClaw をインストール、チャンネルを設定
  6. 完了

必要なもの(Lume)

  • Apple Silicon Mac(M1/M2/M3/M4)
  • ホストが macOS Sequoia 以降
  • VM あたり約 60 GB の空きディスク容量
  • 約 20 分

1) Lume のインストール

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

~/.local/bin が PATH にない場合:

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

確認:

lume --version

ドキュメント:Lume インストール


2) macOS VM の作成

lume create openclaw --os macos --ipsw latest

macOS がダウンロードされ、VM が作成されます。VNC ウィンドウが自動的に開きます。

ダウンロードには接続速度によって時間がかかる場合があります。


3) セットアップアシスタントの完了

VNC ウィンドウで:

  1. 言語とリージョンを選択
  2. Apple ID をスキップ(後で iMessage を使いたい場合はサインイン)
  3. ユーザーアカウントを作成(ユーザー名とパスワードを覚えておいてください)
  4. オプション機能はすべてスキップ

セットアップ完了後、SSH を有効化:

  1. システム設定 → 一般 → 共有を開く
  2. 「リモートログイン」を有効にする

4) VM の IP アドレスを取得

lume get openclaw

IP アドレスを確認します(通常は 192.168.64.x)。


5) VM に SSH 接続

ssh [email protected]

youruser を作成したアカウント名に、IP を VM の IP に置き換えてください。


6) OpenClaw のインストール

VM 内で:

npm install -g openclaw@latest
openclaw onboard --install-daemon

オンボーディングのプロンプトに従って、モデルプロバイダー(Anthropic、OpenAI など)をセットアップしてください。


7) チャンネルの設定

設定ファイルを編集:

nano ~/.openclaw/openclaw.json

チャンネルを追加:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    },
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

WhatsApp にログイン(QR スキャン):

openclaw channels login

8) VM をヘッドレスで実行

VM を停止し、ディスプレイなしで再起動:

lume stop openclaw
lume run openclaw --no-display

VM はバックグラウンドで実行されます。OpenClaw のデーモンが Gateway を稼働し続けます。

ステータスを確認:

ssh [email protected] "openclaw status"

おまけ:iMessage 連携

macOS 上で実行する最大のメリットです。BlueBubbles を使って OpenClaw に iMessage を追加できます。

VM 内で:

  1. bluebubbles.app から BlueBubbles をダウンロード
  2. Apple ID でサインイン
  3. Web API を有効にしてパスワードを設定
  4. BlueBubbles の Webhook を Gateway に向ける(例:https://your-gateway-host:3000/bluebubbles-webhook?password=<password>

OpenClaw の設定に追加:

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

Gateway を再起動すれば、エージェントが iMessage の送受信を行えるようになります。

完全なセットアップの詳細:BlueBubbles チャンネル


ゴールデンイメージの保存

さらなるカスタマイズの前に、クリーンな状態をスナップショット:

lume stop openclaw
lume clone openclaw openclaw-golden

いつでもリセット可能:

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

24 時間 365 日稼働

VM を稼働し続けるには:

  • Mac を電源に接続しておく
  • システム設定 → 省エネルギーでスリープを無効化
  • 必要に応じて caffeinate を使用

真の常時稼働には、専用の Mac mini か小規模 VPS を検討してください。VPS ホスティングを参照。


トラブルシューティング

問題解決策
VM に SSH 接続できないVM のシステム設定で「リモートログイン」が有効になっているか確認
VM の IP が表示されないVM が完全に起動するまで待ち、lume get openclaw を再実行
Lume コマンドが見つからない~/.local/bin を PATH に追加
WhatsApp QR がスキャンできないホストではなく VM にログインした状態で openclaw channels login を実行しているか確認

関連ドキュメント