OpenClaw 安裝怎麼選?Windows、Mac、雲端主機五種裝法,附 Linux 實測

部分實測2026.10.12

OpenClaw(龍蝦 AI)官方列了十幾種安裝方式,新手很容易選錯。這篇整理成五條路,講各自適合誰、指令是什麼。Linux 主機那條我實際裝了一次:71 秒裝完,啟動後閒置就多用掉將近 1 GB 記憶體。

更新 2026/10/15・約 15 分鐘讀完・查證環境:OpenClaw 2026.10.2。Linux 那條在兩台雲端測試機上實際跑過(1 核心 2 GB、2 核心 4 GB,都是 Ubuntu 26.04);Windows、Mac、npm、Docker 依官方文件整理

先講結論

  • 只想試一下,有 Node.js 的話一行 npx openclaw@latest 就能跑。Windows 用官方的桌面程式 Windows Hub,Mac 和 Linux 用官方安裝腳本,要它 24 小時開著就放雲端主機。
  • 現在的最低需求是 Node.js 24.16 以上或 26.1 以上。比較舊的教學寫 Node 22,已經不適用了。
  • Linux 主機那條我實際裝過。1 核心、2 GB 的機器上 71 秒裝完,多佔 1.6 GB 硬碟,啟動後閒置就多用掉 0.8 到 1 GB 記憶體。主機的記憶體我會至少抓 2 GB。
目錄
  1. 裝之前先確認兩件事
  2. 五條路,先看這張表
  3. 第一條:一行試跑
  4. 第二條:Windows 用 Windows Hub
  5. 第三條:Mac 和 Linux 用安裝腳本
  6. 第四條:自己用 npm 裝
  7. 第五條:放到雲端主機
  8. 我實際裝了一次:一台 2 GB 的 Linux 主機
  9. 設定精靈會問什麼
  10. 裝完怎麼確認

想裝 OpenClaw 的人,打開官方文件的安裝頁通常會愣住。安裝腳本、npm、pnpm、bun、Docker、Podman、Nix、桌面程式,再加上十幾家雲端主機各一頁。

其實一般人會走的只有五條路。這篇幫你選。

先講清楚哪些是我跑過的。Linux 主機那條,我開了雲端測試機實際裝過,花多久、吃多少記憶體,後面有數字。Windows、Mac 和 npm 那幾條我沒有裝,指令是從官方文件逐字抄來的。我沒有把它裝在平常工作的電腦上,原因寫在OpenClaw 是什麼那篇講風險的地方。

裝之前先確認兩件事

第一是 Node.js 的版本。官方現在寫的最低需求是 24.16 以上或 26.1 以上,建議用 26。在終端機打 node --version 可以看自己是哪一版。

這點要特別講,因為你如果照比較舊的教學裝,會看到「Node 22 以上」。那是之前的需求,現在不適用了。用官方的安裝腳本的話,它發現你沒有 Node 會自己幫你裝。我實測那次,它裝進來的是 24.21。

第二是 AI 模型的使用權。你電腦上已經登入的 Claude Code 或 Codex,或是任何一家的 API key,有一個就行。沒有這個,裝好了它也不會動。

五條路,先看這張表

你的情況 走哪條路
只想試一下,不想留東西 npx 一行試跑
用 Windows Windows Hub 桌面程式
用 Mac 或 Linux 官方安裝腳本
本來就自己在管 Node npm 安裝
要它 24 小時開著 雲端主機,或買代管

第一條:一行試跑

有 Node.js 的話,官方給的試用方式是:

npx openclaw@latest

它會直接跑起來,不用先安裝。官方說第一次會讓你選 Quick start,它會自己找到你已經有的 AI 登入,確認能用,然後打開網頁版的控制台。

這樣跑的 OpenClaw 是跟著那個終端機視窗的,按 Ctrl + C 就停了,設定會留著。想先看看它長什麼樣子的人,從這裡開始最沒有負擔。

有一點要有心理準備:不用安裝,不代表不佔空間。我量到 OpenClaw 這個套件本身是 603 MB,npx 一樣要把它整包抓下來。

第二條:Windows 用 Windows Hub

Windows 有三種裝法,官方推薦的是 Windows Hub。

它是一個一般的桌面程式,下載安裝檔、點兩下就好。官方寫它支援 Windows 10 20H2 以上和 Windows 11,安裝不需要系統管理員權限,有 x64 和 ARM64 兩種版本。下載連結在官方文件的 Windows 那一頁。

