想快速體驗 OpenClaw 卻不知從哪一步開始？本文面向零基礎使用者，給出安裝前準備（Node 版本與 18789 埠）、三種安裝方式與 10 分鐘路線選擇、從安裝到第一次對話的步驟，以及埠/控制台無法存取的 3 個常見卡點與 FAQ，幫助你在 Windows、Linux、macOS 或遠端 Mac 上都能在約 10 分鐘內跑通第一次對話。
安裝前準備：Node 版本與 18789 埠
OpenClaw 2026 要求 Node.js v22 或更高，低於此版本會導致安裝或編譯失敗。建議使用 nvm 管理：nvm install 22 && nvm use 22。此外，OpenClaw 預設使用 18789 埠 提供 Web 控制台，若你使用雲端伺服器或遠端 Mac，必須在防火牆/安全群組中放行 18789（TCP），否則瀏覽器無法存取控制台。
- Node 版本：終端機執行
node -v，需 ≥ v22.0.0。 - 埠 18789：本機或雲端主機需允許入站 18789；Linux 上可執行
ufw allow 18789（若使用 ufw）。
三種安裝方式與 10 分鐘路線選擇
根據你的環境與偏好，可選用以下三種方式之一，目標都是在約 10 分鐘內完成安裝並開啟控制台。
| 方式 | 適用對象 | 典型耗時 | 備註 |
|---|---|---|---|
| 官方安裝腳本 | 新手、本機或 VPS 快速體驗 | 約 5–10 分鐘 | curl -fsSL https://openclaw.ai/install.sh | bash，腳本會偵測並安裝 Node。 |
| npm 全域安裝 | 已有 Node 22+ 的開發者 | 約 5–8 分鐘 | npm install -g openclaw@latest，之後執行 openclaw onboard 與 openclaw gateway。 |
| Docker / 預裝映像 | 團隊或生產環境、希望隔離依賴 | 約 10–15 分鐘 | 使用官方或社群 Docker 映像，需對應 18789 埠；部分雲端廠商提供 OpenClaw 一鍵映像。 |
npm config set registry https://registry.npmmirror.com。從安裝到第一次對話的步驟
以「安裝腳本 + onboard」為例，最小路徑如下。
安裝 OpenClaw
執行 curl -fsSL https://openclaw.ai/install.sh | bash 或 npm install -g openclaw@latest，等待完成。
執行設定精靈
執行 openclaw onboard，依提示完成 Gateway、API 等基礎設定；若有授權彈窗（如 macOS），需在圖形介面點擊允許。
啟動 Gateway
執行 openclaw gateway（或依文件使用 systemd/pm2 常駐），確保 18789 埠已監聽。
開啟 Web 控制台
瀏覽器存取 http://localhost:18789（或你的伺服器 IP:18789），進入 Dashboard。
發送第一條指令
在控制台或 TUI（openclaw tui）中發送一條簡單指令，確認模型與 Gateway 正常回應，即完成「第一次對話」。
埠與控制台無法存取的 3 個卡點
新手最容易卡在「裝好了但打不開控制台」或「onboard 中途報錯」，常見原因與對策如下。
- 防火牆/安全群組未放行 18789：雲端伺服器必須在安全群組中添加入站規則，放行 TCP 18789；本機 Linux 若啟用 ufw，需
ufw allow 18789並 reload。 - Node 版本過低：若未滿足 Node 22+，安裝或執行可能報錯；用
nvm use 22或系統套件管理員升級後再試。 - 預設 Token 未修改導致被掃描：部署後建議立即在 Dashboard 中修改預設 Gateway Token，避免被公網掃描濫用；同時檢查系統提示詞長度，避免 Token 消耗異常。
FAQ
10 分鐘真的能跑通第一次對話嗎？
在 Node 22+ 與網路正常的前提下，使用安裝腳本或 npm 全域安裝，按 onboard → gateway → 開啟 18789 控制台 → 發一條指令的流程，多數使用者可在 10 分鐘內完成。若遇網路或權限問題，可參考站內 OpenClaw 報錯排查與部署文章。
在遠端 Mac 上裝 OpenClaw 有什麼好處？
遠端 Mac 提供完整圖形介面（VNC），onboard 過程中的系統授權彈窗、Keychain 確認等可直接點擊完成，避免純 SSH 下無法處理彈窗的問題；同時可與站內其他 OpenClaw 部署、授權彈窗規避等文章配合使用。
openclaw doctor 是做什麼的？
openclaw doctor 用於健康檢查，可協助診斷環境、依賴與設定是否正常；遇到無法啟動或控制台異常時，可先執行 doctor 查看輸出，再結合站內排查指南處理。
結語：在本機 Windows、Linux 或自建 VPS 上安裝 OpenClaw 都能跑通，但常會遇到 Node 版本、埠放行、授權彈窗與依賴環境等問題，排查成本不低。若你希望減少環境折騰、快速體驗 OpenClaw 的完整能力（包括需要圖形介面的 onboard 與系統授權），使用租賃 VNCMac 的遠端 Mac並在 VNC 桌面中部署 OpenClaw，可以避免本機環境差異與彈窗無法點擊的痛點，幾分鐘內獲得一台已就緒的 Mac 與圖形化設定流程。如需選型可參考站內「OpenClaw 環境選型」與「快速開通」頁面。