浪花科技 Roamer Tech浪花科技 Roamer Tech
免費 30 分鐘諮詢 ↗
浪花科技/Windows 也養得起龍...CUSTOM SYSTEMS + AI
AI 自動化與智慧應用 · · 更新於

Windows 也養得起龍蝦:OpenClaw 本機部署實戰,WSL2、原生與 Docker 四條路怎麼選(2026)

Eric,浪花科技創辦人 / AI 架構師
浪花科技創辦人 · AI 架構師
Windows 也養得起龍蝦:OpenClaw 本機部署實戰,WSL2、原生與 Docker 四條路怎麼選(2026)
☰ 目錄
字體大小

週五晚上十一點,同事在 Slack 丟來一句「OpenClaw 你玩過沒」。點開 GitHub,三十九萬多顆星,專案說明寫著 Any OS. Any Platform. The lobster way.。然後你看一眼手邊的工作機:Windows 11。翻了七八篇教學,清一色 macOS 跟 Linux,輪到 Windows 就只留一句「建議使用 WSL2」,然後沒了。

我們幫客戶評估這隻小龍蝦時,把 Windows 上的安裝路徑全部實際走過一遍。到 2026 年 11 月,Windows 已經不再是二等公民:官方文件把 Windows Hub 原生應用程式列為預設選項,另外還有 Tauri 桌面版當備案、PowerShell 原生 CLI、WSL2 Gateway,再加上 Docker。只想在午休時間玩玩,Hub 或原生 CLI 最快;但如果目標是讓它 24 小時掛著、接一堆 Linux 工具鏈、還要能長期維護,WSL2 仍然是官方口中「最貼近 Linux」的一條。原生 Windows 那條路在 2026.2.19 之前出過兩個排程任務的命令注入漏洞,這件事會直接影響到怎麼選,等一下會細講。

2026 年 11 月更新重點(查證於 2026 年 11 月 6 日):

  • Node.js 門檻改成 24.16 以上(24 版)或 26.1 以上,舊文常寫的 Node 22、25 已不在支援範圍;官方強烈建議 24.22.1 或 26.12.1 以上。
  • Windows Hub 成為官方預設的桌面選項,新增 Tauri 桌面版當跨平台備案。
  • WSL2 開機自動啟動改用「WSL Boot」排程任務搭配 dbus-launch,用來避開 WSL 2.6.1.0 之後會把閒置 distro 關掉的問題。
  • 本機從原始碼建置 Docker 映像檔至少要 6 GB 記憶體,直接用官方預建映像檔就沒有這個門檻。
  • 最新正式版 2026.11.1(11 月 5 日)修好「Windows 更新驗證失敗後 Gateway 起不來」的問題。

如果你還不確定 OpenClaw 到底是什麼、跟一般聊天機器人差在哪,建議先看 OpenClaw 是什麼 這篇打底再回來動手。用 Linux 的讀者可以直接跳到姊妹篇 OpenClaw Linux 安裝指南,那邊的環境單純很多。

Windows 上跑 AI agent,四條路該選哪一條?

在 Windows 跑 OpenClaw,長期常駐選 WSL2,快速上手選 Windows Hub 或原生 CLI。

先把選擇攤開。決定走哪一條的,通常是「要玩多久、要接多少東西」這兩個問題,跟技術程度關係不大。Tauri 桌面版的定位是 Hub 不合用時的備案,所以下表把重點放在四條主要的路:

路徑 安裝難度 Linux 相容性 24 小時常駐 適合誰
Windows Hub(官方預設) 最低,免管理員權限 不適用,可代為設定 WSL Gateway 可,系統匣常駐 只想有個圖形介面、快速上手
原生 CLI(PowerShell) 低,一行指令 低,Windows 路徑與權限模型差異大 可,走 Windows 排程任務 快速試玩、不碰 Linux 工具
WSL2 Gateway 中,要開 systemd 最高,官方定位為最貼近 Linux 的執行環境 可,走 systemd 服務 長期使用、會接大量 CLI 工具
Docker(Docker Desktop) 中高,要理解掛載與網路 高,容器內就是 Linux 可,restart 政策託管 想要環境隔離、之後要搬上伺服器

