很多人不是不会装 OpenClaw，而是一开始就走错了路

很多人第一次接触 OpenClaw，卡住的不是功能，而是安装。尤其在 Windows 环境里，一旦资料看杂了，很容易越装越乱。

>

这篇文章，我想给你一条更稳、更适合普通用户上手的路径：用 WSL2 和 Docker Desktop，把 OpenClaw 真正跑起来。

很多人第一次在 Windows 上安装 OpenClaw，卡住的，不是功能，也不是配置，而是 安装路径本身。

你随手一搜，面前立刻会冒出一堆词：

• WSL2
• Docker Desktop
• Linux 子系统
• 容器
• 镜像
• Gateway
• Onboarding

如果你原本就不是开发者，看到这里，心里大概率已经先乱了。

但这件事其实没有那么玄。

说到底，你只是要解决三个问题：

1. 给 OpenClaw 准备一个更稳定的运行环境
2. 让它在 Windows 上尽量少踩坑地跑起来
3. 把配置、数据、后续维护这件事一次理顺

如果从这个角度看，安装路径就会清晰很多。

我更建议普通用户走这样一条线：

Windows + WSL2 + Docker Desktop + OpenClaw 容器化部署

先说结论： 这不是 Windows 上唯一的安装方式，但它通常是更稳、更适合长期使用的一种方式。

如果你只是想快速试一下，原生 Windows 安装也可以。 但如果你更在意稳定性、兼容性、后续升级和数据管理，那么这条路线往往更省心。

这篇文章，就带你把这件事从头走通。

◆为什么我更建议你走这条路？

因为很多人装 OpenClaw，真正难的从来不是“命令不会敲”，而是：

• 装完不稳
• 环境混乱
• 出问题不知道从哪查
• 更新一次，前面的东西全乱了

而 WSL2 + Docker Desktop 这套组合，恰好是在解决这些问题。

它的好处很实际：

• 环境更隔离：不容易把 Windows 本身折腾乱
• 兼容性更好：很多 CLI / Gateway / Linux 相关能力更稳定
• 便于迁移：以后换机器、迁目录、重建环境都更清楚
• 数据更好管理：容器可以重建，但数据目录可以单独保留
• 更适合长期使用：不是只为了“装上”，而是为了“后面也省事”

你可以把它理解成一句话：

这条路线不一定是步骤最少的，但通常是后续返工最少的。

◆一、先准备底层环境：安装 WSL2

如果你之前没接触过 WSL，可以把它简单理解成：

Windows 里面的 Linux 环境。

为什么很多人会先装它？ 因为虽然 OpenClaw 支持 Windows，但从实际使用体验来看，在 WSL2 里跑很多东西，往往更稳。尤其涉及 CLI、服务、工具链时，这一点会很明显。

第一步：安装 WSL2

打开 PowerShell（管理员），执行：

wsl --install

这条命令会自动帮你完成 WSL 的基础安装，并默认安装 Ubuntu。

如果你想自己指定版本，也可以先看系统支持哪些发行版：

wsl --list --online

例如安装 Ubuntu 24.04：

wsl --install -d Ubuntu-24.04

如果执行后系统提示你重启，那就先重启，不要跳步骤。

第二步：初始化 Ubuntu

重启之后，第一次打开 Ubuntu 终端，系统会要求你设置：

• Linux 用户名
• Linux 密码

这里的密码后面会频繁用到。 比如你在 Linux 里执行 sudo 命令时，就要输入它。

这一步别敷衍。 很多人后面不是环境坏了，而是 自己把密码忘了。

第三步：确认 WSL 安装成功

回到 PowerShell 或 CMD，执行：

wsl --list --verbose

你应该能看到类似这样的结果：

  NAME            STATE           VERSION
* Ubuntu-24.04    Running         2

你最需要确认的是最后一列：

VERSION 必须是 2

如果不是，可以执行：

wsl --set-version Ubuntu-24.04 2

注意把 Ubuntu-24.04 换成你自己机器上的实际名称。

第四步：把 systemd 一起打开

这一步很多教程都不写，但如果你希望 OpenClaw 后面跑得更完整，最好别省。

在 WSL Ubuntu 终端 中执行：

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

然后回到 Windows PowerShell，执行：

wsl --shutdown

重新打开 Ubuntu，再执行：

systemctl --user status

如果没有明显报错，基本就说明 systemd 已经可用了。

到这一步，你的底层环境就算搭好了。

◆二、安装 Docker Desktop：让 OpenClaw 用容器方式跑起来

接下来要做的，就是把 OpenClaw 放进 Docker 容器里运行。

如果你以前没用过 Docker，也不用急着补全套概念。 你先记住一句最有用的话：

容器的意义，不是为了显得高级，而是为了让环境更可控。

对普通用户来说，容器化最大的价值通常不是“技术感”，而是：

• 好管理
• 好重建
• 好迁移
• 不容易把系统本身搞脏

第一步：安装 Docker Desktop

