Windows 安装 OpenClaw 完整教程(Docker 版)

AIGC Feb 15, 2026

OpenClaw 是一个非常流行的 AI Agent 自动化工具

它可以结合 AI 模型自动完成很多任务,例如:

  • 自动搜索资料
  • 自动写文章
  • 自动抓取 AI 新闻
  • 自动执行自动化任务
  • 通过 Telegram 控制 AI Agent

很多人在 Windows 上安装 OpenClaw 时会遇到各种问题,比如:

  • Node 环境冲突
  • npm 依赖错误
  • 系统依赖缺失

最简单、最稳定的方法其实是:

使用 Docker 运行 OpenClaw。

Docker 会把 OpenClaw 运行在一个独立环境里,不会影响 Windows 系统。

这篇文章会从 零基础开始,一步一步教你安装。


一、OpenClaw 在 Windows 上的运行结构

在 Windows 上运行 OpenClaw Docker 的结构其实很简单:

Windows
   ↓
WSL2
   ↓
Docker Desktop
   ↓
OpenClaw

简单理解:

  • WSL2:Windows 提供的容器运行环境
  • Docker Desktop:Docker 管理工具
  • OpenClaw:运行在 Docker 里的 AI Agent

整个过程 不需要接触 Linux 环境


二、安装 WSL

首先安装 WSL。

打开 管理员 PowerShell

运行:

wsl --install

这个命令会自动:

  • 启用 WSL
  • 安装 Linux 内核组件
  • 配置系统环境

安装完成后:

重启电脑。


三、安装 Docker Desktop

接下来安装 Docker Desktop。

官方下载:

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

下载 Docker Desktop for Windows

安装过程中注意:

确保启用:

Use WSL 2 instead of Hyper-V

安装完成后启动 Docker Desktop。

等待 Docker 启动完成。


四、确认 Docker 是否正常

打开 PowerShell

运行:

docker --version

如果看到类似:

Docker version 26.x.x

说明 Docker 已安装成功。

再测试 Docker:

docker run hello-world

如果看到:

Hello from Docker!

说明 Docker 环境已经完全正常。


五、下载 OpenClaw Docker 镜像

现在下载 OpenClaw 镜像:

docker pull openclaw/openclaw

下载完成后可以查看:

docker images

你会看到:

openclaw/openclaw

六、启动 OpenClaw

运行 OpenClaw 容器:

docker run -d -p 18789:18789 --name openclaw openclaw/openclaw

参数解释:

-d
后台运行容器

-p 18789:18789
开放 OpenClaw 控制台端口

--name openclaw
容器名称

运行成功后可以查看:

docker ps

如果看到 openclaw 容器说明启动成功。


七、打开 OpenClaw 控制台

打开浏览器访问:

<http://127.0.0.1:18789>

如果看到 OpenClaw Dashboard

说明安装成功。


八、配置 AI 模型

OpenClaw 需要配置 AI 模型。

常见选择:

OpenAI
Claude
Gemini
Custom API

例如使用 OpenAI:

Provider: OpenAI
API Key: sk-xxxx
Model: gpt-4o

如果使用模型中转 API:

Provider: Custom
Base URL: <https://api.xxx.com/v1>
API Key: sk-xxxx
Model: gpt-4o

配置完成后 OpenClaw 就可以运行 AI Agent。


九、创建 Telegram 机器人

OpenClaw 可以通过 Telegram 接收消息。

首先创建 Telegram Bot。

打开 Telegram 搜索:

@BotFather

发送:

/start

然后输入:

/newbot

按照提示输入:

机器人名称
机器人用户名

创建成功后 BotFather 会返回:

BOT TOKEN

例如:

123456:ABCDEFxxxx

这个 Token 需要保存。


十、获取 Telegram Chat ID(最简单方法)

接下来需要获取你的 Telegram Chat ID。

最简单的方法是使用机器人:

@userinfobot

步骤如下:

1 搜索机器人

在 Telegram 搜索:

@userinfobot

打开机器人。


2 发送 /start

点击 Start 或发送:

/start

机器人会返回你的信息,例如:

Id: 123456789
First name: Tom
Language: en

3 复制 ID

其中:

Id: 123456789

这个数字就是你的:

Telegram Chat ID


十一、连接 Telegram 到 OpenClaw

进入容器:

docker exec -it openclaw bash

编辑配置文件:

/app/config.yaml

加入:

channels:
  telegram:
    enabled: true
    bot_token: "BOT_TOKEN"
    chat_id: "CHAT_ID"

保存退出。


十二、重启 OpenClaw

运行:

docker restart openclaw

十三、测试 Telegram

给你的 Telegram 机器人发送:

hello

如果配置成功,OpenClaw 会自动回复。

例如:

Hello! I am your OpenClaw agent.

说明 Telegram 已成功连接。


常见问题

Docker 无法启动

确保 BIOS 开启:

CPU Virtualization

WSL 未启用

运行:

wsl --install

Telegram 不回复

检查:

bot token
chat id

是否填写正确。


结语

在 Windows 上安装 OpenClaw 最稳定的方法是:

WSL2 + Docker Desktop

整个流程只需要:

安装 WSL
安装 Docker Desktop
启动 OpenClaw
配置 Telegram

通常 10分钟即可完成。

完成后你就拥有了一个:

可以通过 Telegram 控制的 AI Agent。

Tags