Docker部署OpenClaw:Windows挂载路径修改指南
OpenClaw 简介与安全部署建议
OpenClaw 是当前备受关注的 AI Agent 工具——它能够直接操控本地电脑与浏览器,并支持远程交互。听起来实用,但本地安装意味着它拥有系统级操作权限,一旦误删或误改文件,后果可能严重。因此,如果你是初学者或仅想体验,建议具有一定计算机基础的用户优先采用 Docker 环境部署,这样既能隔离风险,又便于清理。
部署前准备:安装 WSL 与 Docker
在 Windows 系统下运行 OpenClaw,需通过 WSL(Windows Subsystem for Linux)搭建 Linux 虚拟环境。只需完成以下两步:
- 安装 WSL(Windows 子系统 for Linux)
- 在 WSL 中安装 Docker 容器引擎
这两步的详细操作可参考已有的优质教程,此处不再赘述:
https://zhuanlan.zhihu.com/p/690428564
https://www.cnblogs.com/haima/p/18697360
编译 OpenClaw Docker 镜像
首先将 OpenClaw 源代码克隆至本地:
git clone https://github.com/openclaw/openclaw.git
源码目录中有几个关键配置文件:
- docker-setup.sh:Bash 脚本,负责检查环境依赖、设置环境变量、生成额外 Docker Compose 配置、构建镜像、执行初始化引导并最终启动服务。
- docker-compose.yml:OpenClaw 的核心编排文件,定义了两个容器服务——openclaw-gateway 与 openclaw-cli。
进入项目根目录后,直接执行:
./docker-setup.sh
镜像构建随即启动:
配置 OpenClaw 参数
镜像构建完成后会自动进入配置阶段。具体参数配置方法网上已有众多教程,可自行查阅。
扩展 OpenClaw 可访问目录
默认情况下,OpenClaw 的配置目录与工作区目录如下:
OPENCLAW_CONFIG_DIR="$HOME/.openclaw"
OPENCLAW_WORKSPACE_DIR="$HOME/.openclaw/workspace"
这两个路径在 Docker 容器内分别映射为 /home/node/.openclaw 和 /home/node/.openclaw/workspace。这意味着 OpenClaw 默认仅能访问虚拟环境中的这两个目录。实际使用时,往往需要挂载其他宿主机目录。
添加挂载路径前,先停止服务:
docker compose down
然后设置需要挂载的新路径,格式为 本地路径:docker容器内路径。例如:
export OPENCLAW_EXTRA_MOUNTS="/home/hello/claw-data:/home/claw-data"
接着重新运行 docker-setup.sh,它会生成 docker-compose.extra.yml 文件,然后重启服务即可使 OpenClaw 访问新路径:
./docker-setup.sh