幾個實務判斷可以幫忙收斂。想要一個能長期演進的環境,WSL2 是預設答案,因為 agent 一整天都在讀寫檔案、呼叫指令,Linux 的檔案權限模型跟工具鏈會少掉非常多摩擦。想要環境乾淨、將來可能整包搬到公司伺服器,就直接走 Docker,容器化這步遲早要做,早做早輕鬆,這條路的延伸可以參考 企業級部署與多租戶架構。單純想確認這東西值不值得投入時間,Hub 或原生 CLI 花五分鐘試玩最快,只是別讓它就這樣掛著跑一年。

Windows Hub 值得單獨提一下。它是一個 WinUI 的原生應用程式,支援 Windows 10 20H2 以上與 Windows 11,有 x64 與 ARM64 的簽章安裝檔,最貼心的是安裝不需要管理員權限,公司電腦被 IT 鎖住權限的人可以用這條路。它同時扮演系統匣狀態列、聊天介面與診斷面板,也能作為 node 模式接進整個 Gateway 體系,甚至替你建一個由 Hub 管理的 WSL Gateway。要注意 Hub 的版本是獨立發布的,正式版 OpenClaw 綁的 Hub 可能會比最新版落後一點。

先問兩件事:要玩多久?要不要接 Linux 工具鏈?

  • 官方預設Windows Hub

    難度:最低,常駐:系統匣

    想要有介面、快速上手
  • PowerShell 一行原生 CLI

    難度:低,常駐:排程

    午休試玩、不碰 Linux
  • 最貼近 Linux|踩坑最少WSL2 Gateway

    難度:中,常駐:最穩

    長期掛著、接 Linux 工具
  • 容器隔離Docker

    難度:中,常駐:可

    要乾淨環境、多版本並存

$ openclaw install --which-path

四條路的決策不看技術程度,看「要玩多久、要接多少 Linux 工具」。長期常駐選 WSL2,快速上手選 Windows Hub 或原生 CLI。

動手之前,要先備好什麼?

在 Windows 裝 OpenClaw 前,先確認 Windows 版本,Node 要 24.16.0 以上,或 26.1.0 以上。

先確認 Windows 版本。開 PowerShell 執行 winver,看組建號碼。WSL2 需要 Windows 10 組建 19041 以上或 Windows 11;如果打算走 Windows Hub,門檻是 Windows 10 20H2 以上。低於這個數字,先去把系統更新做完再回來,不然後面每一步都會卡。

接著是 Node.js,這是 2026 下半年改最多的地方。官方現在的門檻是 24 版要 24.16.0 以上,或 26.1.0 以上,並強烈建議為了資安用 24.22.1 或 26.12.1 以上。7 月時還能用的 Node 22 與 25 已經不在支援範圍,網路上舊教學寫的版本照裝會在啟動階段報錯。另一個經典陷阱:Ubuntu 預設套件庫裡的 Node 版本通常太舊,sudo apt install nodejs 裝完會發現根本過不了門檻。要嘛用 NodeSource 的套件庫,要嘛用 nvm,或者乾脆讓官方的 install.sh 腳本代勞,它在 Linux 上偵測到沒有 Node 時會裝好 Node 24 LTS。

硬體方面官方沒有給出整體的記憶體與磁碟需求,唯一有明文的數字來自 Docker 文件:在本機從原始碼建置映像檔至少要 6 GB 記憶體,直接拉官方預建映像檔就沒有這個門檻。實務上我們建議機器留 8 GB 以上的可用記憶體會舒服很多,畢竟 WSL2 本身就會吃掉一塊。

  • 19041WSL2 需要的 Windows 10 組建以上或 Windows 11
  • 20H2Windows Hub 的門檻Windows 10 20H2 以上
  • 6 GB本機從原始碼建置映像檔至少要用官方預建映像檔就沒有這個門檻
  • 8 GB我們建議留的可用記憶體

