OpenClaw 系統要求

在安裝前,請確保您的環境符合基本要求。

簡短回答

OpenClaw 要求 Node.js 22 或更新版本,並支援 macOS、Linux,以及透過 WSL2 的 Windows。對大多數使用者而言,一台現代筆記型電腦已足夠,除非您需要運行本地模型或進行大量自動化。

為何需要 Node.js 22+

運行環境依賴於現代 Node.js 功能及最新的依賴套件。使用舊版 Node.js 通常會導致安裝失敗,或在負載下網關程序崩潰。

支援的作業系統

macOS 和 Linux 提供原生支援。Windows 使用者應透過 WSL2 運行 OpenClaw,以獲得穩定的類 Unix 環境。如果您在伺服器上託管,Linux 是最可預測的選擇。

依使用案例劃分的硬體指南

如果您僅使用雲端模型,CPU 和記憶體需求將保持適中。如果您計劃運行本地模型或同時處理多個頻道,更多的 RAM 和儲存空間將有所幫助。請保留足夠的磁碟空間用於日誌、快取和技能資料。

最低要求 vs 建議要求

一台配備 8 GB RAM 的現代筆記型電腦,通常足以應付雲端模型和輕量級自動化。對於更繁重的負載,16 GB 或更多將是更穩妥的基準。強烈建議使用 SSD 儲存,以加快日誌、快取存取和模型下載速度。

網路考量

OpenClaw 可完全在本機運行,但許多使用者會連接到外部模型 API。請確保允許穩定且對外的 HTTPS 連線。如果您的網路受到嚴格限制,請規劃代理伺服器設定,並確認網關連接埠未公開暴露於公眾。

使用者權限及守護行程模式

請在一般使用者帳戶下安裝和運行 OpenClaw,而非特權系統帳戶。如果您使用守護行程模式,請驗證服務是否在開機時啟動,並且其工作目錄是否可讀寫。不正確的權限是導致無聲故障的常見原因。

快速環境檢查

Check your Node version first, then run openclaw doctor after install. Fixing missing dependencies early saves hours of debugging later.

官方參考

Use the official install requirements as the authoritative source: Install requirements .