OpenClaw 平台與安裝指南：選擇最適合你的運行環境

身為開發者，最煩的事情莫過於程式碼在本地跑得好好的，一換到伺服器或換個 runtime 就噴一堆莫名其妙的錯誤。特別是處理即時通訊協議時，不同環境的細微差異常讓你熬夜抓蟲，卻發現只是環境不相容。

OpenClaw 核心使用 TypeScript 編寫，雖然現在有很多新興的工具，但為了確保穩定，我們建議你選擇最穩妥的路徑來佈署。

需要準備的東西

在開始之前，請確保你具備以下條件：

• Node.js：這是官方推薦的 runtime。
• 支援的作業系統：macOS, Linux, Windows (建議透過 WSL2), iOS 或 Android。
• 雲端空間（選配）：如果你打算跑在線上，可以選擇 Fly.io, Hetzner, GCP 或 exe.dev。

快速開始

想在 5 分鐘內搞定 Gateway 服務？請遵循以下步驟：

1. 選擇 Runtime：請使用 Node.js。雖然 Bun 很熱門，但我們不推薦在 Gateway 上使用它，因為在處理 WhatsApp 和 Telegram 時會出現 bug。
2. 執行安裝指令：你可以從下面選一個最順手的方式：

使用自動引導（推薦）：

openclaw onboard --install-daemon

或是直接安裝：

openclaw gateway install

如果你想手動挑選服務： 執行 openclaw configure 並選擇 Gateway service。

安裝完成後，你可以隨時檢查服務狀態：

openclaw gateway status

選擇你的作業系統

OpenClaw 在不同平台有不同的表現形式。macOS 有專屬的選單列 App，行動端則有 iOS 和 Android 的原生 Node。

• macOS / Linux：完整支援 Gateway 與 Companion apps。
• Windows：目前建議透過 WSL2 執行 Gateway，原生 Windows Companion app 還在開發中。
• 服務管理：在 macOS 上會註冊為 LaunchAgent (bot.molt.gateway)；在 Linux 或 WSL2 則會註冊為 systemd user service (openclaw-gateway.service)。

疑難排解

遇到問題時別慌，這裡有幾個源文檔提供的解決方案：

1. 服務無法啟動或運行異常 你可以使用內建的診斷工具，它會自動掃描並詢問是否要修復或重新安裝服務：

openclaw doctor

2. 跨平台相容性問題 如果你在 Bun 環境下遇到 WhatsApp 或 Telegram 的奇怪 bug，請切換回 Node.js 運行環境。

---

有任何安裝上的疑難雜症嗎？直接詢問 AI Setup Assistant 獲取即時協助。

下一步

• 新手上路指南
• Gateway 運行手冊
• 詳細配置說明
• VPS 佈署教學