啟用 WSL2

用系統管理員身分開 PowerShell,一行指令搞定:

wsl --install

# 想指定發行版就用這行
wsl --install -d Ubuntu-24.04

裝完重開機。這時候有個很多人漏掉的關鍵步驟:WSL2 預設不會啟用 systemd,而 OpenClaw 的常駐服務要靠 systemd 託管。進到 Ubuntu 裡面把它打開:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

回到 PowerShell 讓 WSL 完全關閉再重啟,設定才會生效:

wsl --shutdown

OpenClaw 在 WSL2 上怎麼裝起來?

在 WSL2 安裝 OpenClaw 反而是最短的一段;要它常駐,得補上 enable-linger 與 WSL Boot 排程任務。

環境備好,安裝反而是最短的一段。在 Ubuntu 裡執行官方安裝腳本:

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

這支腳本會偵測作業系統、必要時裝好 Node、安裝 OpenClaw,然後直接進入 onboarding 流程。如果是在 CI 或自動化情境不想被互動流程打斷,改用下面這行跳過:

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

習慣自己管 Node 的人,走 npm 這條也可以。注意新版文件多了一個參數,npm 11.15 以前的版本要把 --allow-scripts=openclaw 拿掉:

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

openclaw onboard --install-daemon 會依平台安裝對應的常駐機制:macOS 用 LaunchAgent、Linux 與 WSL2 用 systemd 使用者服務、Windows 原生則先建排程任務,建不了才退回「啟動」資料夾的登入項目。

  • macOS

    LaunchAgent

  • Linux 與 WSL2

    systemd 使用者服務

  • Windows 原生

    先建排程任務

    建不了才退回「啟動」資料夾的登入項目

讓它在 WSL2 裡真的常駐

WSL2 是無頭環境,還要補兩件事,daemon 才不會在登出後被收掉:

sudo apt-get install -y dbus-x11
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install

enable-linger 是關鍵。沒有它,使用者 session 一結束,systemd 就會把服務一起清掉。設好之後 distro 開機時服務會自動跟上。

最後一哩是讓 WSL 的 distro 本身跟著 Windows 開機啟動,這段官方做法在下半年改過。現在的建議是在 Windows 建一個「WSL Boot」排程任務,開機時用你自己的帳號執行:

wsl.exe -d Ubuntu-24.04 --exec dbus-launch true

用 dbus-launch true 而不是單純的 true,是因為 WSL 2.6.1.0 之後有個會把閒置 distro 自動關掉的問題,服務起來沒多久就跟著停。另外別把任務設成以 SYSTEM 身分執行,那樣啟動不了個人帳號底下的 distro。設好後在 WSL 裡用 systemctl --user 確認服務真的在跑。

原生 Windows 與 Docker 的裝法

如果決定走原生 CLI,在 PowerShell 執行:

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

openclaw --version
openclaw doctor
openclaw gateway status --json

裝服務並確認狀態。要註冊開機自動執行的排程任務,記得用「系統管理員」開終端機、而且用之後實際要跑服務的那個帳號;排程任務採 S4U 身分,不會存你的密碼:

openclaw gateway install
openclaw gateway status --json

openclaw doctor 這支很好用,環境有缺什麼它會直接指出來,卡住的時候第一個先跑它。

Docker 這條路,官方映像檔放在 GitHub Container Registry,也有 Docker Hub 鏡像:

# GHCR(主要)
ghcr.io/openclaw/openclaw:latest

# Docker Hub 鏡像
openclaw/openclaw:latest

官方推薦用倉庫裡的腳本啟動,它會處理映像檔建置或拉取、onboarding、設定與 compose 啟動:

./scripts/docker/setup.sh

docker compose up -d openclaw-gateway
docker compose run --rm openclaw-cli dashboard --no-open

第一次啟動,有哪些設定要先搞定?

OpenClaw 的模型現在可以直接用訂閱登入,不一定要另外申請 API 金鑰。

