Windows 安装 OpenClaw 完整教程(Docker 版)
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。