2026 年 8 月更新：OpenClaw 官方目前提供 macOS／Linux 安裝程式、Windows PowerShell 安裝程式，也支援 WSL2 Gateway。舊教學常見的 Node.js 18 與手動 clone 流程已不是一般使用者的首選。

安裝前要準備什麼？

  • 一台可管理的電腦：macOS、Linux，或 Windows。
  • 模型服務帳號：依你選擇的 OpenAI、Anthropic、Google 或其他供應商準備 API 金鑰。
  • 第一個使用情境：先決定要驗收聊天、文件整理、提醒，或某一個低風險流程。
  • 權限界線：帳號與金鑰由本人持有；付款、刪除、對外承諾等動作保留人工確認。

官方目前要求受支援的 Node.js 版本，並建議使用 Node 26。版本門檻可能隨專案更新，因此執行前應先看 OpenClaw 官方 Getting Started，不要只照舊文章中的版本號操作。

Mac 安裝：使用官方安裝程式

macOS 一般互動式安裝可使用官方提供的安裝程式：

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

安裝程式會檢查 Node.js 與 Git 等需求，必要時處理相依環境，再進入 onboarding。執行任何從網路下載的腳本前，應先確認網址是 openclaw.ai 官方網域並閱讀內容。

Windows 安裝：原生 PowerShell 還是 WSL2？

方式適合誰注意事項
Windows Hub想走較簡單桌面路線的一般使用者依官方最新下載與支援狀態為準
PowerShell熟悉 Windows 終端機、希望直接安裝需要 PowerShell 5 以上；PATH 與權限問題要逐項檢查
WSL2 Gateway已有 Linux 工具鏈或後續要做較多開發要先把 WSL2、網路與檔案位置分清楚

選擇 PowerShell 時，官方目前提供：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果你不熟悉 PowerShell、WSL2、PATH 或服務常駐，先不要反覆重裝。保留完整錯誤訊息與執行環境，比刪除所有設定後重來更容易排查。

安裝後怎麼驗收？

  1. 確認 OpenClaw 指令能在新的終端機中執行。
  2. 完成 onboarding，設定本人持有的模型服務金鑰。
  3. 先用內建聊天或單一通道完成一個簡單任務。
  4. 重新啟動電腦或服務後再測一次，確認不是只在當次終端機有效。
  5. 記錄設定位置、啟動方式、停止方式與移除方式。

LINE、Telegram、Discord 不要一次全接

先讓 OpenClaw 本體與模型連線穩定，再選一個通訊平台。LINE 還牽涉 LINE Developers、Webhook、HTTPS 公開網址與真人接手規則；把所有平台同時加入，會讓錯誤來源難以判斷。

可以先看 OpenClaw 通訊平台選擇指南，若目標是 LINE 客服，再看 LINE AI 助理架構與真人接手。

常見問題

OpenClaw 可以安裝在 Mac 嗎？

可以。官方提供 macOS／Linux 安裝程式，會檢查必要的 Node.js 與 Git 環境。

Windows 一定要用 WSL2 嗎？

不一定。官方目前也提供 Windows Hub 與 PowerShell 路線；若後續需要 Linux 工具鏈，才考慮 WSL2 Gateway。

遠端代裝需要把 API Key 傳給安裝人員嗎？

不需要。較安全的做法是由本人在自己的設備輸入金鑰，遠端協助只確認欄位、權限與測試結果。

安裝完成就能自動處理所有工作嗎？

不能。安裝只代表環境可啟動；每個自動化任務仍要另外定義資料、允許動作、人工確認、錯誤處理與驗收方式。