第一次打開,選 Set up locally。它會自己建一個專用的 WSL 環境,把 OpenClaw 的核心裝在裡面。官方特別註明,這不會動到你電腦上原本的 Ubuntu。

另外兩種是給比較熟的人。一種是用 PowerShell 跑安裝腳本,直接裝指令列版本:

iwr -useb https://openclaw.ai/install.ps1 | iex

另一種是自己在 WSL2 裡面裝,官方說這種跟 Linux 的相容性最好。

三種裝法的完整步驟、該下載哪個安裝檔、開機自動啟動,以及裝不起來時怎麼處理,整理在 OpenClaw Windows 安裝教學。

第三條:Mac 和 Linux 用安裝腳本

官方推薦的方式是一行腳本:

curl -fsSL https://openclaw.ai/install.sh | bash

它會偵測你的系統,沒有 Node 就幫你裝,然後裝 OpenClaw,最後自動進入設定精靈。

把一支沒看過的腳本直接丟給 bash 跑,會不放心很正常。這支腳本有四千五百多行,我也沒有逐行讀完。它有一個 --dry-run 參數,只印出打算做什麼,不會動任何東西。我是先把腳本存成檔案再跑的:

curl -fsSL https://openclaw.ai/install.sh -o install.sh
bash install.sh --dry-run --no-prompt --no-onboard

畫面上會列出它偵測到的系統、安裝方式和版本,最後一行是 Dry run complete (no changes made)。

設定精靈跑完,OpenClaw 還是跟著這個終端機視窗的。要它在背景一直開著,先按 Ctrl + C 停掉,再執行:

openclaw gateway install

這會把它裝成系統服務,之後你登入系統,它就會自己在背景啟動。

Mac 另外有一個選單列的桌面程式,可以從 GitHub 的發行頁下載。只需要指令列的人不用裝它。

第四條:自己用 npm 裝

本來就自己在管 Node 版本的人,可以直接用 npm:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

第一行後面那個 --allow-scripts=openclaw 是有原因的。官方文件說,npm 12 預設會擋掉套件的安裝腳本,不加這個參數,OpenClaw 的安裝步驟會被擋下來。如果你的 npm 是 11.15 以前的版本,就不要加,舊版不認得這個參數。

第五條:放到雲端主機

要它 24 小時待命,就不能裝在會睡眠的筆電上。

官方文件有一頁專門列主機商,每一家都有自己的安裝說明:DigitalOcean、Hetzner、Google Cloud、Azure、Fly.io、Railway、Render、Oracle Cloud、Hostinger,還有樹莓派。其中 Oracle Cloud 那一頁,官方標的是永久免費的方案。

在一般的 Linux 主機上,裝法跟第三條一樣,就是那行安裝腳本。作業系統官方建議用 Ubuntu。

主機跟自己的電腦不一樣的地方是,它是放在公開的網路上。官方在這裡提醒了兩件事。裝之前先把主機本身的登入方式弄安全。裝好之後,OpenClaw 的控制台預設只給主機自己連,你要從外面連進去,應該走 SSH 通道或 Tailscale,不要直接把它開到網路上。

規格怎麼挑,後面有我量到的數字。先講結論:記憶體至少抓 2 GB。

如果這些你都不想碰,還有代管這個選項。官方文件有一頁 Hostinger,它賣的代管方案買了就能用,主機、更新、備份都是他們處理。要自己管的話,它最小的 VPS 方案是 1 核心、4 GB 記憶體、50 GB 硬碟,這是 2026 年 10 月 12 日方案頁上寫的。實際的價格我放進購物車點過,整理在OpenClaw 費用怎麼算。其他主機商同一級的方案,在VPS 推薦哪一家。OpenClaw 要選 Hostinger 哪一級方案、續約價多少,我整理在 Hostinger 評價。

另一條不用自己打指令的路是 Zeabur。它有 OpenClaw 的一鍵模板,模板頁寫最低要 2 核心、4 GB 的主機。這個模板我沒有實際用過,它的收費方式和模板的細節整理在Zeabur 是什麼。

至於 Docker,官方的說法是選配。它適合想要一個隔離、用完就丟的環境的人。平常就在自己電腦上工作的話,官方建議用一般的安裝方式。

我實際裝了一次:一台 2 GB 的 Linux 主機

2026 年 10 月 12 日,我開了一台用完就丟的雲端測試機來裝,用的是 Vercel 的沙盒。規格是 1 核心、2 GB 記憶體,作業系統 Ubuntu 26.04,全新的,連 curl 都沒有。裝的版本是 OpenClaw 2026.10.2。

