OpenClaw LaunchOpenClaw Launch
← 首页

Windows 教程

OpenClaw Windows 安装完整教程

在 Windows 电脑上运行 OpenClaw AI智能体的两种方案 — WSL2 + Docker 自建，或通过 OpenClaw Launch 免安装一键部署。

OpenClaw 可以在 Windows 上运行吗？

可以。OpenClaw 是基于 Node.js 的开源AI智能体框架，运行在 Docker 容器中。Windows 本身不能直接运行 Docker Linux 容器，但有两种方式可以在 Windows 上使用 OpenClaw：

  • 方法一：WSL2 + Docker Desktop（本地自建） — 在 Windows 上启用 WSL2（Windows Subsystem for Linux 2），安装 Docker Desktop，然后像 Linux 一样运行 OpenClaw 容器。适合有技术背景、想完全掌控的用户。
  • 方法二：OpenClaw Launch（推荐，免安装） — 直接在浏览器中访问 OpenClaw Launch，可视化配置，10秒部署到云端。不需要在 Windows 上安装任何东西，AI机器人运行在云端服务器。

Windows 系统要求

如果你选择方法一（WSL2 + Docker），你的 Windows 电脑需要满足以下条件：

项目最低要求推荐配置
操作系统Windows 10 版本 2004（Build 19041）或更高Windows 11
内存（RAM）8GB16GB 或更多
硬盘空间10GB 可用空间20GB+ SSD
CPU支持虚拟化（VT-x / AMD-V）4核或更多
BIOS 虚拟化必须启用已启用
网络能访问外网（下载镜像、调用API）稳定的宽带连接

Windows 7 / 8 / 8.1 不支持 WSL2，无法通过此方法运行 OpenClaw。如果你使用旧版 Windows，推荐直接使用 OpenClaw Launch 免安装方案。

方法一：WSL2 + Docker Desktop 安装（自建）

这是在 Windows 本地运行 OpenClaw 的完整步骤。需要一定的命令行基础，预计耗时 1-3 小时。

1. 启用 WSL2

以管理员身份打开 PowerShell，执行 wsl --install 命令。这会自动启用 WSL2 和虚拟机平台功能，并安装默认的 Ubuntu 发行版。安装完成后需要重启电脑。重启后打开 Ubuntu 终端，设置用户名和密码。如果 wsl --install 报错，可能需要在"控制面板 → 启用或关闭 Windows 功能"中手动勾选"适用于 Linux 的 Windows 子系统"和"虚拟机平台"两个选项。

2. 安装 Docker Desktop for Windows

从 Docker 官网（docker.com）下载 Docker Desktop 安装包并安装。安装过程中确保勾选"Use WSL 2 instead of Hyper-V"选项。安装完成后启动 Docker Desktop，进入 Settings → Resources → WSL Integration，确认你的 Ubuntu 发行版已启用集成。验证安装：在 Ubuntu 终端中执行 docker --version，如果能正常输出版本号说明安装成功。

3. 拉取 OpenClaw 镜像

在 Ubuntu 终端（WSL2）中执行：docker pull ghcr.io/openclaw/openclaw:latest。这会下载最新版 OpenClaw 镜像，大约 500MB。国内用户如果下载速度慢，可以配置 Docker 镜像加速器（阿里云容器镜像服务提供免费加速）。在 Docker Desktop 的 Settings → Docker Engine 中添加 registry-mirrors 配置即可。

4. 创建配置文件

在 WSL2 的 Ubuntu 终端中执行：mkdir -p ~/.openclaw && nano ~/.openclaw/openclaw.json。配置文件是一个 JSON 文件，需要包含 models（AI模型提供商和API密钥）、channels（聊天平台配置，如 Telegram Bot Token）、plugins（插件启用设置）、agents（智能体参数）和 gateway（网关认证）等内容。注意路径区别：WSL2 中的 ~/.openclaw 对应 Windows 文件系统中的 \\wsl$\Ubuntu\home\你的用户名\.openclaw。你可以在 Windows 资源管理器中直接访问这个路径来编辑文件。

5. 启动容器

在 WSL2 终端中执行：docker run -d --name openclaw --restart unless-stopped -p 18789:18789 -v ~/.openclaw:/home/node/.openclaw --memory=2g --memory-swap=3g ghcr.io/openclaw/openclaw:latest node openclaw.mjs gateway --allow-unconfigured。关键参数说明：-d 后台运行，--restart unless-stopped 崩溃自动重启，-p 18789:18789 映射网关端口，-v 挂载配置目录，--memory=2g 设置内存限制（至少2GB，低于此值会OOM）。

6. 验证运行状态

执行 docker logs openclaw -f 查看实时日志，确认没有报错。如果看到 Gateway listening on port 18789 或类似信息，说明启动成功。在浏览器中访问 http://localhost:18789 可以打开网页聊天界面（需要在网关配置中启用）。如果要从外网访问（如 Telegram Webhook），还需要配置域名、HTTPS 和端口转发。

