Docker安装openclaw

Docker 部署 OpenClaw 终极指南：CentOS / Windows / Linux 全平台详解

部署前的环境准备

部署前，请确保您的系统已安装 Docker 及 Docker Compose。

以 CentOS 为例，若需安装，请执行下列命令完成环境配置：

# 安装 Docker
yum install -y docker-ce-18.06.1.ce-3.el7
# 安装 Docker Compose
yum install -y docker-compose

方案一：Docker 单命令极速部署（10秒完成）

这是最高效的启动方案。执行以下命令，Docker 将自动完成镜像拉取、容器创建、数据卷挂载及自启动配置：

docker run -d \
--name openclaw \
--restart always \
-p 7373:7373 \
-v /opt/openclaw:/root/.config/openclaw \
openclawai/openclaw

部署成功！通过下列地址访问

http://你的服务器IP:7373

方案二：基于 Docker Compose 的标准化部署（生产环境首选）

为确保服务的高可用性与可维护性，生产环境推荐使用 Docker Compose 进行编排部署。请按顺序执行下列操作：

首先，创建并进入项目专属目录：

mkdir -p /opt/openclaw
cd /opt/openclaw

使用文本编辑器创建 Compose 配置文件：

vim ./docker-compose.yml

将以下编排配置写入 docker-compose.yml 文件：

version: ‘3’
services:
openclaw:
image: ghcr.io/openclaw/openclaw:latest
container_name: openclaw
restart: always
ports:
- “7373:7373”
volumes:
- ./config:/root/.config/openclaw

执行以下命令，以守护进程模式启动服务：

docker-compose up -d

核心步骤：OpenClaw 应用初始化配置

容器启动后，必须完成初始化配置以关联您的大模型 API 密钥。

运行容器内初始化命令：

docker exec -it openclaw openclaw onboard

根据命令行交互提示，选择所需的大语言模型并输入有效的 API Key。

配置完成后，重启容器使所有设置生效：

docker restart openclaw

OpenClaw 容器运维命令速查手册

日常运维中，掌握以下 Docker 命令即可高效管理 OpenClaw 实例：

# 启动
docker start openclaw
# 停止
docker stop openclaw
# 重启
docker restart openclaw
# 查看日志
docker logs -f openclaw
# 删除容器（配置文件因已挂载将永久保留）
docker rm -f openclaw

服务器防火墙配置（CentOS 系统）

若服务器启用了防火墙（如 firewalld），需为 OpenClaw 开放 7373 端口：

firewall-cmd --permanent --add-port=7373/tcp
firewall-cmd --reload

部署与访问故障排除指南

1. 如何处理端口冲突？

   修改 Docker 命令中的端口映射参数即可。例如，将 -p 7373:7373 调整为 -p 7374:7373，之后通过新端口 7374 进行访问。

2. 服务部署后无法访问？

   请按此清单逐项排查：

   • 检查云服务器安全组或主机防火墙是否已放行 7373 端口。
   • 执行 docker ps 命令，确认 OpenClaw 容器处于 “Up” 运行状态。

3. 如何保障配置文件安全与持久化？

   部署时通过 -v 参数将容器内配置目录挂载至宿主机（如 /opt/openclaw）。此操作确保了配置数据的持久性，即使容器被删除或重建，您的所有设置均会保留。