虛擬機安裝 OpenClaw

1. 虛擬機軟體

Windows 用戶：VirtualBox（免費）

https://www.virtualbox.org/wiki/Downloads

Mac 用戶：UTM（免費，支援 M1/M2/M3 晶片）

https://mac.getutm.app/

2. Ubuntu Linux 映像檔

下載 Ubuntu Desktop 24.04 LTS（約 5GB）

https://ubuntu.com/download/desktop

1下載 VirtualBox

前往官網下載頁面：

https://www.virtualbox.org/wiki/Downloads

點選「Windows hosts」下載安裝檔

2執行安裝程式

雙擊下載的 VirtualBox-7.x.x-Win.exe，一路點「Next」

3網路警告

安裝過程會跳出「網路介面會暫時中斷」的警告，點「Yes」繼續

4完成安裝

點「Install」開始安裝，完成後點「Finish」

1開啟 VirtualBox

從開始選單找到「Oracle VM VirtualBox」並開啟

2點選「新增」

在工具列點選「新增」或按 Ctrl + N

3填寫基本資訊

• 名稱：OpenClaw-Ubuntu
• 資料夾：保持預設即可
• ISO 映像：點「瀏覽」選擇剛下載的 Ubuntu ISO 檔

4設定硬體資源（點「下一步」後）

• Base Memory（記憶體）：4096 MB（建議）或更多
• Processors（處理器）：2 核心（建議 4 核心）

5勾選 EFI

勾選「Enable EFI (special OSes only)」

（Ubuntu 24.04 建議啟用 EFI）

6設定虛擬硬碟（點「下一步」後）

• 選擇「Create a Virtual Hard Disk Now」
• Disk Size（磁碟大小）：50 GB（建議）

（預設是動態配置，不會立刻佔用 50GB）

7確認並建立

檢查「摘要」頁面的設定，確認無誤後點「Finish」

顯示設定

「顯示」→「螢幕」頁籤：

• Video Memory：拉到 128 MB
• 勾選「Enable 3D Acceleration」

一般設定

「一般」→「進階」頁籤：

• 剪貼簿共享：雙向
• 拖放：雙向

1下載 UTM

前往官網：

https://mac.getutm.app/

點「Download」下載 UTM.dmg

2安裝 UTM

打開 UTM.dmg，將 UTM 拖到「應用程式」資料夾

3首次開啟

從「應用程式」開啟 UTM，如果出現安全性警告，到「系統設定」→「隱私權與安全性」點「仍要開啟」

1建立新的虛擬機

點選「Create a New Virtual Machine」

2選擇虛擬化類型

• M 系列晶片：選「Virtualize」（效能最好）
• Intel 晶片：選「Virtualize」或「Emulate」

3選擇作業系統

選「Linux」

4選擇 ISO 檔

在「Boot ISO Image」點「Browse...」

選擇下載好的 Ubuntu ISO 檔案

5設定硬體資源

• Memory：4096 MB（或 8192 MB）
• CPU Cores：4（或更多）

6設定儲存空間

• Storage Size：50 GB（建議）

7共享資料夾（可選）

可以設定與 Mac 共享的資料夾路徑

8命名並儲存

輸入名稱如「OpenClaw-Ubuntu」，點「Save」

1啟動虛擬機

• VirtualBox：雙擊虛擬機名稱，或點「啟動」
• UTM：點選虛擬機後按「▶️」按鈕

2開機畫面

等待 Ubuntu 載入，會看到「Try or Install Ubuntu」選單

直接按 Enter 或等待自動進入

3選擇語言

在左側列表找到「繁體中文」並點選

然後點「安裝 Ubuntu」

4鍵盤配置

選擇「Chinese (traditional)」或「English (US)」

點「繼續」

5安裝類型

選擇「互動式安裝」（Interactive installation）

點「繼續」

6應用程式選擇

選擇「預設選擇」（Default selection）即可

點「繼續」

7安裝選項

勾選「安裝建議的專有軟體」（Install recommended proprietary software）

點「繼續」

8磁碟設定

選擇「清除磁碟並安裝 Ubuntu」

（這只會清除虛擬磁碟，不會影響你的主電腦！）

點「繼續」→「安裝」

9建立帳號

• 你的名字：隨便填（例如：OpenClaw User）
• 電腦名稱：openclaw-vm
• 使用者名稱：user（或你喜歡的名稱）
• 密碼：設定一個你記得住的密碼

10時區

選擇「Taipei」（台北）

1移除 ISO

重新開機時如果還是進入安裝畫面：

• VirtualBox：「裝置」→「光碟機」→「移除虛擬光碟」
• UTM：在設定中移除 ISO

2登入系統

輸入剛才設定的密碼登入

3完成初始設定

跳過 Ubuntu Pro 等提示，一路點「下一步」

4VirtualBox 用戶：安裝增強功能

開啟終端機，執行：

sudo apt update && sudo apt install -y virtualbox-guest-additions-iso

（這可以讓畫面更流暢、支援複製貼上）

1更新系統

sudo apt update && sudo apt upgrade -y

2一鍵安裝 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

3執行初始化設定

openclaw onboard --install-daemon

1安裝 ngrok

curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
  && echo "deb https://ngrok-agent.s3.amazonaws.com buster main" \
  | sudo tee /etc/apt/sources.list.d/ngrok.list \
  && sudo apt update \
  && sudo apt install ngrok

2到 ngrok.com 註冊並取得 authtoken

3設定 authtoken

ngrok config add-authtoken 你的token

4啟動 ngrok

ngrok http 18789

1啟動虛擬機，登入 Ubuntu

2開啟終端機，啟動 OpenClaw

openclaw gateway start

3開新終端機，啟動 ngrok

ngrok http 18789

4複製 ngrok 網址，更新 LINE Webhook URL