打开 Docker 官方安装页面： https://docs.docker.com/desktop/setup/install/windows-install/

安装过程中，建议注意两件事：

• 优先使用 WSL2 作为底层引擎
• 零基础用户先按默认设置装，不要一开始就折腾复杂路径迁移

很多人刚开始就想“我一定要把所有东西都装到 D 盘”“我一定要先做最优空间规划”。 结果 Docker 还没启动起来，自己先把自己绕晕了。

更现实的建议是：

先跑通，再优化。

第二步：确认 Docker 已经能用

安装完成后，启动 Docker Desktop，等它初始化结束。

然后在 PowerShell 或 CMD 中执行：

docker version

再执行：

docker info

如果能正常返回内容，说明 Docker 已经基本可用了。

第三步：配置镜像加速

对很多国内用户来说，Docker 最容易出问题的地方不是命令，而是：

镜像拉不下来，或者拉得极慢。

这时候可以在 Docker Desktop 里配置镜像加速。

打开：

• Settings
• Docker Engine

然后把配置调整成类似下面这样：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "features": {
    "buildkit": true
  },
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://mirror.ccs.tencentyun.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}

保存后点击：

Apply & Restart

这里顺手提醒一句： 镜像源不是越多越好。配置两三个常见的就够了，出了问题也更容易排查。

◆三、先把数据目录建好：别让容器一重建，数据也跟着没了

很多人刚开始装 Docker，只关注“能不能启动”，却忽略了一件更实际的事：

你的数据放哪？

容器本身可以删掉重建，但你的配置、记录、状态文件，最好不要随着容器一起消失。

所以，在正式启动 OpenClaw 之前，先在本地准备一个数据目录。

在 Windows CMD 中执行：

d:
cd \
mkdir openclaw_data
cd openclaw_data

这样你就会得到一个本地目录：

D:\openclaw_data

如果你没有 D 盘，也可以换成其他位置，比如：

C:\openclaw_data

这一步非常值得做。 因为后面即使你要删容器、重建容器，只要这个目录还在，很多关键数据通常就还在。

◆四、开始拉取 OpenClaw 镜像

现在环境已经差不多了，下一步就是把 OpenClaw 真正下载下来。

这里我给新手的建议一直都很明确：

优先使用明确版本号，不要直接依赖 latest。

因为版本固定以后：

• 更稳
• 更容易排查
• 更容易复现
• 不容易因为上游变动突然出问题

在 PowerShell 或 CMD 中执行：

docker pull ghcr.io/openclaw/openclaw:v2026.3.8

这里以 v2026.3.8 为例。 你实际部署时，最好以 OpenClaw 官方发布页或镜像仓库里的稳定版本为准。

如果你已经很熟悉 Docker，也明确知道自己在用什么版本，那当然可以考虑 latest。 但如果你是第一次装，固定版本号永远更稳。

◆五、正式把 OpenClaw 跑起来

前面的准备，都是为了这一刻。

在 PowerShell 或 CMD 中执行：

docker run -d --name openclaw-bot --restart unless-stopped -v D:\openclaw_data:/app/data ghcr.io/openclaw/openclaw:v2026.3.8

这条命令可以简单理解成：

• 在后台启动一个 OpenClaw 容器
• 给它取名叫 openclaw-bot
• 让它在系统或 Docker 重启后尽量自动恢复
• 把你的本地数据目录挂到容器里保存数据

运行后，先别急着往下走，先检查一下容器状态：

docker ps

如果一切正常，你应该能在列表里看到 openclaw-bot，状态一般会是 Up。

◆六、容器启动了，不等于 OpenClaw 已经“能用”了

这是很多教程最容易让人误解的地方。

容器启动，只说明“运行载体”起来了。 但 OpenClaw 真正要开始工作，还需要你完成初始化配置。

所以接下来，需要执行初始化向导。

在 PowerShell 或 CMD 中执行：

docker exec -it openclaw-bot openclaw onboard

接下来，按照终端提示一步步填写：

• 模型提供商
• API Key
• 默认模型
• Gateway 相关设置
• 按需接入聊天渠道

如果你只是想先把系统跑通，建议先做最小配置：

先把模型配置好，先确认能对话，再考虑后面接 Telegram、Discord、飞书这些渠道。

很多人一开始就想“一次全配完”，结果只要其中一个环节错了，自己就不知道到底卡在哪。 更稳的做法永远是：

先跑通最小闭环，再逐步加功能。

◆七、怎么判断自己真的装成功了？

很多人判断“我装好了”的标准，其实只是：

• 我执行过命令了
• 我看到容器在跑了

但这还不够。

真正的成功，至少应该满足下面几件事：

1）容器还在运行

docker ps

2）日志里没有明显报错

docker logs --tail 100 openclaw-bot

如果你想持续看日志：

docker logs -f openclaw-bot

只要以后遇到“为什么不工作”“为什么没反应”“为什么配置完也不对”这类问题，第一件事先看日志。

3）状态命令能正常返回

