Openclaw使用实践

在Windows上部署OpenClaw：通过Docker连接本地Ollama

想在Windows上体验OpenClaw？一个高效且主流的方法是借助Docker Desktop，在WSL2环境下通过容器来启动服务，并让它能够接驳你本机运行的Ollama模型。下面我们来一步步操作。

第一步：获取OpenClaw源码

首先，需要从代码仓库克隆OpenClaw的源代码。如果访问GitHub有困难，国内用户可以选择Gitee上的同步镜像，操作起来会顺畅不少。打开终端，执行以下命令：

git clone https://gitee.com/gzroy2000/openclaw.git

第二步：构建与配置Docker环境

进入克隆好的项目目录，你会发现一个名为 docker-setup.sh 的脚本。直接运行它，脚本将自动为你构建OpenClaw的Docker镜像。当然，如果你不想花费时间重新构建，也有捷径——直接使用预先构建好的公共镜像。只需设置一个环境变量即可：

export OPENCLAW_IMAGE=m.daocloud.io/ghcr.io/openclaw/openclaw:latest

接下来的配置是关键。为了让容器内的OpenClaw能访问到宿主机（也就是你的Windows机器）上的Ollama服务，你需要修改项目根目录下的 docker-compose.yml 文件。在相应服务配置中添加这两行：

network_mode: host
extra_hosts:
  - "host.docker.internal:host-gateway"

此外，还有一个Windows下的特定设置需要注意：如果你的Docker服务是通过Docker Desktop启动的，务必进入其设置界面，找到并勾选“Enable host network”选项。这个开关没打开，容器将无法成功连接到宿主机的网络服务，Ollama自然也就找不到了。

第三步：运行与初始化配置

准备工作就绪后，再次在项目目录下运行 ./docker-setup.sh。脚本会引导你进行初始化配置。当提示配置模型时，记得选择“Custom Provider”（自定义提供方），并在设置Base URL时填入你本机Ollama服务的地址，格式通常为：http://localhost:11434/v1。

配置完成后，Docker会启动一个名为 openclaw-openclaw-gateway-1 的容器。你可能会发现它一直在重启，这通常是正常的初始化过程。此时，需要手动调整一下网关配置。打开 ~/.openclaw 目录下的 openclaw.json 文件，找到 gateway 部分，参考如下示例进行修改：

"gateway": {
  "port": 18789,
  "mode": "local",
  "bind": "lan",
  "controlUi": {
    "allowedOrigins": [
      "http://localhost:18789",
      "http://127.0.0.1:18789"
    ],
    "allowInsecureAuth": true
  },
  "auth": {
    "mode": "token",
    "token": "abc"
  },
}

第四步：访问Web界面

所有配置完成后，打开你的浏览器，在地址栏输入：http://localhost:18789/?token=abc。顺利的话，OpenClaw清爽的Web聊天界面就会呈现在你眼前了。至此，一个在本地运行、并能调用Ollama模型的AI助手便部署成功。