腾讯云 OpenClaw 部署：解决 Docker 镜像拉取超时

腾讯云部署 OpenClaw 保姆级教程：解决 Docker 镜像拉取超时问题

一、OpenClaw 部署痛点：Docker 镜像拉取超时

在腾讯云服务器部署 OpenClaw AI 智能体时，最常见的问题就是 Docker 镜像拉取超时（context deadline exceeded）。这是因为默认的 Docker Hub 国内访问不稳定，而腾讯云官方镜像源未同步 OpenClaw 镜像，导致拉取失败。

本文将提供一套经过实测的部署教程，帮助你一次性解决问题，顺利跑通 OpenClaw。

二、核心部署步骤

1. 配置国内 Docker 镜像源（提升拉取稳定性）

为了避免后续拉取失败，先配置中科大镜像源，这是国内最稳定的公共镜像源之一。

Bash # 写入中科大镜像源配置 cat > /etc/docker/daemon.json << 'EOF' {   "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"] } EOF # 彻底重启 Docker 服务，使配置生效 systemctl daemon-reload systemctl stop docker pkill docker systemctl start docker

2. 绕过 Docker Hub，直连 OpenClaw 官方镜像（终极避坑方案）

这是解决拉取超时的核心步骤：直接从 GitHub Container Registry（GHCR）拉取 OpenClaw 官方镜像，彻底绕过不稳定的 Docker Hub。

Bash # 进入 OpenClaw 项目目录（根据实际路径调整） cd /opt/openclaw # 直接拉取 GHCR 官方镜像 docker pull ghcr.io/openclaw/openclaw:latest

注意：此步骤下载时间较长（镜像约 650MB），请耐心等待，不会再出现超时中断。

3. 启动 OpenClaw 容器

镜像拉取完成后，启动容器即可：

Bash # 清理旧容器（如有） docker-compose down # 后台启动 OpenClaw docker-compose up -d # 验证容器状态（显示 Up 即为成功） docker ps

4. 放行腾讯云安全组（外网访问必备）

容器启动后，若外网无法访问，需在腾讯云控制台放行 18789 端口：

1. 登录 腾讯云控制台 → 进入服务器实例 → 左侧菜单选择「安全组」。

1. 找到绑定实例的安全组，点击「修改规则」→「添加入站规则」。

1. 配置如下：

• 来源：0.0.0.0/0

• 协议端口：TCP:18789

• 策略：允许

1. 保存规则，外网即可访问。

5. 访问 OpenClaw 管理面板

完成以上步骤后，通过浏览器访问：

Plain Text http://你的服务器公网IP:18789

首次访问设置管理员账号密码，即可进入 OpenClaw 管理面板，开始配置 AI 智能体。

三、部署常见问题解答（FAQ）

Q1：为什么腾讯云镜像源拉取 OpenClaw 失败？

A：腾讯云官方镜像源未同步 OpenClaw 镜像，因此直接拉取会提示 manifest unknown，建议使用中科大镜像源或直连 GHCR。

Q2：拉取 GHCR 镜像速度慢怎么办？

A：可配置 GHCR 代理源（如 https://ghcr.dockerproxy.com），提升拉取速度，配置方式与中科大镜像源一致。

Q3：容器启动后外网无法访问？

A：检查腾讯云安全组是否放行 18789 端口，同时确认服务器防火墙未拦截该端口。

四、总结

通过配置国内镜像源、直连 GHCR 官方镜像、放行安全组三步，即可在腾讯云服务器上顺利部署 OpenClaw，彻底解决 Docker 拉取超时问题。