先補裝 curl,6 秒。接著跑官方的安裝腳本,從按下去到它說安裝成功,71 秒。

腳本在這 71 秒裡依序做了四件事:裝編譯工具,裝 Node.js,裝 Git,最後才是 OpenClaw 本身。Node 裝進來的是 24.21,不是文件建議的 26,不過兩個都在支援範圍內。

下面是我量到的數字。

量什麼 結果
跑完官方安裝腳本 71 秒
硬碟多用掉 1.6 GB,其中 OpenClaw 本身 603 MB
設定精靈執行時佔的記憶體 大約 470 MB
核心程式啟動 2 分半後,整台機器多用的記憶體 大約 0.8 GB
啟動 6 分鐘後(中間多裝了 LINE 外掛) 大約 0.95 GB

記憶體那兩列是這篇最想讓你知道的事。量的時候它沒有接任何聊天軟體,也沒有設定模型,就只是開著。官方寫的最低需求是 1 GB,建議 2 GB 以上。照我量到的數字,1 GB 的機器會很吃緊,我會直接從 2 GB 起跳。

怕只是那一台的偶然,我又開了一台 2 核心、4 GB 的機器重做一次。安裝腳本這次是 58 秒。核心程式啟動兩分鐘後,整台機器多用了 0.85 GB,跟第一台差不多。

這個數字有兩個但書。第一,我是手動把核心程式開在前景量的。官方文件說,用 openclaw gateway install 裝成服務的時候,它會依主機大小調整記憶體上限,所以在小機器上實際的數字可能比較低。第二,我沒有 1 GB 的機器可以驗證它到底跑不跑得動。

硬碟的部分,官方寫大約需要 500 MB。那指的是 OpenClaw 自己。在一台全新的主機上,連同它幫你裝的 Node.js 和編譯工具,總共多了 1.6 GB。

有兩件事我沒測到。這種測試機沒有 systemd,所以 openclaw gateway install 直接回 No supported service manager detected,裝成背景服務那一步我沒辦法驗證。一般租來的 Ubuntu 主機有 systemd,不會遇到這個。另外我沒有放任何 AI 的金鑰進去,所以沒有真的跟它對話。

設定精靈會問什麼

安裝腳本最後會自動進入設定精靈。之後想重跑,指令是 openclaw onboard。我把畫面抓下來看了。

先講一件我原本沒料到的事:它有繁體中文。官方文件說精靈會跟著系統語系走,支援英文、簡體中文和繁體中文。我的測試機是英文環境,一開始看到的全是英文。把語系指定成繁體中文之後,開場就變成「你好 — 我是 OpenClaw,負責維護這套系統。我們開始設定吧。」

你的電腦如果本來就是繁體中文介面,應該直接會看到中文。想強制指定的話這樣下:

OPENCLAW_LOCALE=zh-TW openclaw onboard

不過在 2026.10.2 這一版,中文只翻了一部分。開場、安全提醒和偵測結果是中文,選模型供應商那幾個畫面還是英文。下面我照畫面上實際出現的文字寫。

第一個畫面是「安全免責聲明」,只有一句:OpenClaw 執行的 AI 代理程式擁有這台機器的實際存取權限,後面附安全指南的網址。接著問「你想如何開始?」,選項是「快速開始(建議)」和「自訂設定」。

第二題是英文的 What would you like to create?,選項是 One agent 和 A small team。第一次用,選一個助理就好。

接著它會自己找這台機器上有沒有現成的 AI 登入。我的測試機什麼都沒有,它顯示「未在此機器上偵測到既有 AI 存取方式」,然後在「建議安裝」底下列出四個可以先去裝的東西:Ollama、LM Studio、Claude Code 和 Codex CLI。

再來是 Model/auth provider,也就是選模型的供應商。畫面上有 OpenAI、OpenRouter、xAI、Google、Anthropic,還有 More 和 Skip for now。

選 OpenAI 的話,下一層有四種登入方式。其中一種叫 Codex login (device code),後面註明是給遠端主機用的。它會給你一個網址和一組代碼,你在自己電腦的瀏覽器打開網址、輸入代碼就完成登入,代碼 15 分鐘後過期。也就是說,租來的主機沒有瀏覽器也沒關係。我只看到這個畫面為止,沒有真的登入。

模型還沒準備好的話,可以選 Skip for now。我選了一次,不到兩秒就結束。它建好工作區,把核心程式設成只有本機連得到,自動產生一組連線用的 token,最後顯示「一切就緒」和下一步的指令,其中一行是「稍後新增 AI:重新執行 openclaw onboard」。它不會幫你把核心程式開起來。

