OpenClaw 小龙虾本地部署教程
2026-03-15
杂乱的知识
type
Post
status
Published
date
Mar 15, 2026
slug
openclaw-local-deploy-guide
summary
本教程详细讲解了如何在 Windows 环境下使用 Docker 本地部署 OpenClaw，包括镜像构建、容器启动、CLI 初始化配置以及设备配对与授权操作，同时说明了配置文件与环境变量的使用注意事项，确保网关和 CLI 能正常通信，数据持久化保存，最终实现本地 OpenClaw 的完整运行环境。
tags
工具
category
杂乱的知识
icon
password
本教程记录如何在 Windows 上使用 Docker 部署 OpenClaw，并完成 Control UI 的设备配对。
适用于：
- Windows
- Docker Desktop
- 本地运行 OpenClaw Gateway
一、环境准备
需要安装：
- Docker Desktop
确认 Docker 可以正常运行：
二、启动 OpenClaw
1. 克隆 OpenClaw 仓库
进入项目目录：
构建docker镜像,如果你是用的linux,你可以直接使用它提供的sh脚本.
这里先不启动服务.你需要创建一个.env基础配置文件.
我推荐像我一样,不要创建在源码目录.
在docker-compose.yml和.env环境变量配置文件所在目录启动服务：
成功后会创建：
- network
- gateway 容器
- cli 容器
输出：
但是此时你会发现容器一直处于重启的状态,这是因为你还没有初始化OpenClaw,你启动后只是在当前docker-compose.yml文件所在目录下出现了config和workspace文件夹,但是你点击进去是空的.
三、初始化 OpenClaw
第一次部署需要执行 setup：
成功输出：
说明已经生成：
但是此时你查看容器的log会发现遇到如下错误
意思是：
- 如果 Gateway 不是绑定 loopback（127.0.0.1）
- 必须配置
所以你需要在openclaw.json配置文件中配置下.以下配置只添加了解决该问题的配置,可以直接复制粘贴覆盖默认生成的. 下面配置中就是添加了gateway配置而已. 配置完后,等他自动重启成功即可.
四、打开 Control UI
浏览器访问：
首次访问时会自动创建 设备配对请求,需要进行配对,否则无法登录。
五、查看设备配对请求
在终端运行：
输出：
字段说明：
字段 | 含义 |
Request | 配对请求 ID |
Device | 设备 ID |
Role | 权限角色 |
IP | 设备来源 IP |
注意：
批准时必须使用 Request ID，而不是 Device ID。
六、批准设备配对
执行：
成功：
此时设备已经加入系统。这时就能够登录了.
Loading...