OpenClaw 安裝指南：給完全不懂技術的你
這篇指南帶你從零開始安裝 OpenClaw AI 代理。不需要任何技術背景。每一步都告訴你做什麼、為什麼要做、以及做錯了怎麼辦。
📖 本指南分六章：
A. 認識你的電腦 — 規格檢查與硬體選擇
📌 目的
OpenClaw 需要一台 Linux 環境來運作。在開始安裝之前，你要先搞清楚兩件事：
(1) 你手邊的電腦能不能用？
(2) 如果不行，最便宜的替代方案是什麼？
🔍 怎麼查你的電腦規格
Mac：左上角 → 「關於這台 Mac」
- 看晶片或處理器欄位：「Intel」→ Intel Mac；「Apple M1/M2/M3/M4」→ Apple Silicon
- 看記憶體：需要 8GB 以上
Windows：設定 → 系統 → 關於
- 看處理器：Intel 或 AMD
- 看已安裝的 RAM：需要 8GB 以上
📋 最低硬體需求
| 項目 | 最低 | 建議 |
|---|---|---|
| RAM | 8GB | 16GB |
| 硬碟空間 | 30GB | 50GB+ |
| 處理器 | 2015 年之後的 Intel/AMD | 4 核心以上 |
| 網路 | 需要（下載約 3GB） | 穩定寬頻 |
💡 沒有適合的電腦？替代硬體方案
| 方案 | 價格 | 適合誰 |
|---|---|---|
| 🏆 Mac Mini (M4, 16GB) | ~$599 USD | 最佳選擇。省電、安靜、效能強 |
| 二手 ThinkPad | ~$150-300 USD | 預算有限。選 T480/T490 以上 |
| 抽屜裡的舊筆電 | $0 | 只要能開機、8GB RAM 以上就行 |
| Raspberry Pi 5 (8GB) | ~$80 USD | 進階玩家。效能有限但可用 |
💬 重點：你不需要買新電腦。我自己用的是一台 8 年前的 ASUS 筆電（i7-8565U、8GB RAM），跑 7 個 AI 代理完全沒問題。OpenClaw 的運算在雲端（AI 模型伺服器），你的電腦只是「指揮中心」，不需要很強。
B. 安裝前準備 — 路線選擇與必要元件
📌 目的
OpenClaw 在 Linux 環境裡跑得最好。你有兩種方式讓你的電腦提供這個環境：
🛤️ 兩條路線比較
| 路線 1：直接安裝 | 路線 2：虛擬機（VM） | |
|---|---|---|
| 怎麼做 | 直接在你的 Mac 或 Windows（WSL2）上安裝 | 先裝虛擬機軟體 → 裝 Linux Mint → 在 Linux 裡裝 OpenClaw |
| 速度 | ⚡ 快（~30 分鐘） | 🐢 慢（~2 小時） |
| 安全性 | ⚠️ 跟你的系統混在一起 | 🔒 完全隔離，像一個 App |
| 移除方式 | npm uninstall -g openclaw | 刪掉 VM 就完全消失 |
| 適合系統 | Mac（任何晶片）、Windows WSL2 | 任何系統 |
| 建議 | ✅ 適合 Mac 用戶 | ✅ 適合 Windows 用戶、或想要完全隔離的人 |
📙 什麼是虛擬機（VM）？
想像你的電腦是一棟房子。虛擬機就是在房子裡建了一間獨立的小套房——有自己的門、自己的電、自己的水。小套房裡面發生什麼事都不會影響到大房子。不喜歡了？拆掉小套房（刪掉 VM），大房子跟原來一模一樣。
🛠️ VM 軟體選哪個？
| 你的電腦 | 用什麼 | 為什麼 |
|---|---|---|
| Windows | VirtualBox | 免費、穩定、最多人用 |
| Mac Intel（2020 前） | VirtualBox | Intel CPU 跟 Linux 同架構（x86-64），可硬體加速 |
| Mac M1/M2/M3/M4 | UTM | Apple Silicon 是 ARM 架構，VirtualBox 無法加速，UTM 專為 ARM 設計 |
📦 必要元件（安裝腳本會自動處理）
你不需要手動安裝這些——OpenClaw 的安裝腳本會自動偵測並安裝。但了解它們有助於排除問題：
| 元件 | 是什麼 | 為什麼需要 |
|---|---|---|
| Node.js 22+ | JavaScript 執行環境 | OpenClaw 用 JavaScript/TypeScript 寫的，需要 Node.js 來執行 |
| npm | 套件管理員 | 下載 OpenClaw 和它的 ~500 個依賴套件 |
| Git | 版本控制工具 | OpenClaw 用它來管理你的工作區和檔案變更 |
| curl | 網路下載工具 | 安裝腳本用來下載檔案 |
| C++ 編譯工具 （僅 Windows） |
Build Tools for VS | 某些 npm 套件需要編譯原生模組（如 sharp 圖片處理）。Mac/Linux 通常已有；Windows 需要額外安裝 |
⚠️ Windows 用戶注意：如果安裝過程中看到 node-gyp 或 sharp 錯誤，你需要安裝 Visual C++ Build Tools。下載後選「C++ build tools」workload 安裝即可。
📥 路線 2 準備：下載 VM 軟體 + Linux
如果你選路線 2（虛擬機），先下載這兩個：
- VM 軟體：VirtualBox（Windows/Mac Intel）或 UTM（Mac M 系列）
- Linux Mint XFCE：linuxmint.com/download.php → XFCE Edition → 64-bit（約 2.8GB）
📙 為什麼 Linux Mint，不用 Ubuntu Server？
Ubuntu Server 全黑畫面、只有文字、沒有滑鼠。非技術背景的人看到會很緊張。Linux Mint 有完整桌面環境——有瀏覽器、有檔案管理器、有 Wi-Fi 設定，長得像 Windows。XFCE 版最輕量，只吃 ~500MB RAM。
🔧 建立虛擬機
打開 VirtualBox → 點「新增」→ 填入以下設定：
- 名稱：
OpenClaw（隨你取） - 類型：Linux、版本：Ubuntu (64-bit)
- ISO 映像：選你剛下載的 Linux Mint
.iso檔（重要！忘了選會開機失敗） - RAM：4096 MB（4GB）
- CPU：2
- 硬碟：25 GB
啟動 VM → 桌面出現後，雙擊 Install Linux Mint → 跟著圖形介面完成安裝。「Erase disk」不會刪你的東西——它只影響 VM 裡面的虛擬硬碟。
C. OpenClaw 安裝與設定 — 每個選項的意義
📌 目的
現在你有了 Linux 環境（不管是直接在 Mac、WSL2、還是 VM 裡）。接下來用一行指令安裝 OpenClaw，然後完成初始設定。
C.1 安裝指令
打開 Terminal → 貼上這一行 → 按 Enter：
# Mac / Linux / WSL2：
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex
這個腳本會自動：(1) 檢查 Node.js → 沒有就安裝 (2) 下載 OpenClaw → 安裝到全域 (3) 啟動設定精靈。
⏱️ 在 VM 裡大約需要 10-15 分鐘。虛擬硬碟的 I/O 比實體慢 3-5 倍，這是正常的。游標在閃就是在跑，什麼都不要按。
C.2 設定精靈 — 每個選項的意義
安裝完成後會自動進入設定精靈。以下是每個步驟的意義：
| 步驟 | 選什麼 | 這在做什麼 |
|---|---|---|
| 安全性聲明 | 按 Y |
同意讓 OpenClaw 在你的電腦上執行指令。它只做你要求的事。 |
| AI 供應商 | 選 Anthropic | 你的 AI 用誰的大腦？Anthropic 的 Claude 是目前最強的 AI 代理模型。 其他選項：OpenAI (ChatGPT)、Google (Gemini)、本地模型（免費但弱很多）。 |
| 認證方式 | 看你的方案 | Claude Max 訂閱：用 setup-token 登入（瀏覽器會打開讓你登入） API Key：到 console.anthropic.com 取得 key，貼上 |
| 設定模式 | 選 QuickStart | QuickStart：用預設值快速完成，之後再調。 Guided：一個一個問你（搜尋引擎、技能、聊天平台等），適合進階用戶。 |
| 網路搜尋 | 跳過 | 讓 AI 搜尋網路。需要 Brave Search API key（$0 免費方案可用）。之後再設。 |
| Hooks | 跳過 | 自動化觸發器（定時任務、事件反應等）。進階功能，之後再設。 |
| Skills | No | 額外技能包（天氣查詢、安全掃描等）。之後用 openclaw skills 加。 |
| 聊天平台 | 跳過 | 連結 Discord、Telegram 等讓你手機也能跟 AI 聊天。之後用 openclaw channels 設定。 |
| 啟動方式 | 選 Hatch in TUI | TUI：在 Terminal 裡直接跟 AI 聊天（最快） Webchat：打開瀏覽器聊天介面（ http://127.0.0.1:18789）Gateway only：只啟動後台服務，適合進階用戶 |
🎉 設定完成！你現在有自己的 AI 了。
在 TUI 或 Webchat 裡打字，你的 AI 就會回答。
D. 常見問題與疑難排解
📌 目的
安裝過程中最常遇到的問題和解法。
🚨 macOS 擋住 VirtualBox 安裝！「無法打開...因為無法驗證開發者」
macOS 的 Gatekeeper 會擋住非 App Store 的軟體。
解法：
1. 對 VirtualBox 安裝檔按右鍵（或 Control + 點擊）→ 選「打開」
2. 會出現警告 → 再點一次「打開」
3. 或者：系統偏好設定 → 安全性與隱私 → 一般 → 點「允許」
🚨 VM 開機後黑畫面，顯示「No bootable medium found」
你建 VM 的時候忘了選 ISO 檔案（光碟映像）。
解法：
1. 關閉 VM 視窗
2. 選你的 VM → 點「設定」
3. 存儲 (Storage) → 點光碟機圖示 💿
4. 選你下載的 Linux Mint .iso 檔
5. 按「確定」→ 重新啟動 VM
🚨 電腦突然變超慢 / 凍住了
你可能同時跑了兩個 VM。8GB RAM 的電腦只能同時跑一個 VM。
解法：
1. Mac：Command + Option + Escape → 強制關閉 VirtualBox
2. Windows：Ctrl + Alt + Del → 工作管理員 → 結束 VirtualBox
3. 重新打開 VirtualBox → 刪掉不用的 VM → 只保留一個
🚨 安裝跑了 10 分鐘還沒動
正常的。npm 要下載 ~500 個小套件，在 VM 裡磁碟 I/O 慢 3-5 倍。只要游標（_）還在閃，就是還在跑。
• 10-15 分鐘：正常
• 20 分鐘：還是正常（看網速）
• 30 分鐘以上完全不動：Ctrl + C 取消，再跑一次安裝指令
🚨 Mac 跟 VM 之間無法複製貼上
需要兩個步驟：
步驟 1：在 Linux Mint 的 Terminal 裡執行：sudo apt install -y virtualbox-guest-utils virtualbox-guest-x11
然後重啟 VM。
步驟 2：VirtualBox 選單 → 你的 VM → 設定 → 一般 → 進階 → 共用剪貼簿 → 雙向
暫時替代：在 VM 裡開 Firefox 瀏覽器，用瀏覽器當剪貼簿橋樑。
🚨 VM 畫面太小
VirtualBox 選單 → View → Scaled Mode（或按 Host + C）→ 拉大視窗就會跟著放大。安裝完 Guest Additions 後會自動調整解析度。
🚨 「openclaw: command not found」
> ~/.bashrcsource ~/.bashrc"
data-en="Your shell can't find the openclaw binary. Usually a PATH issue.
Fix:
1. Check npm global prefix: npm prefix -g
2. Check if it's in PATH: echo $PATH
3. If not, add to ~/.bashrc:echo 'export PATH=\"$(npm prefix -g)/bin:$PATH\"' >> ~/.bashrcsource ~/.bashrc">
你的 shell 找不到 openclaw 執行檔。通常是 PATH 沒設對。
解法：
1. 先確認 npm 全域路徑：npm prefix -g
2. 確認它在 PATH 裡：echo $PATH
3. 如果沒有，加到 ~/.bashrc：echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc
💡 需要 Claude Max 訂閱嗎？
看你的用量：
• Claude Max（$100-200/月）— 無限量對話，最適合重度使用者
• Anthropic API（按用量付費）— 每百萬 token 約 $3-15，適合偶爾使用
• 免費替代方案— 可以用 Ollama 跑本地模型（如 Llama 3），完全免費但能力有限
💡 這會弄壞我的電腦嗎？
不會。
• VM 路線：完全隔離。VM 是沙盒，你的電腦不受影響。刪掉 VM = 恢復原狀。
• 直接安裝：OpenClaw 只是一個 npm 套件。npm uninstall -g openclaw 就完全移除。
• OpenClaw 不會主動存取你的私人資料。它只做你要求的事。
E. 基礎 Unix 指令速查
📌 目的
你不需要變成 Linux 高手。但這 15 個指令會讓你在 Terminal 裡不再害怕。
📂 檔案與資料夾
| 指令 | 意思 | 例子 |
|---|---|---|
ls |
列出檔案 | ls -la |
cd |
切換目錄 | cd ~/Documents |
pwd |
顯示目前位置 | pwd |
mkdir |
建立資料夾 | mkdir my-project |
cp |
複製檔案 | cp file.txt backup.txt |
mv |
移動 / 重新命名 | mv old.txt new.txt |
cat |
顯示檔案內容 | cat config.json |
🔧 系統操作
| 指令 | 意思 | 例子 |
|---|---|---|
sudo |
用管理員權限執行 | sudo apt update |
apt install |
安裝軟體 | sudo apt install git |
Ctrl + C |
中斷正在跑的程式 | （按住 Ctrl 再按 C） |
Ctrl + Shift + V |
在 Terminal 裡貼上文字 | （Ctrl + V 在 Terminal 不能用） |
clear |
清除畫面 | clear |
↑ 方向鍵 |
叫出上一個指令 | 反覆按 ↑ 可以瀏覽歷史 |
Tab |
自動補全 | 打 cd Do + Tab → 自動補全 Documents |
man |
查看指令說明 | man ls |
F. 最常用 OpenClaw 指令
📌 目的
安裝完 OpenClaw 後，你最常用到的指令。
🚀 日常使用
| 指令 | 做什麼 |
|---|---|
openclaw tui |
打開 Terminal 聊天介面 |
openclaw dashboard |
打開瀏覽器控制面板（Webchat） |
openclaw status |
查看 AI 是否在線、連接狀態 |
openclaw doctor |
診斷問題（像醫生檢查） |
⚙️ 設定與管理
| 指令 | 做什麼 |
|---|---|
openclaw setup |
重新跑設定精靈 |
openclaw channels |
設定聊天平台（Discord、Telegram 等） |
openclaw models |
切換 AI 模型 |
openclaw skills |
管理技能包（新增/移除） |
openclaw cron |
管理定時任務（自動排程） |
openclaw config |
查看 / 修改設定 |
🔧 維護
| 指令 | 做什麼 |
|---|---|
openclaw update |
更新到最新版 |
openclaw gateway restart |
重啟後台服務（出問題時試這個） |
openclaw logs |
查看運作日誌（排錯用） |
openclaw backup |
備份你的工作區和設定 |
openclaw uninstall |
完全移除 OpenClaw |
💡 安裝完了，然後呢？
你現在有了一個跑在你電腦上的 AI 助手。試試跟它說：
- 「你好！幫我簡單介紹你能做什麼。」
- 「幫我建一個待辦清單管理系統。」
- 「搜尋今天的 AI 新聞然後整理成摘要。」
想了解更多進階用法？讀我們的 OpenClaw 完全指南——從安裝到建立 AI 團隊的完整攻略。
本指南基於 OpenClaw v2026.3.x 和 Linux Mint 22.x XFCE。指令和界面可能隨版本更新而略有不同。最新安裝文件請參考 docs.openclaw.ai。