OpenClaw 在 Windows 2026 上的部署指南

1. 引言

這篇指南面向想在 Windows 平臺(tái)上部署 OpenClaw 的 AI 新手和入門開發(fā)者。OpenClaw 是一個(gè)開源 AI 開發(fā)框架，支持 AutoClaw 等多種國(guó)產(chǎn) AI 工具和技能。

本文覆蓋三種安裝方式：

1. Docker Desktop（推薦給新手）
2. WSL2 + Node/npm（推薦給日常開發(fā)者）
3. 原生 PowerShell 安裝（僅適用于快速驗(yàn)證）

三種方式各有取舍，下面逐一拆解。

2. 方法一：使用 Docker Desktop（新手首選）

Docker Desktop 提供開箱即用的開發(fā)環(huán)境，不需要手動(dòng)折騰系統(tǒng)配置，配合 WSL2 后端還能獲得不錯(cuò)的隔離性和性能。

步驟

1. 安裝 WSL2

以管理員身份打開 PowerShell，執(zhí)行：

wsl --install

這條命令會(huì)安裝默認(rèn)的 Linux 發(fā)行版（通常是 Ubuntu）。安裝完成后重啟計(jì)算機(jī)。

WSL2 讓 Windows 跑起一個(gè)真實(shí)的 Linux 內(nèi)核，Docker 容器依賴這個(gè)環(huán)境運(yùn)行。

2. 安裝 Docker Desktop

前往 Docker 官方網(wǎng)站 下載安裝程序，按提示完成安裝。

3. 配置 Docker 使用 WSL2 后端

打開 Docker Desktop 設(shè)置，確認(rèn) WSL2 已被選為默認(rèn)后端。這一步直接影響容器的運(yùn)行性能和兼容性。

4. 拉取 OpenClaw 鏡像

docker pull openclaw/openclaw:latest

5. 啟動(dòng)容器

docker run -d -p 8080:8080 --name openclaw openclaw/openclaw:latest

參數(shù)說明：-d 后臺(tái)運(yùn)行，-p 8080:8080 將容器端口映射到宿主機(jī)，--name openclaw 指定容器名稱。

驗(yàn)證

瀏覽器訪問 http://localhost:8080，出現(xiàn) OpenClaw 歡迎頁即為成功。

常見問題

• 端口被占用：把映射端口改掉，比如 -p 8081:8080。
• 容器啟動(dòng)失敗：檢查 WSL2 是否正確安裝，以及 Docker Desktop 設(shè)置里后端是否已切換到 WSL2。

3. 方法二：使用 WSL2 + Node/npm（開發(fā)主力推薦）

如果需要更細(xì)粒度的控制，或者 OpenClaw 只是日常開發(fā)工具鏈的一部分，直接在 WSL2 的 Linux 環(huán)境里跑 Node.js 是更合適的選擇。

步驟

1. 安裝 WSL2（同上）

2. 安裝 Node.js 和 npm

在 WSL2 終端里執(zhí)行：

curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

這里安裝的是 Node.js 16.x，即 OpenClaw 當(dāng)前要求的版本。

3. 驗(yàn)證安裝

node -v
npm -v

兩條命令都能正常輸出版本號(hào)，說明安裝沒問題。

4. 全局安裝 OpenClaw

npm install -g openclaw

-g 全局安裝后，openclaw 命令在任意目錄下都可以直接調(diào)用。

5. 啟動(dòng) OpenClaw

openclaw start

驗(yàn)證

瀏覽器訪問 http://localhost:8080，出現(xiàn)歡迎頁即為成功。

常見問題

• 權(quán)限報(bào)錯(cuò)：命令前加 sudo 重試。
• 版本不兼容：用 node -v 確認(rèn)版本，OpenClaw 目前要求 Node.js 16.x。

4. 方法三：原生 PowerShell 安裝（快速驗(yàn)證）

只想快速跑通 OpenClaw 的基本功能、不打算長(zhǎng)期維護(hù)這套環(huán)境，用 Chocolatey 裝是最省事的。

步驟

1. 安裝 Chocolatey

以管理員身份打開 PowerShell，執(zhí)行：

Set-ExecutionPolicy Bypass -Scope Process -Force; `
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; `
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

2. 安裝 OpenClaw

choco install openclaw

3. 啟動(dòng) OpenClaw

openclaw start

驗(yàn)證

瀏覽器訪問 http://localhost:8080，出現(xiàn)歡迎頁即為成功。

常見問題

• 權(quán)限問題：PowerShell 必須以管理員身份運(yùn)行，否則 Chocolatey 無法正常工作。
• 網(wǎng)絡(luò)問題：安裝過程中如果下載失敗，換個(gè)網(wǎng)絡(luò)環(huán)境或配置代理再試。

5. 結(jié)論與下一步

三種方式的定位很清晰：新手用 Docker Desktop，省心；日常開發(fā)用 WSL2 + Node/npm，靈活；只是驗(yàn)證功能用 PowerShell + Chocolatey，快。

部署完成后，建議繼續(xù)深入以下方向：

• 創(chuàng)建和管理 OpenClaw 技能（Skills）
• 本地化調(diào)試流程
• 集成國(guó)產(chǎn) AI 工具

參考資源：

• OpenClaw 官方文檔
• 國(guó)產(chǎn) AI 工具集成指南