2026 年 OpenClaw 雲端伺服器部署兩種路線：一鍵鏡像 vs 原始碼編譯
OpenClaw 在雲端伺服器上的部署主要有兩種方式：一是選用雲廠商提供的 OpenClaw/Claw 應用鏡像一鍵開通，適合快速驗證和不想折騰依賴的使用者；二是手動安裝 Node 22、透過 npm 或 pnpm 全域安裝 openclaw 並自行設定，適合需要客製或已有固定維運流程的團隊。一鍵鏡像通常 3～5 分鐘即可存取控制台，但系統與版本由鏡像決定；原始碼編譯路線需要 20～30 分鐘，可精確控制 Node 與 openclaw 版本。2026 年多數新手更推薦先用一鍵鏡像跑通，再根據需求決定是否遷移到自建或遠端 Mac。
系統要求與必做項：Node 22、放通 18789 埠、防火牆與安全群組
無論哪種路線，以下三項必須滿足，否則控制台無法存取或服務無法正常對外提供。
| 項目 | 要求 | 說明 |
|---|---|---|
| Node.js | ≥ 22.0.0 | 低於 22 可能導致安裝或運行異常，建議用 nvm 管理：nvm install 22 && nvm use 22 |
| 埠 | TCP 18789 | OpenClaw 控制台與閘道預設埠，必須在執行個體安全群組/防火牆中放行入站 |
| 系統與資源 | Linux Ubuntu 20.04+ / macOS / Windows WSL2；最低 2 核 2GB 記憶體、20GB 磁碟 | 雲鏡像一般已滿足；自建需自行確認 |
雲端伺服器（騰訊雲、阿里雲等）務必在控制台找到「安全群組」或「防火牆」，添加入站規則：協定 TCP、埠 18789、來源 0.0.0.0/0（或按需限制 IP）。否則瀏覽器存取 http://伺服器IP:18789 會一直超時。
安裝過程常見問題：Node 版本不符、npm 卡死/超時、國內鏡像與 pnpm 使用
以下為 2026 年最常見的三類安裝問題與處理方式。
# 1. Node 版本檢查與切換（必須 ≥ 22）
node -v
nvm install 22
nvm use 22
# 2. 設定 npm 國內鏡像（解決卡死/超時）
npm config set registry https://registry.npmmirror.com
# 3. 使用 pnpm 取代 npm（可選，往往更快）
npm install -g pnpm
pnpm add -g openclaw@latest
# 4. 一鍵安裝腳本（官方，所有平台通用）
curl -fsSL https://openclaw.ai/install.sh | bash
Node 版本過低： 安裝或啟動報錯時先執行 node -v，若低於 22，用 nvm 或官方套件安裝 Node 22 並設為預設。
npm install 卡死或超時： 優先設定國內鏡像；若仍不穩定，可改用 pnpm 安裝。
Docker 容器無法啟動： 檢查 18789 是否被佔用（netstat -an | grep 18789），以及鏡像拉取是否完整（可設定國內鏡像加速）。
控制台無法存取、Telegram/飛書不回覆的排查步驟
控制台打不開（瀏覽器存取 http://IP:18789 超時或拒絕）： 九成以上是防火牆未放通 18789。請到雲廠商控制台檢查執行個體的「安全群組」→ 入站規則，新增 TCP 18789；若在自有机房或本機 Linux，檢查 firewalld、ufw 或 iptables 是否放行 18789。放通後重啟 OpenClaw 服務再試。
Telegram / 飛書 Bot 不回覆： 先確認 OpenClaw 服務在運行（openclaw status 或查看行程）；再檢查對應渠道的 Token 是否填寫正確、是否在 Bot 設定中啟用了相應能力；查看日誌 openclaw logs --tail 50 可看到連線或鑑權錯誤。多平台可同時設定，對話歷史按渠道隔離。
多平台接入與離線運行（Ollama）簡要說明
OpenClaw 支援在同一執行個體上設定多個渠道（Telegram、Discord、飛書等），所有渠道共用同一套 AI 能力，對話歷史相互獨立。技能與部分渠道接入需要連網；若使用 Ollama 等本地模型，可離線運行核心對話。模型選擇上：日常對話可選用 Kimi、MiniMax；程式設計任務推薦 Claude Sonnet、GPT-4；成本敏感可選 DeepSeek、Qwen；隱私優先可選用 Ollama 本地部署。
FAQ 與決策清單：何時用雲鏡像、何時用遠端 Mac 長期運行
- 只想快速驗證或短期試用： 用雲廠商 OpenClaw 鏡像即可，按上文放通 18789 與設定 API Key。
- 需要 7×24 穩定上線、不想操心雲主機維運與安全群組： 考慮將 OpenClaw 遷到遠端 Mac 託管（如 SFTPMAC），由服務方保障節點可用性、目錄與權限清晰，更適合長期自動化與多平台接入。
- 已有 Apple 生態或 Mac 工作流： 遠端 Mac 在相容性與桌面/檔案協作上更一致，升級與備份策略也更易統一。
雲鏡像適合快速上手與驗證；當任務從「偶爾跑一下」變成「常駐上線、多平台接入、需要穩定目錄與權限」時，遠端 Mac 託管往往能減少維運負擔並提升穩定性。
OpenClaw 控制台無法存取怎麼辦？
九成以上是防火牆或安全群組未放通 18789 埠。在雲廠商控制台檢查執行個體安全群組、入站規則，放行 TCP 18789；若在本地或自建機房的 Linux 上，檢查 firewalld/ufw 或 iptables 是否放行 18789。
npm install 卡死或超時怎麼解決？
設定國內鏡像：npm config set registry https://registry.npmmirror.com；或使用 pnpm 取代 npm 以加快安裝。同時確認 Node 版本 ≥ 22.0.0，否則可能相容性問題導致卡住。
何時該用雲鏡像、何時該用遠端 Mac 長期運行 OpenClaw？
雲鏡像適合快速驗證、短期試用或已有雲資源的情況；若需要 7×24 穩定上線、Apple 生態相容、目錄與權限清晰、或與現有 Mac 工作流統一，建議選用遠端 Mac 託管（如 SFTPMAC）長期運行。
雲端伺服器自建 OpenClaw 能快速跑通，但長期運行會涉及安全群組、系統更新、備份與多環境一致性。若你更希望專注在 AI 自動化本身而非維運細節，可考慮將 OpenClaw 部署到 SFTPMAC 提供的遠端 Mac 節點：我們保障 18789 埠可達、目錄與權限清晰，並相容多平台接入與 7×24 穩定運行，你只需設定模型與渠道即可。