onboarding 流程會引導完成模型供應商設定、連線驗證,並保留先前選過的選項。

模型這塊選擇比想像中多。官方內建的供應商包含 OpenAI、Anthropic、Google Gemini、DeepSeek、Mistral、OpenRouter 等數十家,而且現在可以直接用訂閱登入:ChatGPT/Codex 訂閱走 OpenAI 的登入流程,Claude 訂閱則可以重用本機的 Claude CLI,不一定要另外申請 API 金鑰。想要資料完全不出本機的人,可以接本機跑的 Ollama,代價是模型能力跟雲端有落差,agent 的工具呼叫穩定度會直接反映出來。

  • 官方內建雲端供應商

    OpenAI、Anthropic、Google Gemini、DeepSeek、Mistral、OpenRouter 等數十家

  • 直接用訂閱登入ChatGPT/Codex、Claude

    Claude 訂閱則可以重用本機的 Claude CLI

  • 資料完全不出本機本機跑的 Ollama

    代價是模型能力跟雲端有落差

接著確認 Gateway 狀態:

openclaw gateway status --json
openclaw doctor

Gateway 是整個系統的本機控制面,所有 node(手機、桌面 app、CLI)都透過它配對與溝通。從 7 月的 v2026.7.1 起,反覆失敗的 Gateway 不再無限重啟,而是留下一條穩定的修復路徑,除錯時不用再跟無窮迴圈的 log 搏鬥。

拿到儀表板網址就可以開始對話。想理解 agent 怎麼從單純對話變成能真的完成工作的流程,agentic workflow 實戰 那篇拆得比較細。

怎麼幫龍蝦接上 MCP,讓它真的能動手?

OpenClaw 的 MCP 指令 list、status 不會真的連線;要驗證 MCP 連得上,用 openclaw mcp probe。

裝完只能聊天的話,那跟開網頁版沒兩樣。讓 agent 具備實際能力的關鍵在 MCP,它是 agent 與外部工具之間的標準協定。還沒搞懂 MCP 跟 API、CLI 差在哪的話,MCP、API 與 CLI 的差異 這篇可以先補。

OpenClaw 用 openclaw mcp 這組子命令管理外連的 MCP server 定義。掛一個走 stdio 的本機 server:

openclaw mcp add memory \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-memory

接遠端的 HTTP server,順便處理 OAuth 與工具白名單:

openclaw mcp add docs \
  --url https://mcp.example.com/mcp \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope docs.read \
  --timeout 20 \
  --connect-timeout 5 \
  --include 'search,read_*'

add 預設會先探測再存檔,除非加上 --no-probe,或需要先完成 OAuth 授權。

幾支日常會用到的:

openclaw mcp list
openclaw mcp status --verbose
openclaw mcp probe
openclaw mcp doctor --probe
openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'

有個容易誤會的地方要講清楚:list、show、set、unset 這些指令只是在讀寫設定檔裡的 mcp.servers 區段,它們不會真的連線去驗證 URL 或指令對不對。status 也只做傳輸層分類而不連線,doctor 預設是靜態檢查。真的要驗證連得上,用 openclaw mcp probe(會列出每個 server 的工具數量與診斷),或在 doctor 後面加 --probe。設定看起來一切正常但工具叫不動的時候,先想到這件事。

只讀寫設定,不連線

  • list、show、set、unset
  • status 只做傳輸層分類
  • doctor 預設是靜態檢查

真的會連線驗證

  • openclaw mcp probe
  • doctor 後面加 --probe
  • add 預設會先探測再存檔

--include 的工具白名單建議一開始就用起來,之後要調整用 openclaw mcp tools。一個 MCP server 動輒暴露幾十個工具,全開會稀釋模型的判斷力,該呼叫 A 的時候它挑了 B。只開真正需要的那幾個,準確率會明顯改善。想把多個 agent 串起來互相協作的話,A2A 協定與多代理互通 是下一步。至於把 agent 接進實際商業流程長什麼樣,WooCommerce 自動庫存同步 跟 一人 AI 工廠 有完整案例。

