在Windows docker desktop中编译、运行OpenClaw（下篇）

上篇回顾与本篇目标

在上一篇文章中（点击阅读），我们详细介绍了如何获取OpenClaw的镜像tar文件。本文将继续深入，为你提供一份完整的Windows Docker Desktop部署教程，手把手讲解如何将OpenClaw镜像成功地运行起来，让你轻松搭建AI服务网关环境。

第一步：导入Docker镜像

首先，启动终端或命令行工具，并定位到你存放下载文件的目录。接着，执行以下关键的docker镜像导入指令：

docker load -i openclaw-local.tar

当终端显示加载成功的反馈信息时，即表示OpenClaw镜像已经顺利导入到你的本地Docker仓库。这是启动OpenClaw服务容器的首要步骤。

第二步：准备配置文件

要成功启动服务，你需要预先配置两个核心文件：docker-compose.yml 和 openclaw.json。它们定义了容器的运行参数与网关的认证规则。

修改 docker-compose.yml

你可以在OpenClaw源码的根目录中找到原始的docker-compose文件模板。考虑到Windows Docker Desktop的运行环境特性，我们需要对其中的部分配置进行适配。以下是经过优化的参考配置版本：

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE:-openclaw:local}
    user: root
    environment:
      HOME: /home/node
      TERM: xterm-256color
      OPENCLAW_GATEWAY_TOKEN: 8a9b7c6d5e4f3a2b1c0d9e8f7a6b5c4d #访问密钥，
      CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY}
      CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY}
      CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE}
    volumes:
      - "D:\\ProgramData\\Docker-Volume\\openclaw\\config:/home/node/.openclaw" #config文件夹映射
      - "D:\\ProgramData\\Docker-Volume\\openclaw\\workspace:/home/node/.openclaw/workspace" #workspace文件夹映射
    ports:
      - "${OPENCLAW_GATEWAY_PORT:-18789}:18789"
      - "${OPENCLAW_BRIDGE_PORT:-18790}:18790"
    init: true
    restart: unless-stopped
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "lan",
        "--port",
        "18789",
        "--allow-unconfigured" #务必要加这段，因为上面environment段中有若干参数我们还没配置
      ]

  openclaw-cli:
    image: ${OPENCLAW_IMAGE:-openclaw:local}
    environment:
      HOME: /home/node
      TERM: xterm-256color
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      BROWSER: echo
      CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY}
      CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY}
      CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE}
    volumes:
      - "D:\\ProgramData\\Docker-Volume\\openclaw\\config:/home/node/.openclaw" #config文件夹映射
      - "D:\\ProgramData\\Docker-Volume\\openclaw\\workspace:/home/node/.openclaw/workspace" #workspace文件夹映射
    stdin_open: true
    tty: true
    init: true
    entrypoint: ["node", "dist/index.js"]

请注意，配置中定义的 openclaw-cli 服务主要用于提供容器内的命令行客户端。如果你计划直接通过Web界面进行管理，或者在宿主机上使用命令行工具，该服务的配置可以酌情省略，这不会影响网关核心功能的正常运行。

生成 openclaw.json 配置文件

接下来，你需要在文件映射的目标路径下创建网关的核心配置文件。参照上述compose文件中设置的本地卷路径（示例为 D:\ProgramData\Docker-Volume\openclaw\config\），新建一个名为 openclaw.json 的文件，并填入以下配置内容：

{
  "gateway": {
    "mode": "local",
    "bind": "lan",
    "port": 18789,
    "controlUi": {
      "enabled": true,
      "allowInsecureAuth": true,
      "dangerouslyDisableDeviceAuth": true,
      "dangerouslyAllowHostHeaderOriginFallback": true
    },
    "auth": {
      "mode": "token",
      "token": "8a9b7c6d5e4f3a2b1c0d9e8f7a6b5c4d"
    }
  }
}

至此，所有必要的配置文件均已准备完毕，为服务的启动奠定了坚实基础。

最后一步：启动容器服务

现在一切就绪。打开终端，导航至存放你的 docker-compose.yml 文件的目录，执行服务启动命令：

docker compose up -d

当命令行返回容器已成功创建并转入后台运行的信息时，即表明OpenClaw服务部署成功。

最后一步是访问控制台。打开你常用的浏览器，在地址栏输入：http://localhost:18789，你将看到如下网关界面：

为了完成身份验证，你需要在当前URL后附加查询参数 ?token=xxxxxxx，请务必将其中的 xxxxxxx 替换为你在 openclaw.json 配置文件中设定的相同密钥。完成此操作后，你将正式进入OpenClaw的Web控制台管理界面。

恭喜你！现在，OpenClaw网关服务已经在你的Windows Docker Desktop环境中稳定运行。接下来，你就可以通过这个功能强大的控制台，进行后续的模型配置、功能测试以及集成开发等工作了。