OpenClaw（曾用名 Moltbot/Clawdbot）是近期极其火爆的本地开源 AI 代理平台（甚至在 2026 年初超越了 React 成为 GitHub 全站 Star 数最多的软件项目）。

由于 OpenClaw 原生是为类 Unix 环境设计的，在 Windows 上直接运行可能会遇到一些底层依赖（比如 sharp 图像处理库）的兼容性问题。因此，官方强烈建议在 Windows 系统中通过 WSL2（Windows Subsystem for Linux 2）进行安装。文章源自：毕卡奥，阅读原文请搜索毕卡奥！毕卡奥-https://www.bikaao.com/archives/2390.html

本文环境：文章源自：毕卡奥，阅读原文请搜索毕卡奥！毕卡奥-https://www.bikaao.com/archives/2390.html

一、Windows 底层环境准备 (WSL2 + Docker)

1. 检查并启用硬件虚拟化 打开 Windows 任务管理器 (快捷键 Ctrl + Shift + Esc)，点击左侧的“性能” -> “CPU”。在右下角查看“虚拟化”状态是否显示为“已启用”。如果未启用，你需要重启电脑进入 BIOS 开启 VT-x (Intel) 或 AMD-V。

        2.安装 WSL2 (Windows Subsystem for Linux) 右键点击 Windows 的“开始”菜单，选择“Windows             PowerShell (管理员)”或“终端 (管理员)”。

• 输入以下命令并回车：

  安装 WSL

  wsl --install

• 然后单独再装Ubuntu

  wsl --install -d Ubuntu

• 备注：如果这个下载安装慢，可以去微软商店，搜索Ubuntu 进行安装，

• 安装完成后，重启电脑。重启后会自动弹出一个 Ubuntu 终端窗口，按照屏幕提示设置你的 Linux 初始用户名和密码。若没弹可以忽略，我们基本也用 root 用户操作

下载：docker-desktop

https://www.docker.com/products/docker-desktop/

安装完成后Windows 终端中确认版本：

docker --version
docker compose version

二、下载 OpenClaw 源码

如果没有 Git，可以直接下载 ZIP。

仓库：

https://github.com/openclaw/openclaw

解压到：

目录结构应该包含：

三、构建 OpenClaw Docker 镜像

进入项目目录：

构建镜像：

docker build -t openclaw:local -f Dockerfile .

首次构建约 10~20分钟。

成功标志：

四、创建数据目录

创建 OpenClaw 数据目录：

五、创建 .env 配置

创建文件：

内容：

OPENCLAW_CONFIG_DIR=C:/openclaw-data/config
OPENCLAW_WORKSPACE_DIR=C:/openclaw-data/workspace
OPENCLAW_GATEWAY_BIND=lan

注意：

• Windows 路径使用 /

• 不要使用 loopback

六、运行初始化

执行：

docker compose run --rm openclaw-cli onboard

初始化过程中会出现一些配置问题。

推荐选择：

Homebrew：

Google Places：

完成后会显示：

七、启动 OpenClaw

执行：

docker compose up -d openclaw-gateway

检查状态：

docker compose ps

应该看到：

八、生成控制台地址

执行：

docker compose run --rm openclaw-cli dashboard --no-open

输出：

浏览器打开即可。

九、设备配对（重要）

第一次打开页面会出现：

查看待配对设备：

docker compose run --rm openclaw-cli devices list

批准设备：

docker compose run --rm openclaw-cli devices approve --latest

刷新浏览器即可登录。

十、常见问题

1 无法访问网页

检查：

应看到：

2 ERR_EMPTY_RESPONSE

原因：

修改：

把：

改成：

然后重启：

docker compose down
docker compose up -d openclaw-gateway

3 pairing required

批准设备：

docker compose run --rm openclaw-cli devices approve --latest

4 Telegram 警告

日志中出现：

不影响运行，可以忽略。

十一、重要端口

默认访问：

十二、目录结构

十三、安全建议

初始化过程中会生成：

• OpenClaw gateway token

• Google API key

• Telegram bot token

如果这些出现在日志或截图中，建议：

• 重新生成 API key

• 重置 token

十四、升级 OpenClaw

更新代码后：

十五、启动与停止

启动：

停止：

查看日志：

十六、访问地址

最终访问：

十七、当前配置模型

你当前使用模型：

如果想改为：

• OpenAI

• Gemini

• Anthropic

• 本地模型

可以在：

修改。

十八、部署完成

至此：

OpenClaw 已成功运行