在自己電腦跑 agent,風險藏在哪裡?

OpenClaw 原生 Windows 安裝出過兩個命令注入漏洞,光升版不夠,2026.2.19 之前的批次檔要重新產生。

這段請不要跳過。一個能讀寫檔案、執行指令、連外部服務的東西跑在工作機上,本質上就是一個擁有你全部權限的程式,還會照著自然語言指示行動。

先講最硬的事實。原生 Windows 安裝在 2026.2.19 之前有兩個命令注入漏洞,美國國家漏洞資料庫在 2026 年 3 月 18 日公告:CVE-2026-31994 是排程任務腳本產生時,對 cmd 特殊字元與換行字元處理不當;CVE-2026-22176 則是環境變數以未加引號的 set KEY=VALUE 寫進 gateway.cmd,導致特殊字元可以跳脫賦值語境。兩者都讓本機攻擊者有機會在排程任務的執行脈絡裡塞進任意指令。

  • 排程任務CVE-2026-31994

    排程任務腳本產生時,對 cmd 特殊字元與換行字元處理不當

  • gateway.cmdCVE-2026-22176

    環境變數以未加引號的 set KEY=VALUE 寫進 gateway.cmd

再來是權限預設值。OpenClaw 把 screen.record、camera.snap、camera.clip 這類隱私敏感指令設計成必須在 gateway.nodes.allowCommands 明確開啟才會生效,node 指令也需要 Gateway 配對與政策允許。官方特別提醒:核准一台裝置連進來,不等於核准它能下哪些指令,這是兩道分開的關卡。這個保守預設是刻意的,不要因為某個教學說「先全開比較好測」就照做。

想再加一層,可以開沙箱,把工具執行隔離在臨時容器裡。沙箱預設是關的,官方文件給的最小設定長這樣:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main",
        "scope": "session",
        "workspaceAccess": "none"
      }
    }
  }
}

另外幾條基本紀律:API key 用環境變數管理,不要寫死進設定檔然後同步到雲端硬碟,也不要貼進 issue 或討論串;Gateway 遠端存取限制在 localhost 或走 HTTPS;agent 的工作目錄跟真正重要的專案資料夾分開放。這些在個人機器上聽起來像小題大作,一旦要進公司環境,權限邊界、稽核軌跡跟資料外洩防護就是硬性要求了,企業 AI agent 權限控管與 DLP 跟 agent 護欄設計實作 兩篇把這塊講得比較完整。

WSL2 上最常踩的雷有哪些?

WSL2 上的 OpenClaw 服務停掉多半是 systemd 或 linger;agent 變慢多半是檔案放在 /mnt/c。

把我們實際遇過、以及社群回報最密集的問題整理成一份除錯清單。

關掉終端機服務就停了

九成是 systemd 沒開,或 linger 沒設。回頭確認 /etc/wsl.conf 裡的 [boot] systemd=true,執行過 wsl --shutdown,以及 sudo loginctl enable-linger "$(whoami)" 有沒有跑。三者缺一就會出現這個症狀。如果是放著一陣子才停,多半是前面講的 WSL 閒置關閉問題,改用 dbus-launch true 的開機任務。

  • /etc/wsl.conf 裡的 [boot] systemd=true
  • 執行過 wsl --shutdown
  • sudo loginctl enable-linger "$(whoami)" 有跑

agent 慢到像在跑檔案總管

檔案放在 /mnt/c 底下了。Windows 與 Linux 之間的跨檔案系統存取非常慢,而 agent 整天都在讀寫檔案,這個成本會被放大到很有感。把工作檔案全部搬進 Linux 家目錄(~),速度立刻回來。這條規則沒有例外,值得在第一天就養成習慣。

▼ 慢到像在跑檔案總管

  • 檔案放在 /mnt/c 底下
  • Windows 與 Linux 之間的跨檔案系統存取非常慢

▲ 速度立刻回來

  • 工作檔案全部搬進 Linux 家目錄(~)
  • 這條規則沒有例外

