OpenClaw on macOS VMs（サンドボックス化）

推奨デフォルト（ほとんどのユーザー）

  • 小さなLinux VPS 常時稼働のGatewayと低コストのため。VPS hostingを参照。
  • 専用ハードウェア（Mac miniまたはLinuxボックス）完全な制御と住宅IPをブラウザ自動化のために必要な場合。多くのサイトはデータセンターIPをブロックするため、ローカルブラウジングの方が効果的なことが多いです。
  • ハイブリッド: 安価なVPSにGatewayを保持し、ブラウザ/UI自動化が必要なときにMacをノードとして接続します。NodesとGateway remoteを参照。

macOS固有の機能（iMessage/BlueBubbles）が必要な場合、または日常のMacから厳密に隔離したい場合にmacOS VMを使用します。

macOS VMオプション

Apple Silicon MacでのローカルVM（Lume）

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

これにより以下が可能になります:

  • 隔離された完全なmacOS環境（ホストはクリーンに保たれる）
  • BlueBubbles経由のiMessageサポート（Linux/Windowsでは不可能）
  • VMをクローンすることで即座にリセット
  • 追加のハードウェアやクラウドコストなし

ホストされたMacプロバイダー（クラウド）

クラウド上のmacOSが必要な場合、ホストされたMacプロバイダーも機能します:

  • MacStadium（ホストされたMac）
  • その他のホストされたMacベンダーも動作します。VMとSSHドキュメントに従ってください

macOS VMへのSSHアクセスがあれば、以下のステップ6から続けます。

クイックパス（Lume、経験豊富なユーザー）

  1. Lumeをインストール
  2. lume create openclaw --os macos --ipsw latest
  3. Setup Assistantを完了し、Remote Login（SSH）を有効化
  4. lume run openclaw --no-display
  5. SSH接続し、OpenClawをインストールし、チャネルを設定
  6. 完了

必要なもの（Lume）

  • Apple Silicon Mac（M1/M2/M3/M4）
  • ホスト上のmacOS Sequoia以降
  • VM1台あたり約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 Installation

2) macOS VMを作成

lume create openclaw --os macos --ipsw latest

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

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

3) Setup Assistantを完了

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を再起動します。これでAgentがiMessageを送受信できます。

完全なセットアップの詳細: BlueBubbles channel

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

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

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を電源に接続したまま
  • システム設定 → Energy Saverでスリープを無効化
  • 必要に応じてcaffeinateを使用

真の常時稼働には、専用のMac miniまたは小さなVPSを検討してください。VPS hostingを参照。

トラブルシューティング

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

関連ドキュメント

← ドキュメントに戻る