你的電腦真的安全嗎？學會 VirtualBuddy 隔離術，完美運行 OpenClaw 不留痕跡。
最好的開發環境，是「當它不存在」。透過虛擬化隔離技術，我們能在個人電腦中開闢一片淨土，確保 OpenClaw 的所有操作都被限制在安全界線內。這不只是安裝教學，更是一場關於數位邊界的守護行動。
安裝與初始化虛擬環境 (VirtualBuddy)
首先使用 VirtualBuddy 裝虛擬環境，隔離原個人電腦
1. 下載安裝程式
首先，造訪 VirtualBuddy GitHub
頁面。在 Assets 區塊中，點擊下載最新版本的 .dmg 安裝檔。
2. 執行應用程式安裝
下載完成後，雙擊開啟 .dmg 檔案。在彈出的視窗中，將 VirtualBuddy 圖示拖曳至 Applications (應用程式) 資料夾。完成後，即可在應用程式清單中找到並開啟它。
3. 建立虛擬機
開啟 VirtualBuddy 程式後，你會看到歡迎介面。請點擊畫面中央的 「Create Virtual Machine」 按鈕，開始進入虛擬機的產生與設定流程。
4. 選擇作業系統類型
進入虛擬機設定畫面後，系統會詢問你要安裝的作業系統類型。
- 操作動作： 請點擊左側的 「macOS」 圖示。
- 下一步： 確認選取後（圖示會出現外框高亮），點擊右下角的 「Continue」 按鈕繼續。
5. 選擇 macOS 系統版本
接下來進入 Choose Version 頁面，VirtualBuddy 會列出所有可供下載的 macOS 版本。
- 選取版本： 請在清單中找到 「macOS 26.2」（或目前的最新正式版本）。
- 辨識建議： 建議避開標註為 “Developer Beta” 的版本以確保穩定性，直接選擇純數字編號的正式版。
- 確認操作： 選中版本後，點擊右下角的 「Continue」 按鈕。
6. 命名你的虛擬機
選擇完版本後，系統會進入 Name Your Virtual Machine 頁面。
- 自訂名稱： 你可以在欄位中輸入易於辨識的名稱（例如：
Work_Environment或Test_Lab）。 - 隨機驚喜： 欄位預設會出現一個幽默的隨機名稱（如圖片中的
Impressive Cattle），如果你懶得想名字，直接點擊右側的 「重新整理圖示」 也可以更換另一個隨機名稱。 - 完成命名： 確認名稱後，點擊右下角的 「Continue」。
7. 配置虛擬機硬體資源
最後，進入 Configure Your Virtual Machine 頁面。請根據你實體電腦的效能與剩餘硬碟空間進行調整。
💾 磁碟空間 (Boot Disk)
- 設定重點： 拖曳滑桿來決定虛擬機的硬碟大小（預設通常為 64 GB）。
- ⚠️ 重要提醒： 虛擬機建立後，後續無法再調整磁碟大小。請務必在此步驟預留足夠的空間供日後安裝軟體使用。
- 空間佔用： 這裡設定的空間不會立即被吃掉，而是隨著你虛擬機使用的檔案增加才逐漸佔用實體硬碟空間。
⚙️ 效能與一般設定 (General & Others)
- 處理器與記憶體 (General)： 預設通常為 4 CPUs / 8 GB RAM。若你的實體電腦效能較強，可點擊進去調高配額以獲得更流暢的體驗。
- 其餘項目： 包含顯示解析度 (Display)、網路 (Network) 等，建議初次安裝時先保持預設值即可。
確認所有設定無誤後，點擊右下角的 「Continue」。
8. 下載系統安裝映像檔
點擊 Continue 後，VirtualBuddy 會開始從 Apple 伺服器下載你所選取的 macOS 安裝程式。
- 自動化流程： 系統會自動進入 Downloading 狀態，你只需要保持網路連線穩定。
- 預估時間： 下方進度條會顯示剩餘時間。由於 macOS 安裝檔通常超過 18GB，下載時間會依你的網路速度而定（例如：圖中顯示約需 18 分鐘）。
- 注意事項： 在進度條跑完之前，請勿關閉程式或進入睡眠模式，以免下載中斷需要重新開始。
9. 虛擬機作業系統安裝中
下載完成後，VirtualBuddy 會開始將 macOS 系統安裝至你剛設定的虛擬磁碟中。
- 自動安裝： 畫面會顯示 「Preparing Installation」（正在準備安裝）。
- 耐心等候： 此階段系統正在進行檔案解壓縮與環境配置，進度條會持續跳動。請勿在此時強制關閉程式。
10. 安裝完成與返回主介面
當安裝進度結束，畫面出現綠色勾勾圖示，並顯示 「Your macOS Virtual Machine is Ready!」 時，代表虛擬機已成功建立。
- 確認狀態： 此時系統已完成所有配置，準備好啟動。
- 返回主頁： 請點擊右上角的 「Done」 按鈕，這會帶你回到 VirtualBuddy 的主管理介面。
- 下一步： 返回主介面後，你剛建立的虛擬機（例如：
Impressive Cattle）就會出現在清單中，點擊播放鍵即可正式進入 macOS。
11. 啟動前的最後確認與執行
按下 Done 返回後，你會進入該虛擬機的管理頁面。在正式點擊中間的大播放鍵（Start）之前，你還有機會進行最後的細節微調。
- 進階設定 (Virtual Machine Settings)： 若你發現剛才的硬體配額需要更改，可以點擊下方的按鈕進入設定介面。
- 鍵盤快捷鍵切換 (Capture system keyboard shortcuts)： 建議保持開啟（如圖中橘色狀態），這能讓你更順暢地在虛擬機中使用 Mac 的組合鍵。
- 正式啟動： 一切就緒後，點擊畫面正中央的 「Play (三角形圖示)」。
- 下一步： 啟動後，虛擬機將載入 macOS 安裝程序。接下來的畫面會與你第一次開新 Mac 電腦時一樣，需要進行語系、時區、Apple ID 及使用者帳號的初始化設定。
安裝 OpenClaw 系統
準備開發環境：安裝 Homebrew
在全新安裝的 macOS 虛擬機中，我們需要先安裝 Homebrew，它是後續安裝 Moltbot 所需組件的基礎工具。
操作步驟
1. 開啟終端機 (Terminal)：
在 macOS 中按下 Command + 空白鍵 搜尋「Terminal」，或至「應用程式」>「工具程式」資料夾中開啟。
2. 執行安裝指令： 複製下方指令，貼入終端機後按下 Enter 鍵執行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安裝 OpenClaw (Moltbot、Clawdbot)
完成 Homebrew 環境配置後，接著透過終端機執行官方安裝腳本。此指令會自動完成 Moltbot 及其相依組件的下載與部署。
操作步驟
1. 執行安裝指令： 請在終端機中複製並貼上以下指令，然後按下 Enter：
curl -fsSL https://openclaw.ai/install.sh | bash2. 等待程序完成： 安裝腳本會自動檢查環境並下載必要檔案，過程可能需要幾分鐘，請確保網路連線穩定。
完成安裝與安全性確認 (Onboarding)
當指令執行完畢後，終端機會顯示 「Moltbot installed successfully」 的綠色字樣，緊接著會自動進入 Clawdbot Onboarding 導覽程序。
1. 確認 PATH 路徑（選修動作）
注意提示： 畫面上可能會出現 PATH warning 的橘色警告。如果出現此提示，請按照畫面提供的 export PATH=… 指令進行複製執行，這能確保你在未來任何時候都能直接輸入 clawdbot 指令啟動程式。
2. 安全性聲明讀取
安全性提醒：
系統會顯示 Security 區塊，告知 Clawdbot 具備讀取與寫入檔案的權限，並建議新手從 Sandbox (沙盒模式) 開始使用以降低風險。
3. 正式同意並啟動
- 互動確認： 畫面最下方會詢問：
I understand this is powerful and inherently risky. Continue? - 操作動作： 請使用鍵盤上下鍵移動游標至 「Yes」，然後按下
Enter鍵，即可正式完成設定並開始使用。
OpenClaw (Moltbot、Clawdbot) 環境初始化設定
安裝完成後，系統會自動啟動引導設定模式 (Onboarding Mode)，協助你完成最後的執行環境配置。
OpenClaw (Moltbot、Clawdbot) 環境初始化設定
安裝完成後，系統會自動啟動引導程序 (Onboarding Mode)。這裡我們將透過一系列互動式問答來完成基礎配置。
選擇引導模式
畫面會提供兩個選項：
- QuickStart (推薦)： 快速引導模式。系統會引導你完成最核心的設定，其餘細項則套用建議預設值。
- Manual： 全手動模式。
操作建議： 請使用鍵盤上下鍵將游標移至 「QuickStart」 並按下 Enter。這將開啟後續的步驟式設定流程，請依照畫面提示逐一完成。
配置 AI 模型提供商 (Model/auth provider)
在 QuickStart 模式下，系統會自動預設基礎網路參數（如 Gateway Port 18789），接著會要求你選擇主要的 AI 模型來源。
- 選擇 Google 平台： 在服務商清單中，請使用鍵盤上下鍵移至 「Google (Gemini API key + OAuth)」 並按下
Enter鍵。 - 為什麼選擇此項： 選用 Google 作為模型提供商，可以讓系統直接串接 Gemini 系列模型，享受強大的多模態理解與運算能力。
- 後續動作預告： 選定 Google 後，系統通常會要求你輸入 API Key 或進行 OAuth 身份驗證，請準備好你的 Google AI Studio API Key。
選擇 Google 認證方式與輸入 Key
選定 Google 作為提供商後，系統會要求選擇具體的認證方式 (Google auth method)。
- 選擇認證類型： 請使用鍵盤移至 「Google Gemini API key」 並按下
Enter。這是最直接且建議的連接方式。 - 輸入 API Key： 隨後，終端機會出現輸入提示。請將你從 Google AI Studio 取得的 API Key 貼上。
- ⚠️ 資安小提醒： 在終端機貼上 Key 時。貼上後直接按下
Enter即可完成驗證。
設定預設 AI 模型 (Default model)
成功驗證 API Key 後，系統會列出 Google 提供商支援的所有模型版本。這決定了你的 Moltbot (Clawdbot) 未來思考與回應的「大腦實力」。
- 選擇模型： 在清單中找到
google/gemini-2.5-flash並按下Enter。 - 為什麼選這個模型： Gemini 2.5 Flash 是目前在速度、上下文長度 (Context window) 與運算成本之間取得極佳平衡的選擇，非常適合處理自動化任務。
- 模型確認： 選定後，系統會顯示
Default model set to google/gemini-2.5-flash。
設定通訊頻道 (Select channel)
設定好 AI 模型後，最後一步是選擇一個通訊平台，讓你可以透過該平台與 Moltbot (Clawdbot) 進行遠端對話並下達指令。
- 平台選擇建議： 雖然清單中包含 Line、WhatsApp 等多種選項，但由於目前環境中部分元件可能存在連結失效（404 錯誤）的情形，建議選用 Telegram (Bot API) 作為通訊媒介。
- 操作動作： 使用鍵盤移動至 「Telegram (Bot API)」 並按下
Enter。 - 遠端互動： 設定完成後，你就能像跟朋友聊天一樣，透過 Telegram 傳送訊息給你的 Moltbot，實現遠端操控與自動化任務。
取得並輸入 Telegram Bot Token
取得 Token 的步驟
如果你尚未擁有機器人憑證，請按照終端機畫面上的指引操作：
- 開啟 Telegram：搜尋並私訊官方機器人
@BotFather。 - 建立機器人：輸入指令
/newbot並依照提示為你的機器人命名。 - 複製憑證：完成後，
@BotFather會發送一串包含數字與字母的代碼（例如123456:ABC...），這就是你的 HTTP API Token。
執行設定
- 輸入憑證：回到終端機，在
Enter Telegram bot token提示字元後貼上剛剛複製的代碼。 - 隱私提醒：與輸入 API Key 時相同，為了安全起見，貼上時畫面可能不會顯示字元，請直接按下
Enter即可
配置機器人技能 (Configure skills)
輸入完 Telegram Token 後，系統會自動更新設定檔 (~/.clawdbot/clawdbot.json) 並檢查當前環境。此時，畫面會顯示 Skills status，讓你知道目前機器人具備的能力狀態。
- 技能檢查結果：
- Eligible (符合資格)： 系統偵測到環境中已具備且可立即使用的技能數量（如圖中顯示 6 項）。
- Missing requirements (缺少需求)： 代表還有一些強大功能因為缺少特定的軟體或 API 而暫時無法使用。
- 關鍵決策： 系統會詢問
Configure skills now? (recommended)。- 建議操作： 選擇 「Yes」 並按下
Enter。這會進入細部的技能開關清單，讓你決定要賦予這個機器人哪些「權力」。 - 為什麼要現在設定： 在此步驟進行配置，可以確保你的機器人一上線就具備處理檔案或執行終端機指令的能力，發揮最大效用。
- 建議操作： 選擇 「Yes」 並按下
設定技能安裝的首選節點管理器 (Preferred node manager)
為了讓 Moltbot 能夠安裝並執行各種技能，你需要指定一個 Node.js 套件管理器。系統會根據你虛擬機中已安裝的工具列出選項。
- 選擇管理器： 清單中通常包含
npm、pnpm與bun。- 建議選擇： 如果你不確定該選哪一個，請選擇 「npm」。它是 macOS 最標準且內建支援度最高的選項。
- 操作動作： 使用鍵盤上下鍵移至你的首選項目（如圖中選擇
npm）並按下Enter。
- 為什麼這很重要： 不同的管理器在下載技能的速度與空間佔用上有所差異，選擇你熟悉的工具可以讓後續的技能維護更加輕鬆。
安裝與配置相依技能 (Install missing skill dependencies)
在設定完套件管理器後，系統會列出所有可用的技能清單。這些技能包含了對 Apple 生態系的串接、開發工具、以及各種自動化腳本。
挑選技能： 使用鍵盤 上下鍵 移動游標，按下 空白鍵 (Space) 即可勾選或取消勾選。
開始安裝： 選定所需技能後，按下 Enter 鍵，系統即會開始下載並配置這些擴展功能。
技能組件安裝與 API Key 密鑰配置
按下 Enter 後，系統會開始自動安裝你剛才勾選的技能相依套件。
安裝狀態回報
- 自動部署：你會看到系統逐一顯示
Installed summarize,Installed gemini,Installed apple-notes等狀態，代表這些功能已成功掛載。 - 錯誤排查提示：若出現
Install failed（如 model-usage 缺少 brew formula），系統會建議你稍後運行clawdbot doctor來檢查並修復環境。
技能密鑰設定 (API Key Setup)
部分進階技能（如 Google Places, OpenAI, ElevenLabs 等）需要專屬的 API Key 才能運作。系統會逐一詢問是否現在設定：
- 操作建議：若你目前手邊沒有這些額外的 Key，或是想先測試基礎功能，請統一選擇 「No」 即可。
- 稍後配置：略過這些設定並不影響主程式運行，你可以在未來隨時透過設定指令重新補上這些金鑰。
啟用自動化 Hooks (Hooks Configuration)
在 API Key 配置結束後，系統會詢問是否啟用 Hooks。Hooks 是一組自動化腳本，能在你下達指令時同步執行背景動作（例如自動存檔、記錄日誌等）。
- 操作動作：請使用鍵盤 上下鍵 移動游標，按下 空白鍵 (Space) 將所有項目勾選，最後按下
Enter鍵確認。 - Hooks 選項解析：
boot-md：在 Gateway 啟動時自動執行特定的初始化 MD 檔案。command-logger：將所有指令動作記錄到中央稽核檔案，方便日後追蹤機器人的行為。session-memory：當你輸入/new開啟新對話時，自動將當前工作階段的上下文儲存至記憶體中。
孵化你的機器人 (Hatch your bot!)
所有的環境設定、模型連接、頻道綁定與技能安裝都已完成。現在，系統會詢問：「How do you want to hatch your bot?」（你想如何孵化你的機器人？）。
你可以從以下兩種主要方式中選擇其一來開啟你的 Moltbot 體驗：
- Hatch in TUI (推薦)：
- 說明：TUI 代表「文字用戶介面 (Text User Interface)」。這會直接在當前的終端機視窗內啟動一個美觀的互動介面。
- 優點：速度最快、開發感十足，且最能展現 Clawdbot 的原生特色。
- Open the Web UI：
- 說明：系統會自動在瀏覽器中開啟
http://127.0.0.1:18789/。 - 優點：具備圖形化介面，適合喜歡在瀏覽器多分頁切換操作的使用者。畫面也會提供一個帶有 token 的專屬連結，確保連線安全。
- 說明：系統會自動在瀏覽器中開啟
操作建議： 初次使用建議選擇 「Hatch in TUI (recommended)」，感受最直接的機器人啟動過程。
啟動與正式對話 (The First Interaction)
當你完成「孵化」步驟後，系統會自動建立連線。此時，無論是透過終端機的 TUI 模式，還是瀏覽器的 Web UI 介面，兩者的狀態是即時同步的。
喚醒機器人
- 自動發送指令：系統會以你的名義（使用者）自動發送第一條訊息：「Wake up, my friend!」。
- 啟動意義：這不只是一句問候，它會觸發機器人的初始化邏輯，讓它開始讀取你先前配置的模型（Gemini 2.5 Flash）與技能組。
- 同步體驗：如果你在 Web UI 觀察，你會看到一個潔淨的對話視窗，右側顯示著這句喚醒詞，等待著機器人的第一次回應。
介面概覽 (以 Web UI 為例)
在瀏覽器介面中，你可以透過左側側邊欄進行更深入的控管：
- Chat：即時對話視窗。
- Control：包含 Overview (概覽)、Channels (通訊頻道) 與 Sessions (對話紀錄)。
- Agent：管理你安裝的 Skills (技能) 與 Nodes (節點)。
- Settings：調整 Config (配置) 或查看 Debug/Logs 紀錄。
初始對話與人格建立 (Localization & Identity)
Moltbot 啟動後的首要任務是確認自己的身份與功能。預設情況下，它會使用英文進行溝通，但你可以隨時透過對話來調整它的語言與性格。
變更語言
- 即時切換：如果你希望使用中文進行後續交流，只需直接發送訊息（例如：「後續聊天用中文為應，OK 嗎？」）。
- 系統適應：機器人會立即切換語系，並開始與你討論它在系統中的角色、應該具備的名稱，以及它與你互動時的語氣風格（正式、隨性或帶點諷刺）。
自定義你的 AI 夥伴
透過這段初始對話，你可以設定：
- 名稱：為你的機器人取一個好記的名字。
- 風格：決定它是溫暖的助手，還是精簡專業的開發專家。
- 表情符號：挑選一個代表它的表情符號，讓對話更具溫度。
結語：見證 OpenClaw 的誕生
在完成整套系統的安裝與深度試用後，我們見證了一個重要的轉折：原先稱為 Moltbot (Clawdbot) 的專案已正式更名為 OpenClaw。
隨著更名為 OpenClaw，系統的安裝路徑與指令也同步進行了調整。雖然手冊中的截圖仍保留了開發階段的視覺記錄，但請使用者在操作時注意以下變更：
- 安裝指令：安裝腳本路徑已更新，請以最新的官方 GitHub 或官網文件為準。
- 設定檔路徑：原本的
~/.clawdbot/目錄，在最新版本中通常會遷移至與 OpenClaw 相關的命名路徑。 - 啟動指令：如果你在終端機發現
clawdbot指令失效，請嘗試使用最新的openclaw指令。
系統評價
透過這次在虛擬機環境下的部署實測，OpenClaw 展示了極其優異的擴展性。從 Gemini 2.5 Flash 的流暢對話，到 Telegram 的遠端操控，這套系統為個人自動化助理立下了新的標杆。
OpenClaw 不僅是一個工具，它更像是一個會成長的數位生物。隨著你餵養更多的 API Key 與技能，它將成為你 Mac 環境中最得力的隱形助手。
官方網址：