Node 版本過不了門檻

sudo apt install nodejs 裝到的通常是舊版,照 7 月以前的教學裝 Node 22 也會被擋。用 NodeSource 或 nvm 換成 24.16 以上(建議 24.22.1 以上)或 26.1 以上的版本。

更新之後 Gateway 起不來

原生 Windows 的使用者最常遇到。官方文件註明 2026.9.4 發布的 Windows 更新程式在資料結構升級時有已知問題,並附上手動升級步驟;11 月 5 日的 2026.11.1 也修好了「更新驗證失敗、或更新程式當掉被取消後,Gateway 卡住起不來」的情況。遇到時先跑 openclaw doctor,再照官方 Windows 頁面的手動升級步驟處理。

容器起來就死,exit code 137

137 是被 OOM 砍掉。在本機從原始碼建置映像檔至少需要 6 GB 記憶體,改拉官方預建映像檔就能避開;Docker Desktop 在 Windows 上的記憶體上限受 WSL2 設定牽制,可以在 %UserProfile%\.wslconfig 裡調整。也順手用 docker logs openclaw 確認一下不是缺 API key 或連接埠衝突。

容器裡連不到主機上的服務

容器內的 127.0.0.1 指的是容器自己,不是 Windows 主機。要連主機服務請改用 host.docker.internal,而且主機上的服務要聽在 Docker 連得到的位址,例如 Ollama 要設 OLLAMA_HOST=0.0.0.0:11434。這個誤會每個人都會犯一次。

重開機後區網裝置連不上

WSL 的 IP 位址在重啟後會變動,把服務曝露到區網時這點會反覆咬人。另外 Docker bridge 網路常常不轉發 Bonjour/mDNS 多播,內建的 Bonjour 外掛偵測到自己在容器裡會自動停用區網廣播(可用 OPENCLAW_DISABLE_BONJOUR 覆寫),靠自動探索找裝置的功能在容器裡不要期待太高。

手機 app 配對不上

遠端網頁聊天需要 HTTPS 或 localhost 存取,純 HTTP 的區網位址會被擋。先確認 Gateway 狀態與配對政策,openclaw doctor 通常能指出問題。

不想自己養龍蝦?訂閱一隻現成的

只要 OpenClaw「龍蝦能用」、不想自己安裝維運,還有另一條路:訂閱代管版。

看到這裡如果覺得「光是選路就頭大」,這反應很正常。這篇從頭到尾都在講自架的代價:選對安裝路徑、開 systemd、補漏洞、對付重開機後跑掉的 WSL IP,還有每隔幾個月就改一次的 Node 門檻與開機設定。這些是自己養一隻本機龍蝦的日常,玩得起來很有成就感,但要它 24 小時穩定替你工作,維運是一條長路。

如果你要的只是「龍蝦能用」而不是「我要自己會裝龍蝦」,還有另一條路:訂閱代管版。我們自己的 RoamerHost OpenClaw 託管服務把上面整篇的維運都收走了:獨立容器、自動 SSL、每日備份、24 小時監控,訂閱後直接用,不用碰 Windows 也不用碰指令。自架與訂閱怎麼選,跟我們在 VPS 是什麼 裡談的「自己管主機 vs 找人代管」是同一個判斷:看你要的是控制權,還是省事。

比較Windows 本機自架RoamerHost 訂閱
上手時間半天到一天(含踩坑)幾分鐘
維運責任更新、漏洞、備份全自己來平台負責
資料掌控完全在自己電腦獨立容器隔離
適合誰想學、想完全掌控、電腦夠力只想用、要穩定常駐

資料來源

本文版本號、指令、系統需求與漏洞資訊查證於 2026 年 11 月 6 日,以官方倉庫與官方文件為準(初版查證於 2026 年 7 月 17 日)。OpenClaw 更新頻率極高(最新正式版 2026.11.1 發布於 2026 年 11 月 5 日),實際操作前建議再對一次官方文件。

延伸閱讀

把玩具變成生產力,中間還有一段路