预计耗时：1-3小时，取决于你的 Windows 版本和网络速度。最常见的卡点是 WSL2 安装失败、Docker Desktop 启动问题和配置文件语法错误。

Windows 常见问题与解决方案

  • WSL2 安装失败："请启用虚拟机平台" — 进入 BIOS/UEFI 设置（开机时按 F2/F12/Delete），找到 Virtualization Technology 或 SVM Mode，设置为 Enabled。不同主板品牌的位置不同，可以搜索"你的主板型号 + 开启虚拟化"。
  • Hyper-V 冲突 — 如果你安装了 VMware 或 VirtualBox 等虚拟机软件，可能与 Hyper-V/WSL2 冲突。WSL2 需要 Hyper-V，某些旧版虚拟机软件不兼容。升级到最新版 VMware Workstation（16+）或 VirtualBox（6.1+）可以解决。
  • Docker Desktop 无法启动 — 确认 WSL2 已正确安装（powershell 执行 wsl --status）。如果仍然报错，尝试在 Docker Desktop 设置中切换到 WSL2 后端（而不是 Hyper-V 后端）。也可以尝试卸载重装 Docker Desktop。
  • Docker Desktop 内存占用过高 — 默认情况下 WSL2 会占用大量内存。创建文件 C:\Users\你的用户名\.wslconfig，内容为 [wsl2] 下一行 memory=4GB，限制 WSL2 最大内存使用。然后在 PowerShell 执行 wsl --shutdown 重启 WSL。
  • 文件权限问题 — WSL2 和 Windows 文件系统之间存在权限差异。OpenClaw 容器以 node 用户（uid 1000）运行。如果遇到权限错误，在 WSL2 终端中执行 chmod -R 777 ~/.openclaw 修复。
  • Windows 和 WSL2 的路径区别 — WSL2 中的 ~ 是 /home/你的用户名，对应 Windows 路径 \\wsl$\Ubuntu\home\你的用户名。从 Windows 编辑 WSL 文件可以直接在资源管理器地址栏输入 \\wsl$。反过来，WSL2 中访问 Windows 文件路径为 /mnt/c/Users/你的用户名。
  • 端口占用冲突 — 如果 18789 端口被其他程序占用，启动容器时可以改用其他端口，例如 -p 28789:18789，然后通过 http://localhost:28789 访问。
  • 国内网络问题 — 拉取 Docker 镜像和调用 AI 模型 API（OpenAI、Anthropic 等）可能需要代理。可以在 Docker Desktop 的 Settings → Resources → Proxies 中配置 HTTP 代理。

配置 HTTPS（可选，外网访问需要）

如果你只在本地浏览器使用 OpenClaw（http://localhost:18789），不需要 HTTPS。但如果要接入 Telegram Webhook 或从外网访问，就需要配置 HTTPS：

  1. 获取域名 — 在域名注册商购买一个域名，将 A 记录指向你的公网 IP。如果你在家用宽带后面，可能需要配置路由器端口转发，或使用内网穿透工具（如 frp、ngrok、Cloudflare Tunnel）。
  2. 安装反向代理 — 推荐在 WSL2 中安装 Caddy（自动申请和续签 SSL 证书）：sudo apt install caddy。配置 Caddyfile 将域名反代到 localhost:18789。
  3. 配置防火墙 — Windows 防火墙可能会阻止外部连接。打开 Windows Defender 防火墙，添加入站规则允许 443 端口（HTTPS）和 80 端口（HTTP，用于证书验证）。

注意：在家用宽带上配置 HTTPS 和公网访问相当复杂（动态 IP、运营商封端口、路由器配置等）。如果你只是想用 Telegram 机器人，强烈建议使用 OpenClaw Launch 跳过这些步骤。

方法二：OpenClaw Launch 免安装部署（推荐）

OpenClaw Launch 是 OpenClaw 的官方托管平台。不需要在 Windows 上安装任何东西 — 所有工作在浏览器中完成，AI机器人运行在云端服务器。

  • 零安装 — 不需要 WSL2、Docker、命令行。打开浏览器就能用
  • 可视化配置 — 不用手写 JSON，在界面中选择模型、平台、Skills
  • 10秒部署 — 点击部署按钮，AI机器人立刻上线
  • 自动 HTTPS — 无需配置域名、SSL证书、反向代理
  • 自动升级 — OpenClaw 新版本发布后自动更新，无需手动操作
  • 24/7运行 — 云端服务器永不关机，不受你 Windows 电脑开关机影响
  • 内置监控 — 仪表盘查看实例状态、日志、使用情况
  • $3/月起 — 支持支付宝、微信支付

