跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.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。請參閱 Nodes 和 Gateway 遠端。
只有在你明確需要 iMessage 等 macOS 專屬功能，或想要與日常使用的 Mac 嚴格隔離時，才使用 macOS VM。

​
macOS VM 選項

​
在你的 Apple Silicon Mac 上執行本機 VM（Lume）

使用 Lume，在你現有的 Apple Silicon Mac 上的沙盒化 macOS VM 中執行 OpenClaw。 這會提供：
  • 隔離的完整 macOS 環境（你的主機保持乾淨）
  • 透過 imsg 支援 iMessage（預設本機路徑無法在 Linux/Windows 上使用）
  • 透過複製 VM 立即重設
  • 無需額外硬體或雲端成本

​
託管 Mac 供應商（雲端）

如果你想在雲端使用 macOS，託管 Mac 供應商也可行：
  • MacStadium（託管 Mac）
  • 其他託管 Mac 供應商也可使用；請依照他們的 VM + SSH 文件操作
一旦你能 SSH 存取 macOS VM，請從下方步驟 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 上執行的最強大功能。使用 iMessage 搭配 imsg，將訊息加入 OpenClaw。 在 VM 內：
  1. 登入訊息。
  2. 安裝 imsg。
  3. 為執行 OpenClaw/imsg 的程序授予完整磁碟取用權和自動化權限。
  4. 使用 imsg rpc --help 驗證 RPC 支援。
新增至你的 OpenClaw 設定： 
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
重新啟動 gateway。現在你的 agent 可以傳送和接收 iMessages。 完整設定細節：iMessage 頻道

​
儲存黃金映像

在進一步自訂前，為你的乾淨狀態建立快照： 
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（不是主機）

​
相關文件