一、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），請(qǐng)耐心等待，不會(huì)再出現(xiàn)超時(shí)中斷。

3. 啟動(dòng) OpenClaw 容器

鏡像拉取完成后，啟動(dòng)容器即可：

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

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

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

1. 登錄 騰訊云控制臺(tái) → 進(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è)置管理員賬號(hào)密碼，即可進(jìn)入 OpenClaw 管理面板，開始配置 AI 智能體。

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

Q1：為什么騰訊云鏡像源拉取 OpenClaw 失敗？

A：騰訊云官方鏡像源未同步 OpenClaw 鏡像，因此直接拉取會(huì)提示 manifest unknown，建議使用中科大鏡像源或直連 GHCR。

Q2：拉取 GHCR 鏡像速度慢怎么辦？

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

Q3：容器啟動(dòng)后外網(wǎng)無法訪問？

A：檢查騰訊云安全組是否放行 18789 端口，同時(shí)確認(rèn)服務(wù)器防火墻未攔截該端口。

四、總結(jié)

通過配置國內(nèi)鏡像源、直連 GHCR 官方鏡像、放行安全組三步，即可在騰訊云服務(wù)器上順利部署 OpenClaw，徹底解決 Docker 拉取超時(shí)問題。

到此這篇關(guān)于騰訊云OpenClaw部署之解決Docker鏡像拉取超時(shí)的文章就介紹到這了,更多相關(guān)騰訊云OpenClaw拉取Docker鏡像超時(shí)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論