OpenClaw Launch 部署流程

  1. 打开浏览器 — 在 Windows 上用任何浏览器（Chrome、Edge、Firefox）访问 openclawlaunch.com。
  2. 注册账号 — 支持 Google、GitHub 登录，或邮箱注册。
  3. 可视化配置 — 选择AI模型（Claude、GPT-4、Gemini、DeepSeek、Kimi 等），选择聊天平台（Telegram、Discord 或网页聊天），配置Skills和参数。所有选项都有中文说明。
  4. 一键部署 — 点击"部署"按钮，10秒内你的AI智能体就上线了。在 Telegram 或 Discord 中找到你的机器人开始对话。

对比：WSL2 + Docker vs OpenClaw Launch

WSL2 + Docker（自建）OpenClaw Launch（推荐）
安装难度需要启用 WSL2、安装 Docker Desktop、命令行操作无需安装任何东西
配置方式手写 JSON 配置文件（容易出错）可视化界面，点击选择
部署时间1-3小时（首次）10秒
Windows 版本要求Windows 10 2004+ / Windows 11任何版本（包括 Windows 7）
内存要求至少 8GB（WSL2 + Docker 占用大）无要求（运行在云端）
HTTPS / SSL需手动配置域名、证书、反向代理自动处理
24/7 运行电脑必须一直开着云端服务器，永不断线
升级维护手动拉取新镜像、重建容器自动升级
性能取决于你的电脑配置专业云服务器，稳定高速
费用免费（但需要电脑电费和时间成本）$3/月起，支持支付宝/微信支付
技术门槛需要命令行和 Docker 基础知识零基础即可使用
适合人群开发者、技术爱好者所有人

Windows 上管理 OpenClaw 的常用命令

以下命令均在 WSL2 的 Ubuntu 终端中执行（方法一用户适用）：

  • docker logs openclaw -f — 查看实时日志
  • docker restart openclaw — 重启 OpenClaw
  • docker stop openclaw — 停止运行
  • docker start openclaw — 重新启动
  • docker stop openclaw && docker rm openclaw — 停止并删除容器（卸载）
  • docker pull ghcr.io/openclaw/openclaw:latest — 更新到最新版本
  • docker stats openclaw — 查看 CPU 和内存使用情况
  • nano ~/.openclaw/openclaw.json — 编辑配置文件（保存后需重启容器）

如何升级 Windows 上的 OpenClaw

  1. 拉取最新镜像：docker pull ghcr.io/openclaw/openclaw:latest
  2. 停止并删除旧容器：docker stop openclaw && docker rm openclaw
  3. 用相同参数重新启动（使用步骤5中的完整 docker run 命令）

你的配置文件保存在 ~/.openclaw/ 目录中，不会因删除容器而丢失。OpenClaw Launch 用户无需手动升级，平台自动更新到最新版本。

常见问题 (FAQ)

Windows 7 可以安装 OpenClaw 吗？

Windows 7 不支持 WSL2，因此无法通过 Docker 在本地运行 OpenClaw。推荐使用 OpenClaw Launch 免安装方案 — 只需要一个浏览器，任何 Windows 版本都可以使用。或者考虑升级到 Windows 10/11。

OpenClaw 在 Windows 上需要多少内存？

WSL2 + Docker Desktop 本身就需要约 2-4GB 内存，OpenClaw 容器额外需要至少 2GB。因此建议至少 8GB 内存，16GB 更为理想。如果你的电脑内存不足，使用 OpenClaw Launch 是更好的选择，不占用本地资源。

不用 WSL2 可以在 Windows 上运行 OpenClaw 吗？

理论上可以通过 Docker Desktop 的 Hyper-V 后端运行，但 WSL2 是官方推荐的方式，性能更好、兼容性更强。另外你也可以在 Windows 上直接安装 Node.js 从源码运行 OpenClaw，但这种方式没有官方文档支持，可能遇到各种兼容性问题。最简单的方案是使用 OpenClaw Launch，完全不需要本地安装。

Windows 上运行 OpenClaw 性能和 Linux 比怎么样？

通过 WSL2 运行 Docker 的性能接近原生 Linux，通常差距在 5-10% 以内。主要瓶颈在于 WSL2 的文件系统 I/O（跨文件系统访问较慢）。对于 OpenClaw 这种以网络 API 调用为主的应用，性能差异基本可以忽略。但如果你的 Windows 电脑配置较低（4GB内存、老旧CPU），Docker + WSL2 的资源开销会比较明显。

电脑关机后 OpenClaw 还能运行吗？

不能。如果你使用 WSL2 + Docker 方案，OpenClaw 运行在你的电脑上，关机后就停止了。Telegram/Discord 机器人会离线。如果你需要 AI 机器人 24 小时在线，要么保持电脑不关机，要么使用 OpenClaw Launch — 机器人运行在云端服务器，永远在线。

跳过 Windows 安装，10秒部署

不需要 WSL2、Docker、命令行。在浏览器中一键部署你的 AI 智能体。

立即开始