1. 环境准备
在开始之前,请确保你的系统已经安装了以下软件:
- Docker Desktop (且已启动并在后台运行)
- Git (可选,用于克隆仓库)
2. 获取代码与环境变量配置
首先,进入你想要存放该项目的目录并克隆/下载项目代码。我们将以 d:\workspace\openclaw 为例。
2.1 创建并配置 .env 文件
OpenClaw 依赖一些基础配置来定义数据卷和相关的安全 Token。在项目根目录下,我们需要复制示例配置并作修改。
你可以直接在项目根目录新建或修改 .env 文件,在其中添加或修改以下变量:
# Windows 系统下,将路径映射为用户目录或其他你想要的绝对路径,避免权限错误。
# 请将 YourUsername 替换为你电脑实际的用户名
OPENCLAW_CONFIG_DIR=C:\Users\YourUsername\.openclaw
OPENCLAW_WORKSPACE_DIR=C:\Users\YourUsername\.openclaw\workspace
# 指定运行绑定的 IP 网络,lan 允许宿主机直接通过 127.0.0.1 访问
OPENCLAW_GATEWAY_BIND=lan
# 使用官方的预编译镜像,以避免在你的电脑上本地重新构建源码,节省时间
OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest
3. 进行交互式初始化 (Onboard)
当环境配置好后,运行以下命令进入 OpenClaw 的交互式安装向导。我们通过附加 --env-file .env 来确保容器能读到刚才配置的变量:
docker compose --env-file .env run --rm openclaw-cli onboard

运行该命令后,你会在命令行中看到交互式提示:
- 风险提示:输入
Yes,确认你知晓默认是在个人设备上部署。 - Onboarding mode (向导模式):建议选择
QuickStart。 - 选择 AI 提供商与授权:根据提示选择如 OpenAI、Anthropic 等,并输入你对应的 API 密钥。
请根据屏幕提示按下回车或上下方向键做出选择,直到整个 Onboard 流程执行完毕。
4. 启动 Gateway 网关服务
在 Onboard 结束并成功写入配置后,真正让你的 OpenClaw 跑起来并在后台长驻的命令是:
docker compose --env-file .env up -d openclaw-gateway
up -d 参数表示将其放在后台静默运行。
5. 登录与使用
- 访问控制面板:打开你的浏览器,访问 http://127.0.0.1:18789/


