Docker安装openclaw

Docker 安装 OpenClaw 完整教程（CentOS / Windows / Linux 通用）

---

前提条件

在开始安装 OpenClaw 之前，请确保您的系统已安装 Docker 和 Docker Compose。

若尚未安装，在 CentOS 系统上可执行以下命令快速安装：

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

---

方案一：极简一键运行（推荐，10秒启动）

这是最快速的启动方式。复制下方命令运行，即可自动完成容器创建、配置目录挂载与开机自启设置：

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

启动完成！访问地址

http://你的IP:7373

---

方案二：Docker Compose 稳定版（生产环境推荐）

适用于正式环境或需要精细管理的场景。请按以下步骤操作：

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

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

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

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

---

首次使用关键步骤：初始化配置

容器启动后，需执行初始化配置以设置 API Key。

运行以下命令：

docker exec -it openclaw openclaw onboard

根据提示选择大模型并输入对应 API Key，完成设置。

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

docker restart openclaw

---

常用 Docker 命令速查

管理 OpenClaw 容器常用命令如下：

# 启动
docker start openclaw
# 停止
docker stop openclaw
# 重启
docker restart openclaw
# 查看日志
docker logs -f openclaw
# 删除容器（配置保留）
docker rm -f openclaw

---

防火墙放行端口（CentOS 系统）

若服务器启用防火墙，需放行 OpenClaw 使用的 7373 端口：

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

---

常见问题排查

1. 端口被占用怎么办？

   修改启动命令中的端口映射，例如将 -p 7373:7373 改为 -p 7374:7373，并通过新端口访问。

2. 服务无法访问？

   请按顺序检查：

   • 服务器安全组或防火墙是否允许 7373 端口。
   • 容器运行状态：执行 docker ps 命令确认。

3. 担心配置丢失？

   无需担心。启动时已挂载配置目录至宿主机 /opt/openclaw，删除或重建容器不会影响配置。

---