Docker部署OpenClaw:Windows挂载路径修改指南

2026-06-17阅读 0热度 0
docker

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
免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策