安裝前準備
開始安裝 OpenClaw 之前，確保你的環境、帳號、API Key 都準備好 — 省下 80% 的卡關時間
安裝 OpenClaw 本身只要一行指令。但如果環境沒準備好，你會在各種莫名其妙的地方卡住。花 15 分鐘做好準備，後面 30 分鐘的安裝流程會順暢很多。
時間估算
| 階段 | 預估時間 |
|---|---|
| 環境準備（本頁內容） | 約 15 分鐘 |
| 安裝 OpenClaw + 設定 | 約 30 分鐘 |
| 驗證 + 首次測試 | 約 10 分鐘 |
系統需求
OpenClaw 支援以下作業系統：
| 項目 | macOS | Ubuntu / Debian |
|---|---|---|
| 最低版本 | macOS 13 (Ventura) | Ubuntu 22.04 LTS |
| 推薦版本 | macOS 14+ (Sonoma) | Ubuntu 24.04 LTS |
| CPU | Apple Silicon 或 Intel | 1 vCPU 以上 |
| 記憶體 | 4GB 以上（推薦 8GB+） | 2GB 以上（推薦 4GB+） |
| 硬碟 | 10GB 可用空間 | 10GB 可用空間 |
Windows 使用者可以透過 WSL2 (Windows Subsystem for Linux) 安裝 Ubuntu，再按照 VPS 流程操作。但我們不建議這條路 — WSL2 的網路和 systemd 行為偶爾會有驚喜。
macOS 使用者注意：你的帳號必須是管理員（Administrator）。Homebrew 安裝需要 sudo 權限，非管理員帳號會直接失敗。確認方式：系統設定 → 使用者與群組，你的帳號旁邊應該標示「管理者」。
Node.js >= 22（透過 nvm 安裝）
OpenClaw 需要 Node.js 22 或以上版本。我們強烈建議用 nvm 管理 Node.js 版本，而不是直接從官網下載安裝。原因很簡單：你遲早會需要切換版本，nvm 讓這件事無痛。
安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash安裝完成後，重新開啟終端機（或執行 source ~/.bashrc / source ~/.zshrc），然後驗證：
nvm --version
# 應該顯示 0.40.1 或更新版本安裝 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22驗證版本：
node --version
# v22.x.x
npm --version
# 10.x.x 或更新如果你的系統已經有 Node.js 但版本低於 22，不要嘗試升級 — 用 nvm 安裝一個新的版本，然後設為 default。混用版本管理方式是最常見的踩坑點。
AI Model API Key
OpenClaw 需要至少一個 AI Model 的 API Key 才能運作。你的 Agent 有多聰明，取決於你選的模型。
最常見的昂貴錯誤：搞混 Claude Token 和 Anthropic API Key。 很多人直接去 Anthropic Console 申請 API Key，結果每次 Agent 回覆都是按 token 計費。有人因此在第一個月就燒了 $800 美元。正確做法是用 Claude Pro/Max 訂閱的 Token（固定月費），而非 Anthropic Console 的 pay-per-use API Key。詳見省錢策略。
我們推薦：Claude Pro/Max 訂閱（而非 API 直接計費）
Claude 在長對話、指令遵循、中文理解上的表現目前是最好的。如果你只準備一把 Key，選 Anthropic — 但請用訂閱方案的 Token，不是 API Key。
用 Claude 訂閱 Token（推薦）：
- 訂閱 Claude Pro（$20/月）或 Claude Max（$100/月）
- 安裝 Claude CLI：
curl -fsSL https://claude.ai/install.sh | bash - 執行
claude setup-token取得你的 Token - 記下 Token — 注意複製時不要帶到尾端的空格，這是最常見的安裝錯誤
用 Anthropic API Key（按量計費，進階使用者）：
- 前往 Anthropic Console
- 註冊帳號（需要信用卡）
- 建立 API Key
- 記下 Key — 它只會顯示一次
其他支援的模型
| Provider | 模型 | 適合場景 |
|---|---|---|
| OpenAI | GPT-4o | 多模態任務、英文為主的工作流 |
| Gemini Pro | 長上下文、大量文件處理 |
你可以同時設定多把 API Key，讓不同的 Agent 使用不同的模型。這在後續的進階設定中會詳細說明。
語音辨識：Groq（免費，選擇性但推薦）
如果你想用語音訊息跟 Agent 對話（而不是每次都打字），Groq 提供免費的語音轉文字服務。移動端的體驗是殺手級的 — 走路、開車時直接對 Agent 說話。
- 前往 Groq Console 註冊
- 建立 API Key
- 記下 Key
Telegram 和 Discord 已內建語音訊息支援，搭配 Groq 就能讓 Agent 「聽懂」你說的話。很多使用者反映，用了語音訊息之後，跟 Agent 的互動頻率提高了 10 倍。
網頁搜尋：Brave Search（免費，選擇性）
讓你的 Agent 能搜尋網頁，回答即時資訊。
- 前往 Brave Search API 註冊
- 取得 API Key
- 記下 Key
網域準備（選擇性但推薦）
如果你要讓外部服務（LINE、Telegram）的 Webhook 打到你的 OpenClaw Gateway，你需要一個公開可存取的網址。最簡單的方式是透過 Cloudflare Tunnel。
你需要準備：
- 一個網域 — 你已經擁有的任何網域都可以。如果沒有，去 Cloudflare Registrar 或 Namecheap 買一個（約 NT$300/年）
- 將 DNS 託管到 Cloudflare — 如果網域不是在 Cloudflare 買的，需要把 nameserver 指向 Cloudflare
設定 Cloudflare 帳號
- 前往 Cloudflare Dashboard 註冊
- 新增你的網域（Add a site）
- 選擇 Free 方案 — 對我們的用途完全夠用
- 按照指示更改 nameserver（DNS 生效需要幾分鐘到幾小時不等）
如果你的 OpenClaw 部署在有固定公網 IP 的 VPS 上，你也可以直接用 IP + 反向代理（nginx），不一定需要 Cloudflare Tunnel。但 Tunnel 的好處是不用開任何 inbound port，安全性更好。
準備清單
在開始安裝之前，確認你有以下東西：
- macOS 帳號具有管理員權限（macOS 安裝必要）
- Node.js >= 22 已安裝（
node --version確認） - npm >= 10 已安裝（
npm --version確認） -
.zshrc中有 Homebrew 和 NVM 的 PATH 設定（macOS 使用者，詳見安裝流程 Step 1） - Claude Pro/Max 訂閱 Token 或 Anthropic API Key（推薦訂閱 Token）
- Brave Search API Key（免費，選擇性）
- Groq API Key（免費，選擇性但推薦）
- Telegram Bot Token（透過 BotFather 取得，免費）
- （如需 LINE）LINE Developers 帳號和 Messaging API Channel
- Cloudflare 帳號已建立（如果需要外部存取）
- 網域已託管到 Cloudflare（如果需要外部存取）
- SSH 連線已設定（如果安裝在 VPS 上）
- 約 30-45 分鐘的連續時間
Pro tip：把所有 Key 和 Token 先存到筆記軟體裡，等下安裝時直接複製貼上。中途才去找 Key 是最容易卡關的地方 — 把準備工作和安裝工作分開做，省下大量心智切換的時間。
全部打勾了？接下來選擇你的安裝路線：
- Mac mini → Mac mini 完整安裝流程
- VPS → VPS 完整安裝流程
GetClaw 觀點
準備工作很無聊，但它決定了你後面的安裝體驗是「十分鐘搞定」還是「三小時除錯」。我們見過最多的安裝問題，不是 OpenClaw 本身的 bug，而是 Node.js 版本不對、npm 權限混亂、或是 DNS 還沒生效就急著測 Webhook。
磨刀不誤砍柴工。把這頁的清單走完，後面的路會很順。