如果镜像版本支持，你还可以进一步检查：

docker exec -it openclaw-bot openclaw gateway status

或者：

docker exec -it openclaw-bot openclaw status

这一步的意义，是确认 OpenClaw 不只是“进程存在”，而是“状态正常”。

4）你真的能发出第一条消息

这一步，才是最后的验证标准。

对普通用户来说，真正的“安装成功”至少意味着：

• 容器正常运行
• 日志没有明显异常
• 状态检查没报大错
• 控制界面能打开，或者聊天渠道已经能收发消息

只有做到这里，才不是“看起来装好了”，而是真正“能用了”。

◆八、后面你一定会反复用到的几个命令

安装不是结束。 真正用起来以后，你最常做的事往往是：

• 看状态
• 看日志
• 重启
• 停止
• 再启动

这些命令建议你先收好。

查看运行中的容器

docker ps

查看日志

docker logs -f openclaw-bot

重启容器

docker restart openclaw-bot

停止容器

docker stop openclaw-bot

启动已停止的容器

docker start openclaw-bot

删除容器（谨慎）

docker rm -f openclaw-bot

只要你的数据目录 D:\openclaw_data 还在，很多情况下重新建容器后仍然可以继续使用原有数据。 但在执行删除前，最好还是先备份重要配置。

◆九、几个最常见的坑，提前帮你避开

1）wsl --install 执行失败

先看这几件事：

• 你是否用管理员身份打开了 PowerShell
• BIOS 虚拟化是否开启
• Windows 版本是否支持 WSL2

2）WSL 安装好了，但版本不是 2

执行：

wsl --set-version Ubuntu-24.04 2

把发行版名称替换成你自己的实际名称。

3）Docker Desktop 启动不了

优先检查：

• WSL 是否正常
• WSL2 引擎是否启用
• 系统虚拟化是否开启
• 是否有安全软件拦截

4）拉镜像很慢，甚至超时

通常先排查两件事：

• 网络本身是否稳定
• Docker 镜像加速配置是否生效

很多时候不是命令错了，而是镜像源出了问题。

5）容器刚启动就退出

不要急着重装，先看日志：

docker logs openclaw-bot

日志往往能直接告诉你问题方向，比如：

• 路径挂载异常
• 初始化失败
• 配置文件损坏
• 镜像本身没拉完整

6）openclaw onboard 跑完了，但还是不能聊天

重点检查这四项：

• 模型 API Key 是否正确
• 默认模型是否配对
• 渠道 Token 是否填对
• Gateway 是否仍在正常运行

很多时候，问题并不在“程序没装好”，而在“配置没填对”。

◆十、如果你是第一次折腾这类环境，我给你三个建议

第一：先跑通，不要先求完美

不要一开始就想着：

• 路径必须最优
• 存储必须全放 D 盘
• compose 必须一步到位
• 所有渠道必须一次配完

这些以后都可以做。 第一阶段只有一个目标：

让 OpenClaw 先成功跑起来。

第二：固定版本号，比追“最新”更重要

对部署来说，最重要的通常不是“最新”，而是：

• 稳定
• 可复现
• 好排查

所以如果你不是在做测试，尽量使用明确版本号。

第三：出问题先看日志，不要先重装

这是最值得养成的习惯。

很多问题并不需要你从头再来，而是需要你先知道它到底错在哪。

所以以后只要遇到异常，先问自己一句：

我看日志了吗？

◆写在最后

很多人以为自己卡在 OpenClaw 安装上，是因为“这个东西太技术了”。 但实际情况常常不是这样。

真正把人劝退的，往往不是技术本身，而是：

一开始就选了太绕、太乱、太难维护的路径。

如果你是在 Windows 上部署 OpenClaw，希望它后面更稳、更容易维护、更少返工，那么：

WSL2 + Docker Desktop + 固定版本镜像 + 数据目录持久化  

仍然是一条很值得选的路线。

它不是步骤最少的那条。 但对很多人来说，它往往是后面最省事的那条。

而这件事，说到底就一句话：

第一次安装时多花一点时间，把路走对，后面会轻松很多。

如果你最近也在 Windows 上折腾 OpenClaw，这篇可以先收藏起来，后面安装时按步骤走，会省掉很多来回试错的时间。

如果你已经装过，也欢迎在评论区说说你踩过哪些坑。后面我也可以继续把：

• OpenClaw 初始化向导怎么填
• Telegram / Discord 怎么接入
• md2wechat 工作流怎么串起来

继续写成一套更完整的实操内容。

◆信息来源

• Microsoft WSL 安装文档：https://learn.microsoft.com/zh-cn/windows/wsl/install
• Docker Desktop 安装文档：https://docs.docker.com/desktop/setup/install/windows-install/
• OpenClaw 文档首页：https://docs.openclaw.ai
• OpenClaw Windows 文档：https://docs.openclaw.ai/platforms/windows
• OpenClaw Getting Started：https://docs.openclaw.ai/start/getting-started