相比 Mac 和 Linux，Windows 安装 OpenClaw 的过程多了几道门槛——因为 OpenClaw 的核心架构基于 Unix 环境构建，Windows 原生系统缺少必要的系统级工具支持。但这并不意味着 Windows 用户就没有办法，本文提供三条路径，从最推荐到最简单依次介绍，帮你找到最适合自己的方案。

安装前必读：Windows 上的三条路径

安装方式 难度 稳定性 功能完整度 耗时
WSL2 + npm（官方推荐） ★★★☆☆ ⭐⭐⭐⭐⭐ 100% 约20～30分钟
PowerShell 原生安装 ★★☆☆☆ ⭐⭐⭐☆☆ 约80% 约10分钟
Docker Desktop 容器 ★★★★☆ ⭐⭐⭐⭐⭐ 100% 约30～45分钟

官方文档明确指出：WSL2 是 Windows 上运行 OpenClaw 最稳定、功能最完整的方式，强烈建议选择此路径。PowerShell 原生安装存在已知的后台服务 bug（GitHub #10933、#41804），且部分功能（如 /restart 命令、systemd 服务管理）在原生 Windows 上无法正常工作。

系统要求确认

开始之前，先确认你的 Windows 满足以下条件：

  • 操作系统：Windows 10 Build 19041 或以上，或 Windows 11（任意版本）
  • 内存：最低 4GB RAM，推荐 8GB 或以上
  • 处理器：需支持虚拟化技术（Virtualization）——大多数2018年后的 CPU 均支持
  • 存储：至少预留 5GB 可用空间（WSL2 系统 + OpenClaw 本体）

查看 Windows 版本：按 Win + R，输入 winver，按回车，即可看到版本号和内部版本号。

路径一：WSL2 安装（官方推荐，功能最完整）

第一步：启用 WSL2

以管理员身份打开 PowerShell（右键点击开始按钮 → 选择”终端（管理员）”或”PowerShell（管理员）”），运行以下命令：

wsl --install

这一条命令会自动完成：启用 WSL 功能、安装虚拟机平台、下载并安装 Ubuntu（默认 Linux 发行版）。

如果系统提示 WSL 已安装，运行以下命令确认版本为 WSL2：

wsl --set-default-version 2
wsl --version

安装完成后，必须重启电脑。重启后，Ubuntu 会自动弹出初始化窗口。

第二步：配置 Ubuntu 初始账户

重启后，Ubuntu 终端会弹出，提示创建用户名和密码：

  • 输入一个用户名（建议用英文小写，如 yourname），按回车
  • 输入密码（输入时屏幕不显示字符，属正常现象），按回车
  • 再次输入密码确认

账户创建完成后，你就进入了 WSL2 的 Ubuntu 环境。

第三步：启用 systemd（让 OpenClaw 后台服务正常工作）

OpenClaw 依赖 systemd 来管理后台常驻服务。在 Ubuntu 终端中运行以下命令启用它：

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

然后在 PowerShell（Windows 侧）中重启 WSL：

wsl --shutdown

重新打开 Ubuntu 终端，验证 systemd 已启用：

systemctl --version

看到版本号输出即为成功。

第四步：安装 Node.js

在 Ubuntu 终端中运行以下命令安装 Node.js 22（OpenClaw 最低要求版本）：

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

验证安装：

node --version
npm --version

看到 v22.x.x 及以上版本即为成功。

第五步：安装 OpenClaw

在 Ubuntu 终端中全局安装 OpenClaw：

npm install -g openclaw@latest

验证安装：

openclaw --version

第六步：运行引导向导

openclaw onboard --install-daemon

引导向导会依次询问：

  1. 选择大模型提供商（Anthropic / OpenAI / 其他），用方向键选择，回车确认
  2. 粘贴对应的 API Key
  3. 选择默认模型（推荐 claude-sonnet-4-6）
  4. 配置工作区路径（直接回车使用默认值）
  5. 选择是否立即连接通讯平台（可跳过，稍后配置）

向导完成后会生成一个控制面板 URL，格式如下：

http://127.0.0.1:18789/#token=xxxxxxxxxxxxxxxx

⚠️ 重要：直接将这个完整 URL 复制到你的 Windows 浏览器（如 Edge 或 Chrome）中打开，即可访问控制面板。WSL2 没有图形界面，但 Windows 浏览器可以直接访问 WSL2 的本地端口，无需额外配置。

第七步：验证运行状态

在 Ubuntu 终端中运行：

openclaw doctor

所有项目绿色通过即表示安装成功。

💡 WSL2 重要提示：始终在 WSL2 的 Linux 原生目录下工作（如 /home/yourname/），而不是挂载的 Windows 目录（如 /mnt/c/Users/...）。在 Windows 目录下操作会导致文件读写速度显著下降，影响 OpenClaw 的运行效率。

