如何使用 Docker 快速部署 OpenClaw 客户端

发表于 |

前言

手动安装 OpenClaw 虽然不难，但是操作比较繁琐，尤其是针对新机器，需要反复安装 Node 和 Git 环境，相当耗时，而且容易出错。

为了能以最快的速度体验上龙虾，今天我们以 Docker 的方式，来快速进行 OpenClaw 的安装。

具体部署流程

1. 创建自定义网络

1
docker network create c_bridge

创建自定义网络，方便后期多容器交互。

2. 创建数据映射目录

1
mkdir -p /root/songjian/openclaw

创建数据持久化目录，确保 OpenClaw 配置和数据不会丢失。

3. 搜索 OpenClaw 镜像

1
docker search openclaw

或访问 Docker Hub 查看可用镜像：https://hub.docker.com/r/openclaw/openclaw

4. 拉取镜像

1
2
# 拉取最新版本
docker pull ghcr.io/openclaw/openclaw:latest

镜像大小约 300MB，拉取速度取决于网络状况。

5. 创建容器

1
2
3
4
5
6
7
8
9
10
11
docker run -d \
  --name=c_openclaw \
  --restart=always \
  --network=c_bridge \
  -p 3012:3000 \
  -p 18789:18789 \
  -v /root/songjian/openclaw:/root/.openclaw \
  -h c_openclaw \
  -e TZ=Asia/Shanghai \
  -e OPENCLAW_SKIP_ONBOARD=true \
  ghcr.io/openclaw/openclaw:latest

参数解释：

  • -d：后台运行
  • --name=c_openclaw：指定容器名称
  • --restart=always：自动重启策略
  • --network=c_bridge：加入自定义网络
  • -p 3012:3000：将内部 3000 端口映射到宿主机 3012
  • -p 18789:18789：网关通信端口
  • -v /root/songjian/openclaw:/root/.openclaw：挂载数据目录
  • -h c_openclaw：设置容器主机名
  • -e TZ=Asia/Shanghai：设置时区
  • -e OPENCLAW_SKIP_ONBOARD=true：跳过首次引导

6. 进入容器并配置

1
2
3
4
5
6
7
8
# 查看容器是否正常运行
docker ps | grep c_openclaw

# 查看容器日志
docker logs -f c_openclaw

# 进入容器终端
docker exec -it c_openclaw /bin/sh

在容器内部执行以下命令完成初始配置：

1
2
# 运行初始化向导
openclaw onboard

7. 访问 OpenClaw

  • 管理后台：浏览器打开 http://你的服务器IP:3012
  • 网关地址：ws://你的服务器IP:18789

8. 验证服务状态

1
2
3
4
5
# 查看容器内服务状态
docker exec c_openclaw openclaw gateway status

# 检查服务健康状态
curl http://localhost:3012/health

常见问题

1. 端口冲突

如果 3012 或 18789 端口已被占用，可修改为其他端口：

1
2
# 例如使用 3013:3000
-p 3013:3000

2. 权限问题

如果遇到权限错误，可尝试修改数据目录权限：

1
sudo chmod 777 -R /root/songjian/openclaw

3. 镜像拉取失败

可尝试使用国内镜像源：

1
docker pull registry.cn-hangzhou.aliyuncs.com/openclaw/openclaw:latest

4. 配置文件丢失

所有配置文件保存在 /root/songjian/openclaw 目录，定期备份此目录即可。

管理命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 停止容器
docker stop c_openclaw

# 启动容器
docker start c_openclaw

# 重启容器
docker restart c_openclaw

# 删除容器（谨慎操作）
docker rm -f c_openclaw

# 查看容器资源使用
docker stats c_openclaw

升级到新版本

1
2
3
4
5
6
7
8
# 1. 停止并删除旧容器
docker stop c_openclaw && docker rm c_openclaw

# 2. 拉取新镜像
docker pull ghcr.io/openclaw/openclaw:latest

# 3. 使用相同命令重新创建容器
# 数据和配置会保留，因为是挂载的

总结

通过 Docker 部署 OpenClaw，你可以在 5 分钟内完成安装和配置，无需关心 Node.js 版本、系统依赖等问题。这种方式特别适合快速体验、测试环境部署

现在你已经成功部署了 OpenClaw，可以开始使用强大的 AI 智能体功能了！

本文为作者原创 转载时请注明出处 谢谢

乱码三千 – 点滴积累 ,欢迎来到乱码三千技术博客站

0%