安裝 OpenClaw 需要多久？

使用一鍵安裝腳本的話，本地安裝大約 5-10 分鐘，腳本會自動偵測系統、安裝 Node.js、安裝 OpenClaw 並啟動設定精靈；雲端部署則通常只需數分鐘即可完成，不必自己處理底層環境。安裝完成後還會進入首次設定流程，依序選擇 AI 模型提供者、輸入 API Key、設定通訊平台串接，整體下來大多數人可以在 10 分鐘內開始使用。

Node.js 版本不對怎麼辦？

OpenClaw 需要 Node.js 24（建議）或 22.19 以上。使用一鍵安裝腳本時會自動安裝對應版本；若想自行管理版本，可用 nvm 或 fnm，例如執行 `nvm install 24`。記得在 shell 啟動檔（如 ~/.zshrc）初始化版本管理器，否則新開的終端機可能會找不到 openclaw 指令。若仍不確定目前版本是否符合需求，可先執行 `node --version` 確認，再用 `nvm use 24` 切換到正確版本。

我在 Windows 上安裝遇到權限問題怎麼辦？

請以系統管理員身份開啟 PowerShell（需 PowerShell 5 以上），或確認你的使用者帳號具有安裝軟體的權限。原生 Windows 與 WSL2 都支援安裝，其中 WSL2 環境通常較為穩定，若原生環境持續出現權限問題，可考慮改用 WSL2。若是安裝完成後找不到 `openclaw` 指令，多半是 PATH 環境變數沒有正確設定，可參考疑難排解頁面手動加入 PATH 的指令。

API Key 要從哪裡取得？

視你選用的 AI 模型而定：OpenAI 的 Key 在 platform.openai.com 的 API Keys 頁面建立；Claude 在 console.anthropic.com 取得；Gemini 則可在 Google AI Studio 申請。取得後在設定精靈或 openclaw.json 中填入即可，多數供應商採用量計費。如果不想負擔 API 費用，也可以改用 Ollama 本地模型，完全免費運行，但須留意硬體需求（建議 24 GB VRAM 以上才能順暢執行 20B 以下的模型）。

雲端部署跟本地安裝有什麼差別？

雲端部署是把 OpenClaw 架設在雲端主機上，24 小時在線、不需自己管理伺服器的開機、斷網或硬體維護，適合希望服務穩定常駐、不想處理機房雜事的使用者。本地安裝則是把所有程式與資料都留在你自己的設備上，可以完全離線使用、搭配 Ollama 本地模型零成本運行，且資料不會經過任何雲端服務商，對隱私要求高的使用情境更有優勢。兩者也可以混合使用，例如本地安裝但搭配雲端 AI 模型。

Mac mini 適合用來跑 OpenClaw 嗎？

非常適合！Mac mini 體積小、功耗低，可以 24 小時持續運行而不必擔心電費或散熱問題，Apple Silicon 晶片的效能也足以應付日常的訊息處理與自動化任務。搭配 Ollama 本地模型，可以把 Mac mini 打造成完全離線、資料不外流的私有 AI 管家，特別適合放在家中當作常駐主機。詳細的本地模型設定可參考「進階配置」頁面。

openclaw onboard 是做什麼的？

這是 OpenClaw 的首次設定精靈，執行 `openclaw onboard --install-daemon` 後會依序引導你完成四個步驟：選擇 AI 模型提供者、輸入對應的 API Key、設定要串接的通訊平台，最後安裝並啟動 Gateway 背景服務。一鍵安裝腳本會在安裝完成後自動執行這個精靈；如果你是用 npm 安裝，或想重新設定，也可以隨時手動再次執行它。

如何快速安裝 OpenClaw？

選擇你的作業系統，幾分鐘內完成安裝，開始使用你的 AI 數位助理。

⚠️

安裝前請注意

強烈建議不要將 OpenClaw 安裝在自己的工作電腦或家中個人電腦上。建議使用獨立的伺服器、Mac mini、雲端平台或虛擬機進行部署，以確保穩定性與安全性。

環境需求

Node.js 24（建議）或 22.19 以上

一鍵安裝腳本會自動偵測並安裝對應版本，無需手動處理

AI 模型 API Key

準備 OpenAI、Claude、Gemini 的 API Key（或使用 Ollama 本地模型）

通訊平台帳號

至少準備一個 Telegram / WhatsApp / Line 帳號用於串接

安裝 OpenClaw

切換下方分頁，依你的作業系統選擇安裝方式。

方法一（推薦）：一鍵安裝腳本

安裝腳本會自動偵測系統、安裝所需的 Node.js、安裝 OpenClaw，並啟動設定精靈。

PowerShellpowershell

# 開啟 PowerShell（建議系統管理員），執行：
iwr -useb https://openclaw.ai/install.ps1 | iex

需要 PowerShell 5 以上。原生 Windows 與 WSL2 皆支援，其中 WSL2 環境較為穩定。

方法二：使用 npm 安裝

若你想自行管理 Node.js 版本，可改用 npm。請先安裝 Node.js，再安裝 OpenClaw。

步驟 1：安裝 Node.js

使用 winget 安裝 Node.js（或改用 Chocolatey / Scoop）：

# 使用 winget（建議）
winget install OpenJS.NodeJS.LTS

# 或使用 Chocolatey
choco install nodejs-lts

步驟 2：安裝 OpenClaw

# 全域安裝 OpenClaw
npm install -g openclaw@latest

# 啟動設定精靈並安裝背景服務
openclaw onboard --install-daemon

驗證安裝

安裝完成後，執行以下指令確認 OpenClaw 正常運作：

# 確認 CLI 是否可用
openclaw --version

# 檢查設定是否有問題
openclaw doctor

# 確認 Gateway 背景服務運作中
openclaw gateway status

首次設定

一鍵安裝腳本會在安裝完成後自動啟動設定精靈。若你改用 npm 安裝，或想重新設定，可手動執行：

首次設定bash

# 啟動設定精靈並安裝背景服務
openclaw onboard --install-daemon

# 設定精靈會引導你完成：
# 1. 選擇 AI 模型提供者
# 2. 輸入 API Key
# 3. 設定通訊平台串接
# 4. 安裝並啟動 Gateway 背景服務