「OpenClawを試してみたいけど、VPSを契約するのはちょっと、、」「自分のMacの環境を汚したくない」——そんな方に向けて、Apple Silicon Mac上にLumeで仮想マシン(VM)を作り、その中でOpenClawを安全に動かす手順をまとめました。
Lumeは軽量で高速なmacOS仮想化ツールで、Apple Siliconに最適化されています。VM内にOpenClawを閉じ込めることで、ホストMacの環境を一切汚さずに検証でき、不要になったらVMごと削除するだけで済みます。
この記事ではChatGPT Plusプラン(月額20ドル)の範囲内で追加のAPI課金なしにOpenClawを動かす最短ルートに絞って解説します。OllamaやOpenRouterなど他のモデル接続方法、Ubuntu VMでの検証、トラブル時の復旧手順についてはnoteで扱います。
Lume・OpenClaw・ChatGPTの基本
Lumeとは
Lumeは、Apple Silicon Mac上で仮想マシンを作成・管理できるオープンソースの仮想化ツールです。macOSのVirtualization Frameworkを利用しており、UTMやVirtualBuddyと比べてCLIベースで軽量な点が特徴です。macOS VMだけでなくLinux VMも作成でき、いずれもApple Siliconのネイティブ性能をほぼそのまま活かせます。
OpenClawとは
OpenClawは、LLM(大規模言語モデル)を使ってDiscordやSlack、iMessageなどのチャットチャネルから操作できるオープンソースのAIエージェントです。GitHub史上最速クラスでスターを集めたプロジェクトで、自分のサーバーやPC上で自分だけのAIアシスタントを常時稼働させられるのが魅力です。ただし、ファイル操作やコマンド実行など強力な権限を持つため、メインPCで直接動かすのはセキュリティ上推奨されません。
ChatGPT連携の仕組み
OpenClawのモデルプロバイダーとしてOpenAIを選ぶと、API Key方式とCodex Device Pairing方式が選べます。API Key方式は使った分だけ従量課金されますが、Codex Device Pairing方式ならChatGPT Plusプランの契約範囲内で追加課金なしに使えます。この記事ではDevice Pairing方式を使い、追加のAPI費用ゼロで試します。
VMで動かすメリットと注意点
VMで動かす3つの理由
- ホストMacを汚さない:OpenClawのインストールに必要なNode.jsやHomebrew、各種設定ファイルはすべてVM内に閉じ込められます。ホスト側の環境は一切変わりません
- 検証環境を丸ごと捨てられる:設定を壊しても、VMを削除して作り直すだけでやり直せます。VPSのように再構築の手間がかかりません
- VPS導入前の検証に最適:まずVM上でOpenClawの動作や使い勝手を確認し、本格運用したくなったらVPSへ移行する、という段階的な進め方ができます
前提条件
- Apple Silicon Mac(M1 / M2 / M3 / M4シリーズ)
- macOS Sequoia以降(Virtualization Framework対応)
- ストレージ空き容量 80GB以上(macOS VMイメージが約65GB、OpenClaw関連で数GB使用)
- ChatGPT Plusプラン契約済み(月額20ドル)
- ターミナル操作の基本知識
Intel Macでは動作しません。Lumeの仮想化はApple SiliconのVirtualization Frameworkに依存しています。
Lumeのインストール
ホストMac側のターミナルで以下のコマンドを実行します。Lumeの公式インストールスクリプトがダウンロードと配置を行います。
# Lumeをインストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
# PATHを通す
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc
source ~/.zshrc
# 確認
lume --version
インストール先は ~/.local/bin です。PATHを通さないと lume: command not found になるため、2行目を忘れないでください。
macOS VMの作成
Lumeで最新のmacOS VMを作成します。コマンド1つでIPSW(macOSリストアイメージ)のダウンロードからVMの作成まで自動で行われます。
lume create my-vm --os macos --ipsw latest
IPSWのダウンロードに10〜30分ほどかかります。ネットワーク環境によってはそれ以上かかることもあるので、気長に待ってください。
作成が完了するとmacOS VMのウィンドウが自動で開き、セットアップアシスタントが始まります。通常のMacと同じように、言語選択・ユーザーアカウント作成・ネットワーク設定を進めてください。Apple IDのサインインは不要です。
VMのデータは ~/.lume/my-vm/ に保存されます。不要になったら lume delete my-vm で丸ごと削除できます。
Ubuntu VMという選択肢
LumeではLinux VMも作成できますが、この記事ではmacOS VMに絞ります。Ubuntu VMでの検証やLumeの lume pull コマンドで発生するエラーの対処法については、noteで詳しく解説します。
VM内でのHomebrew導入
macOS VMの初回起動が完了したら、VM内のターミナルを開きます。OpenClawのインストールスクリプトはHomebrewを前提としていますが、新規のmacOS VMにはHomebrewが入っていません。
Homebrewなしの状態でOpenClawのインストールスクリプトを実行すると、以下のようなエラーで止まります。
· Homebrew not found, installing
✗ Installing Homebrew failed — re-run with --verbose for details
Warning: Running in non-interactive mode because `stdin` is not a TTY.
==> Checking for `sudo` access (which may request your password)...
Need sudo access on macOS (e.g. the user lume needs to be an Administrator)!
OpenClawのインストーラーが内部でHomebrewを自動インストールしようとしますが、非インタラクティブモードで実行されるため権限の問題で失敗します。先にHomebrewを手動で導入しておきましょう。
# VM内のターミナルで実行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# パスワードを求められたらVM作成時に設定したパスワードを入力
# PATHを通す
eval "$(/opt/homebrew/bin/brew shellenv)"
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
OpenClawのインストールとセットアップ
インストールスクリプトの実行
Homebrewが入った状態で、OpenClawの公式インストールスクリプトを実行します。
curl -fsSL https://openclaw.ai/install.sh | bash
Node.jsが未導入の場合はインストーラーが自動でセットアップします。完了するとセットアップウィザード(openclaw onboard --install-daemon)が始まります。
ChatGPT Device Pairingの設定
ウィザードでモデルプロバイダーの選択を求められたら、以下のように進めます。
| 設定項目 | 選択内容 | 補足 |
|---|---|---|
| Model/auth provider | OpenAI | |
| OpenAI auth method | OpenAI Codex Device Pairing | API Key方式は選びません(従量課金になるため) |
「OpenAI Codex Device Pairing」を選ぶと、デバイス認証コードが表示されます。
◇ OpenAI Codex device code ─────────────────────────────────╮
│ │
│ Open this URL in your browser and enter the code below. │
│ URL: https://auth.openai.com/codex/device │
│ Code: XXXX-XXXXX │
│ Code expires in 15 minutes. Never share it. │
│ │
├────────────────────────────────────────────────────────────╯
ホストMacのブラウザ(VM外)で https://auth.openai.com/codex/device を開き、表示されたコードを入力して認証します。15分以内に完了してください。
ChatGPT側で必要な事前設定
Device Pairingを使うには、ChatGPT側でCodexのデバイスコード認証を有効にしておく必要があります。
- ChatGPTにログイン
- 左下のアカウントメニュー → 「設定」を開く
- 「セキュリティ」タブを選択
- 「Codexに対してデバイスコード認証を有効にする」のトグルをオンにする
このトグルがオフのままだと認証が通りません。Device Pairingを選んだのに認証画面でエラーになる場合は、まずこの設定を確認してください。
モデル選択の注意点
Codex Device Pairing認証で使えるモデルは、openai-codex/gpt-5.5 のように openai-codex/ で始まるモデルです。openai/gpt-5.5 のようにCodexプレフィックスなしのモデルを選ぶと、以下のエラーが出ます。
⚠️ Agent failed before reply: No API key found for provider "openai".
You are authenticated with OpenAI Codex OAuth.
Use openai/gpt-5.5 with the Codex OAuth profile, or set OPENAI_API_KEY
for direct OpenAI API access.
Codexなしのモデル(openai/gpt-5.5 など)を使うにはOpenAI API Keyが必要で、従量課金になります。ChatGPT Plusの範囲内で使いたい場合は、必ず openai-codex/ 付きのモデルを選んでください。
動作確認
Gatewayの起動確認
セットアップが完了したら、VM内のターミナルでGatewayの状態を確認します。
openclaw gateway status
「running」と表示されればOpenClawは正常に動作しています。停止している場合は openclaw gateway restart で再起動してください。
TUIでメッセージを送信
ターミナルUIを起動して、実際にメッセージを送ってみましょう。
openclaw tui
TUIが起動したらメッセージを入力して送信します。ChatGPT経由で応答が返ってくれば、OpenClawのセットアップは完了です。
ダッシュボードの確認
ブラウザで操作できるダッシュボード(Control UI)もあります。URLとアクセストークンは以下のコマンドで確認できます。
openclaw dashboard
VM内のブラウザで表示されたURLを開けば、メッセージ履歴の確認やエージェント設定の変更ができます。
この記事で扱わない内容
以下の内容は手順が長くなるため、この記事では省略します。詳しく知りたい方はnoteをご覧ください。
- Ubuntu VMでの検証:Ubuntu Server ARM ISOの入手、ISOマウント、初期設定、macOS VMとの違い
- Ollamaの導入:インストール、
ollama signin、モデル選定、メモリ不足時の切り分け - OpenRouterの設定:APIキー作成、無料モデルの選び方、レート制限の詳細
- Lume pullエラーの対処:
lume pull ubuntu-noble-vanilla:latestの失敗と残骸削除 - 設定のリセットと復旧:
openclaw onboard --install-daemonでのConfig only / Full resetの使い分け
VPS常時稼働との違い
当サイトではXServer VPS無料枠でOpenClawを構築する手順も公開しています。Mac VM版とVPS版は目的が異なります。自分の用途に合ったほうを選んでください。
| 比較項目 | Mac VM | VPS |
|---|---|---|
| 主な用途 | 検証・お試し | 常時稼働・24時間運用 |
| ホスト環境への影響 | なし(VM内に隔離) | なし(外部サーバー) |
| 初期費用 | 0円(Mac所有前提) | 0円(無料VPS) |
| API費用 | ChatGPT Plus月額20ドルの範囲内 | OpenRouter無料モデルで0円 |
| 必要なスペック | Apple Silicon Mac / ストレージ80GB以上 | メモリ2GB以上のVPS |
| 常時稼働 | Macの電源を落とすと停止 | VPSは24時間稼働 |
| 捨てやすさ | VM削除で完了 | VPSを削除 |
| 向いている人 | まず試してみたい人 | 常時稼働で運用したい人 |
まずはMac VMで動作確認してみて、継続的に使いたくなったらVPSへの移行を検討するのがおすすめです。
よくある質問
- Intel MacでもLumeは使えますか?
いいえ。LumeはApple SiliconのVirtualization Frameworkに依存しているため、Intel Macでは動作しません。Intel Macの場合はVPSでの構築をおすすめします。
- VM作成にどのくらいストレージが必要ですか?
macOS VMのイメージで約65GB、OpenClawと関連ツールで数GB使います。余裕を持って80GB以上の空き容量を確保してください。
- ChatGPT Plus以外のプランでも使えますか?
Codex Device Pairingの利用にはChatGPT PlusまたはProプランが必要です。無料プランでは認証できません。ChatGPT以外のモデルを使いたい場合は、OpenRouterやOllamaも選択肢に入りますが、この記事では扱いません。
- VMのパフォーマンスは問題ないですか?
Lumeが使うVirtualization FrameworkはApple Siliconに最適化されており、体感としてはネイティブに近い速度で動作します。OpenClawのGateway稼働やTUI操作で遅延を感じることはほぼありません。
- Ollamaでローカルモデルは使えますか?
かなり厳しいです。VM内ではメモリが制限されるため、大きなモデルだとメモリ不足で失敗することがあります。さらにVMの中ではCPUでの推論となるため私の環境Macbook Air M1ではフリーズしたような状態になり、返事も返って来ませんでした。
まとめ
Apple Silicon MacとLumeを使えば、ホスト環境を汚さずにOpenClawを試せます。手順をまとめると以下の通りです。
- ホストMacにLumeをインストールしてPATHを通す
lume create my-vm --os macos --ipsw latestでmacOS VMを作成- VM内でHomebrewを導入
- OpenClawのインストールスクリプトを実行
- ChatGPT Device Pairingで認証(ChatGPT側のCodex設定を事前にオン)
- Gateway起動を確認し、TUIで動作確認
ChatGPT Plusプラン契約済みなら、追加のAPI課金なしでOpenClawの基本的な動作を確認できます。VPS契約前の検証環境としても、ホストMacを汚さない安全な実験場としても活用できる構成です。
OpenRouterの無料モデル設定、Ubuntu VMでの検証、lume pull エラーの対処、設定リセットなど、より深い内容はnoteの Lume Mac VMでOpenClawを安全に使う完全マニュアル【macOS VM / Ubuntu VM / Ollama Web Search / OpenRouter / ChatGPT認証対応】 で詳しく解説しています。


Comment