一、OpenClaw 部署痛點(diǎn)：Docker 鏡像拉取超時(shí)

在騰訊云服務(wù)器部署 OpenClaw AI 智能體時(shí)，最常見的問題就是 Docker 鏡像拉取超時(shí)（context deadline exceeded）。這是因?yàn)槟J(rèn)的 Docker Hub 國內(nèi)訪問不穩(wěn)定，而騰訊云官方鏡像源未同步 OpenClaw 鏡像，導(dǎo)致拉取失敗。

本文將提供一套經(jīng)過實(shí)測的部署教程，幫助你一次性解決問題，順利跑通 OpenClaw。

二、核心部署步驟

1. 配置國內(nèi) Docker 鏡像源（提升拉取穩(wěn)定性）

為了避免后續(xù)拉取失敗，先配置中科大鏡像源，這是國內(nèi)最穩(wěn)定的公共鏡像源之一。

# 寫入中科大鏡像源配置
cat > /etc/docker/daemon.json << 'EOF'
{
??"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
# 徹底重啟 Docker 服務(wù)，使配置生效
systemctl daemon-reload
systemctl stop docker
pkill docker
systemctl start docker

2. 繞過 Docker Hub，直連 OpenClaw 官方鏡像（終極避坑方案）

這是解決拉取超時(shí)的核心步驟：直接從 GitHub Container Registry（GHCR）拉取 OpenClaw 官方鏡像，徹底繞過不穩(wěn)定的 Docker Hub。

# 進(jìn)入 OpenClaw 項(xiàng)目目錄（根據(jù)實(shí)際路徑調(diào)整）
cd /opt/openclaw
# 直接拉取 GHCR 官方鏡像
docker pull ghcr.io/openclaw/openclaw:latest

注意：此步驟下載時(shí)間較長（鏡像約 650MB），請耐心等待，不會再出現(xiàn)超時(shí)中斷。

3. 啟動 OpenClaw 容器

鏡像拉取完成后，啟動容器即可：

# 清理舊容器（如有）
docker-compose down
# 后臺啟動 OpenClaw
docker-compose up -d
# 驗(yàn)證容器狀態(tài)（顯示 Up 即為成功）
docker ps

4. 放行騰訊云安全組（外網(wǎng)訪問必備）

容器啟動后，若外網(wǎng)無法訪問，需在騰訊云控制臺放行 18789 端口：

1. 登錄 騰訊云控制臺 → 進(jìn)入服務(wù)器實(shí)例 → 左側(cè)菜單選擇「安全組」。

1. 找到綁定實(shí)例的安全組，點(diǎn)擊「修改規(guī)則」→「添加入站規(guī)則」。

1. 配置如下：

• 來源：0.0.0.0/0

• 協(xié)議端口：TCP:18789

• 策略：允許

1. 保存規(guī)則，外網(wǎng)即可訪問。

5. 訪問 OpenClaw 管理面板

完成以上步驟后，通過瀏覽器訪問：

Plain Text
http://你的服務(wù)器公網(wǎng)IP:18789

首次訪問設(shè)置管理員賬號密碼，即可進(jìn)入 OpenClaw 管理面板，開始配置 AI 智能體。

三、部署常見問題解答（FAQ）

Q1：為什么騰訊云鏡像源拉取 OpenClaw 失?。?/strong>