路径二：PowerShell 原生安装（快速体验，功能有限）

如果你只是想快速体验 OpenClaw，不介意部分功能受限，可以直接在 PowerShell 中安装。

前提条件：先单独安装 Node.js，访问 nodejs.org 下载 Windows 安装包（选择 LTS 版本，22.x 或以上），安装完成后重启 PowerShell。

以管理员身份打开 PowerShell，运行：

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

或者使用 npm 直接安装：

npm install -g openclaw@latest
openclaw onboard --install-daemon

原生 Windows 安装的 --install-daemon 参数会尝试创建 Windows 计划任务（Scheduled Task）来实现开机自启，但存在以下已知问题：

  • 每次登录时会短暂弹出命令行黑窗口（GitHub #10933）
  • 网关崩溃后重启可能产生僵尸进程占用端口（GitHub #41804）
  • /restart 命令在 Telegram/Discord 中无法使用

⚠️ 安全提示：2026年3月披露的漏洞 CVE-2026-22176 影响 Windows 原生安装的计划任务机制，请务必安装 2026.2.25 或以上版本以获取安全补丁。WSL2 和 Docker 路径不受此漏洞影响。

路径三：Docker Desktop 容器安装（安全隔离，适合进阶用户）

Docker 容器方案将 OpenClaw 完全隔离在一个独立环境中运行，是安全性最高的 Windows 部署方式，同时也拥有 WSL2 路径同等的功能完整度。

前提：安装 Docker Desktop

访问 docker.com 下载并安装 Docker Desktop for Windows（版本 4.x 或以上），安装时勾选"使用 WSL2 后端"选项，完成后重启电脑。

拉取并运行 OpenClaw 容器

在 PowerShell 或命令提示符中运行：

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/home/openclaw/.openclaw \
  -v ~/openclaw/workspace:/home/openclaw/workspace \
  openclaw/openclaw:latest

首次运行会自动下载镜像（约几百 MB），下载完成后容器自动启动。在浏览器访问 http://127.0.0.1:18789 即可进入控制面板。

Docker 路径的优势是：所有 OpenClaw 的数据通过 Volume 挂载到宿主机，容器本身不存储任何数据，卸载时干净彻底；同时容器环境完全隔离，即便出现安全问题也不会直接影响 Windows 系统。

连接 Telegram（Windows 用户最推荐的通讯平台）

由于 Windows 版 OpenClaw 暂无 iMessage 支持，Telegram 是 Windows 用户最推荐的对接平台，配置流程如下：

  1. 在 Telegram 中搜索并打开 @BotFather
  2. 发送 /newbot，按提示输入机器人名称和用户名
  3. BotFather 会返回一个 Bot Token（格式如 1234567890:ABCDefGhIJKlmNoPQRsTUVwxyZ），复制保存
  4. 在 OpenClaw 控制面板的 Channels 页面，选择 Telegram，粘贴 Bot Token 完成绑定
  5. 在 Telegram 中找到你的机器人，发送第一条消息，看到回复即表示连接成功

常见问题排查

Q：运行 wsl --install 提示"不支持的版本"怎么办？
你的 Windows 10 版本低于 Build 19041。前往"设置 → Windows 更新"升级系统后重试。

Q：WSL2 安装后 Ubuntu 没有自动弹出怎么办？
在开始菜单中搜索"Ubuntu"，手动打开即可进行初始化。

Q：控制面板打开后显示"连接失败"怎么办？
在 Ubuntu 终端运行 openclaw gateway start 手动启动网关，然后刷新浏览器页面。如问题持续，运行 openclaw doctor 查看详细诊断信息。

Q：WSL2 重启后 OpenClaw 服务没有自动启动怎么办？
在 Ubuntu 终端运行 sudo systemctl enable openclaw 确保服务已注册为开机自启，然后运行 sudo systemctl start openclaw 手动启动。

Q：想更新 OpenClaw 到最新版本怎么操作？
在 Ubuntu 终端（WSL2 路径）运行：

openclaw update --channel stable

完成！开始你的第一次对话

部署成功并连接 Telegram 后，直接给你的机器人发消息试试：

  • "你好，你能帮我做什么？"
  • "帮我搜索今天的 AI 新闻摘要"
  • "明天下午2点提醒我开会"

想了解更多 Windows 专属配置和高级功能，可访问 OpenClaw官网中文版（通过浏览器翻译访问 openclaw.ai）或官方文档 docs.openclaw.ai/platforms/windows。

本文安装步骤基于 OpenClaw 官方文档、crewclaw.com、blink.new、gradually.ai 及 meta-intelligence.tech 等公开资料整理，信息截至2026年3月28日。具体步骤以官方最新文档为准。