PR
AI

Lume Mac VMでOpenClawを安全に試す手順【ChatGPT Plus対応・ホスト環境汚さず】

AI

「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 providerOpenAI
OpenAI auth methodOpenAI Codex Device PairingAPI 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のデバイスコード認証を有効にしておく必要があります。

  1. ChatGPTにログイン
  2. 左下のアカウントメニュー → 「設定」を開く
  3. 「セキュリティ」タブを選択
  4. 「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 VMVPS
主な用途検証・お試し常時稼働・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を試せます。手順をまとめると以下の通りです。

  1. ホストMacにLumeをインストールしてPATHを通す
  2. lume create my-vm --os macos --ipsw latest でmacOS VMを作成
  3. VM内でHomebrewを導入
  4. OpenClawのインストールスクリプトを実行
  5. ChatGPT Device Pairingで認証(ChatGPT側のCodex設定を事前にオン)
  6. 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認証対応】 で詳しく解説しています。

この記事を書いた人
Naokazu Yokoo

エンジニア歴20年以上。現在はWeb / AI領域で活動中。
開発環境・サーバー環境ともに速度と効率性を追求しています。

Follow Naokazu Yokoo
Follow Naokazu Yokoo

Comment

タイトルとURLをコピーしました