Docker安装openclaw

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

前提条件

在正式开始部署 OpenClaw 之前，您的系统上需要预先安装好 Docker 服务以及 Docker Compose 编排工具。这是确保所有步骤能顺利进行的基础。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

如果您使用的是 CentOS / RHEL 系统，可以通过以下命令快速完成安装：

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

Ubuntu 或 Debian 系统用户，请使用 apt-get 命令进行相应的安装。完成后，请确保 Docker 服务已启动并设置为开机自启。

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

对于追求效率、希望快速体验的用户，我们首推此一键启动方案。执行单条命令即可自动完成容器创建、端口映射、持久化存储配置及开机自启动设置，整个过程简洁高效。

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

部署完成！访问地址

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

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

对于正式的生产环境部署，或需要实现服务编排与精细化管理的用户，我们建议采用 Docker Compose 方案。它能提供更好的可维护性和稳定性。请按顺序执行以下步骤：

第一步，创建专属项目目录并进入该目录：

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

第二步，使用文本编辑器创建 Docker Compose 配置文件：

vim ./docker-compose.yml

第三步，将以下 YAML 配置完整地复制并粘贴到配置文件中：

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

在向导界面中，请根据提示选择您希望接入的 AI 模型（如 OpenAI GPT、Claude 等），并准确输入该模型对应的有效 API Key。

配置完成后，为使所有设置生效，请务必重启 OpenClaw 容器：

docker restart openclaw

常用 Docker 管理与运维命令

掌握以下核心 Docker 命令，您就能轻松管理 OpenClaw 容器的生命周期：

# 启动容器
docker start openclaw
# 停止容器
docker stop openclaw
# 重启容器
docker restart openclaw
# 实时查看容器日志（调试时非常有用）
docker logs -f openclaw
# 删除容器（注意：由于使用了卷挂载，配置数据不会丢失）
docker rm -f openclaw

服务器防火墙端口放行（适用于CentOS/RHEL）

若您的服务器系统防火墙（如 firewalld）处于开启状态，需要为 OpenClaw 的 Web 服务端口（默认为 7373）添加放行规则，以确保外部能够正常访问。

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

对于使用 iptables 或云服务商安全组的用户，请参考相应平台的规则配置方法。

常见安装与访问问题排查指南

1. 启动时提示“端口 7373 被占用”？

   这表明宿主机上的 7373 端口已被其他程序占用。解决方案很简单：修改 Docker 运行命令中的端口映射，将外部端口更换为一个空闲端口，例如 -p 7374:7373，随后使用新的端口号（如 7374）进行访问即可。

2. 部署完成后服务无法从外部访问？

   请按照以下顺序进行系统性检查：

   • 首先确认宿主机或云服务器（如阿里云、腾讯云）的安全组/防火墙策略是否已允许对 7373 端口的入站访问。
   • 其次，执行 docker ps 命令，检查 openclaw 容器是否处于 “Up” 运行状态。
   • 最后，可执行 docker logs openclaw 查看容器日志，以发现潜在的错误信息。

3. 担心容器删除后配置丢失？

   完全无需担心数据丢失。无论是方案一还是方案二，我们都已将容器内的关键配置文件目录 (/root/.config/openclaw) 持久化挂载到了宿主机的 /opt/openclaw 目录。这意味着您的所有 API Key 等设置均存储在宿主机上，即使删除并重新创建容器，只要挂载路径不变，配置便会自动加载。