如果你是第二次跑精靈,它會多問幾題。其中一題是「幫助 OpenClaw 變得更好?」,問的是要不要回報你用了哪些功能,預設選的是「不用,謝謝」。

裝完怎麼確認

官方給了三個指令:

openclaw --version
openclaw doctor
openclaw gateway status

第一個確認指令有裝好。我這邊顯示的是 OpenClaw 2026.10.2 (b8952d4)。

第二個檢查設定有沒有問題。它在我那台 1 核心的機器上跑了 15 秒,吐出一百八十幾行。如果你跟我一樣還沒跑完設定精靈,裡面會有一行 gateway.mode is unset; gateway start will be blocked。

這行是認真的。我試著跳過精靈直接啟動核心程式,它拒絕啟動,訊息是 Gateway start blocked: existing config is missing gateway.mode。所以順序是先跑完設定精靈,再談啟動。就算在精靈裡選了 Skip for now 也算跑完,我那樣做之後核心程式就開得起來。

第三個確認核心程式有在跑。正常的話會看到 Connectivity probe: ok,還有它聽的位置 127.0.0.1:18789。前面那串數字代表只有這台機器自己連得到,這是預設值,也是比較安全的設定。

另外有一個我覺得值得順手跑的:

openclaw security audit --deep

它花了 7 秒,列出設定上的漏洞,分成 critical、warn、info 三級。我第一台因為跳過了精靈、沒有設連線驗證,被標了一個 critical。第二台照正常流程走完精靈,critical 是零個。

其他常用的指令,我另外整理成一篇OpenClaw 常用指令。

三個都過了,下一步是接一個聊天軟體。我的建議跟前一篇一樣:先開一個新的 Telegram 機器人來接,不要一開始就接你主要的通訊帳號。

選 Telegram 還有一個實際的理由。剛裝好的時候我看了頻道清單,Telegram 是內建的,LINE、WhatsApp、Discord、Slack 都顯示 not installed,要另外裝外掛。LINE 的外掛我裝了一次,指令是 openclaw plugins install @openclaw/line,36 秒裝完,正在跑的核心程式不用重開。接 LINE 還要準備哪些東西,寫在OpenClaw 怎麼接 LINE。

接上之後,陌生人傳訊息給你的機器人不會直接有回應。官方的預設是要先配對:對方會收到一組配對碼,你核准了它才會理他。看到機器人沒反應先不要慌,去控制台看有沒有等你核准的配對。

想在手機上用的話,OpenClaw 有官方的 iPhone 和 Android App,也是要跟你剛裝好的這台配對才能用,怎麼下載和配對整理在 OpenClaw App 怎麼下載。

這篇實測的是 2026.10.2,之後出新版時用 openclaw update 一行就能更新,我實際從 2026.10.2 更新到 2026.10.3 的過程在 OpenClaw 怎麼更新。

常見問題

Windows 可以裝嗎?一定要用 WSL 嗎?

可以。官方推薦先用 Windows Hub 這個桌面程式,支援 Windows 10 20H2 以上和 Windows 11,安裝不需要系統管理員權限。它會自己建一個專用的 WSL 環境來跑,你不用手動設定。這條我沒有實測,是照官方文件寫的。

OpenClaw 要多大的主機?1 GB 記憶體夠嗎?

官方寫的最低需求是 1 核心、1 GB 記憶體,建議 2 GB 以上。我在 2 GB 的機器上實測,還沒接任何聊天軟體,核心程式啟動後整台機器就多用掉 0.8 到 1 GB。1 GB 的機器我沒有測,但照這個數字會很吃緊,我會從 2 GB 起跳。

一定要用 Docker 嗎?

不用。官方文件明講 Docker 是選配,適合想要一個隔離、用完就丟的環境的人。平常就在自己電腦上工作的話,用一般的安裝方式就好。

關掉終端機之後它還會跑嗎?

快速開始那種跑法不會,它是跟著那個終端機視窗的。要它在背景一直開著,得再執行 openclaw gateway install 把它裝成系統服務。

這篇怎麼查證的

這篇只有一部分實際跑過,其餘依官方文件整理,查證日期 2026/10/12(OpenClaw 2026.10.2。Linux 那條在兩台雲端測試機上實際跑過(1 核心 2 GB、2 核心 4 GB,都是 Ubuntu 26.04);Windows、Mac、npm、Docker 依官方文件整理)。哪些有跑、哪些沒跑,文中各段有寫。價格與方案以官方頁面為準,工具改版後內容可能過期。