跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
建議預設選項（大多數使用者）

  • 小型 Linux VPS，用於常開 Gateway 並降低成本。請參閱 VPS 託管。
  • 如果你想要完整控制權，並為瀏覽器自動化使用住宅 IP，請使用專用硬體（Mac mini 或 Linux 主機）。許多網站會封鎖資料中心 IP，因此本機瀏覽通常效果更好。
  • 混合式： 將 Gateway 放在便宜的 VPS 上，並在需要瀏覽器/UI 自動化時連接你的 Mac 作為 Node。請參閱 Node 與 Gateway 遠端。
當你明確需要僅限 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. 完成設定輔助程式，啟用遠端登入（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) SSH 進入 VM

ssh youruser@192.168.64.X
將 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 的 daemon 會讓 Gateway 持續運作。 檢查狀態： 
ssh youruser@192.168.64.X "openclaw status"

​
額外：iMessage 整合

這是在 macOS 上執行的關鍵功能。使用 BlueBubbles 將 iMessage 加入 OpenClaw。 在 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/7 執行

透過以下方式讓 VM 持續執行：
  • 讓你的 Mac 持續接上電源
  • 在「系統設定」→「能源節約器」中停用睡眠
  • 視需要使用 caffeinate
若要真正常開，請考慮使用專用 Mac mini 或小型 VPS。請參閱 VPS 託管。

​
疑難排解

問題解決方案
無法 SSH 進入 VM檢查 VM 的「系統設定」中是否已啟用「遠端登入」
未顯示 VM IP等待 VM 完全開機，然後再次執行 lume get openclaw
找不到 Lume 指令將 ~/.local/bin 加入你的 PATH
WhatsApp QR 無法掃描執行 openclaw channels login 時，確認你已登入 VM（不是主機）

​
相關文件