AI agent 進到公司環境,權限、客戶資料與稽核軌跡的問題不會因為安裝順利就自動消失。

在自己電腦把龍蝦養起來是一回事,讓公司流程真的敢用它是另一回事。個人機器上,權限開太大最多是自己承擔;到了公司環境,agent 要接 ERP、要碰客戶資料、要留稽核軌跡、要能回答「上週三下午它到底改了什麼」,這些問題不會因為安裝順利就自動消失。

我們自己也在做 AI 產品:Ocean Bot 業務助理、玄燈命理 DestineAI、PiMe AI 形象照,以及陪跑者 PACER 這個 AI 原生官網,都收在作品案例裡,可以看看落地之後實際長什麼樣。

OpenClaw 系列延伸閱讀

不熟 OpenClaw 的話,建議先看 OpenClaw 是什麼?完整解析。同類文章:

常見問題

OpenClaw 現在還有在維護嗎?版本怎麼看?
有,而且更新非常密集。我們在 2026 年 11 月 6 日查證時,最新正式版是 2026.11.1,發布於 11 月 5 日,前一個正式版 2026.10.10 在 11 月 3 日,另有 2026.11.5-beta.1 測試版。專案採「年.月.序號」的日期式版本號,GitHub 上約 39 萬顆星。看到日期式版本號不要誤會成停更,那只是它的命名規則。
Windows 一定要裝 WSL2 才能跑 OpenClaw 嗎?
不用。官方文件目前把 Windows Hub 原生應用程式列為預設選項(支援 Windows 10 20H2 以上與 Windows 11,安裝不需要管理員權限),另有 Tauri 桌面版當備案、PowerShell 原生 CLI、WSL2 Gateway,以及 Docker。只想快速上手,Hub 或原生 CLI 最快;打算長期掛著跑、會用到大量 Linux 工具鏈,WSL2 仍是官方說的最貼近 Linux 的執行環境。
Node.js 要裝哪個版本?Ubuntu 內建的可以嗎?
官方現在的門檻是 24 版要 24.16.0 以上,或 26.1.0 以上,並強烈建議用 24.22.1 或 26.12.1 以上;Node 22 與 25 已不在支援範圍。Ubuntu 預設套件庫的 Node 通常太舊,建議改用 NodeSource 或 nvm。用官方 install.sh 腳本的話,它在 Linux 上偵測到沒有 Node 會自動裝好 Node 24 LTS。
在自己電腦跑 AI agent,最該擔心什麼?
最該擔心的是它握有的權限比想像中大。OpenClaw 預設會把 screen.record、camera.snap、camera.clip 這類隱私敏感指令擋下來,要在 gateway.nodes.allowCommands 明確開啟才會生效,而且核准裝置連線不等於核准它能下的指令。另外原生 Windows 安裝在 2026.2.19 之前有兩個排程任務的命令注入漏洞(CVE-2026-31994 與 CVE-2026-22176),升級之後還必須重新產生 gateway.cmd,光升版不夠。
WSL2 裝好了,為什麼關掉終端機 agent 就停了?
最常見三個原因。第一是 WSL2 預設沒有啟用 systemd,要在 /etc/wsl.conf 寫入 [boot] systemd=true 再執行 wsl --shutdown。第二是沒有開啟 linger,要執行 sudo loginctl enable-linger "$(whoami)"。第三是 WSL 2.6.1.0 之後會把閒置的 distro 關掉,官方建議建一個開機時以自己帳號執行 wsl.exe -d <distro> --exec dbus-launch true 的排程任務。都設好再用 openclaw gateway install 安裝服務。
#OpenClaw #WSL2 #Windows #AI Agent #Docker #MCP #本機部署

訂閱免費電子報

把 AI 自動化、企業系統設計與 WordPress / Laravel 開發的真實案例和可直接照做的技巧,整理成電子報寄給你。只寄精選內容、不灌垃圾信,一鍵就能退訂。

⑂ mainWindows 也養得起龍...Ln 1UTF-8