feat: dual-push GHCR + Alibaba Cloud ACR for China users

Author: 1186258278

.github/workflows/build-push.yml

@@ -16,7 +16,8 @@ on:
         default: 'zh'
 
 env:
-  REGISTRY: ghcr.io
+  GHCR_REGISTRY: ghcr.io
+  ALIYUN_REGISTRY: registry.cn-hangzhou.aliyuncs.com
   IMAGE_NAME: qingchencloud/openclaw
 
 jobs:
@@ -46,15 +47,27 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
+      # ── 登录 GHCR（国际源） ──
       - name: Login to GHCR
         uses: docker/login-action@v3
         with:
-          registry: ${{ env.REGISTRY }}
+          registry: ${{ env.GHCR_REGISTRY }}
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
+      # ── 登录阿里云 ACR（国内源，可选） ──
+      - name: Login to Alibaba Cloud ACR
+        if: ${{ secrets.ALIYUN_ACR_USERNAME != '' }}
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.ALIYUN_REGISTRY }}
+          username: ${{ secrets.ALIYUN_ACR_USERNAME }}
+          password: ${{ secrets.ALIYUN_ACR_PASSWORD }}
+
       - name: Determine version and tags
         id: meta
+        env:
+          HAS_ALIYUN: ${{ secrets.ALIYUN_ACR_USERNAME != '' }}
         run: |
           VERSION="${{ github.event.inputs.openclaw_version || 'latest' }}"
           SOURCE="${{ github.event.inputs.openclaw_source || 'zh' }}"
@@ -65,15 +78,25 @@ jobs:
           fi
 
           SUFFIX="${{ matrix.tag_suffix }}"
-          TAGS="${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest${SUFFIX}"
 
+          # GHCR 标签
+          TAGS="${{ env.GHCR_REGISTRY }}/${{ env.IMAGE_NAME }}:latest${SUFFIX}"
           if [ "$VERSION" != "latest" ]; then
-            TAGS="${TAGS},${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${VERSION}${SUFFIX}"
+            TAGS="${TAGS},${{ env.GHCR_REGISTRY }}/${{ env.IMAGE_NAME }}:${VERSION}${SUFFIX}"
           fi
-
-          # 原版标签
           if [ "$SOURCE" = "official" ]; then
-            TAGS="${TAGS},${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:official${SUFFIX}"
+            TAGS="${TAGS},${{ env.GHCR_REGISTRY }}/${{ env.IMAGE_NAME }}:official${SUFFIX}"
+          fi
+
+          # 阿里云 ACR 标签（如果配置了）
+          if [ "$HAS_ALIYUN" = "true" ]; then
+            TAGS="${TAGS},${{ env.ALIYUN_REGISTRY }}/${{ env.IMAGE_NAME }}:latest${SUFFIX}"
+            if [ "$VERSION" != "latest" ]; then
+              TAGS="${TAGS},${{ env.ALIYUN_REGISTRY }}/${{ env.IMAGE_NAME }}:${VERSION}${SUFFIX}"
+            fi
+            if [ "$SOURCE" = "official" ]; then
+              TAGS="${TAGS},${{ env.ALIYUN_REGISTRY }}/${{ env.IMAGE_NAME }}:official${SUFFIX}"
+            fi
           fi
 
           echo "tags=${TAGS}" >> $GITHUB_OUTPUT
@@ -94,16 +117,18 @@ jobs:
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
-  update-description:
+  summary:
     needs: build-and-push
     runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/')
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Update GHCR description
+      - name: Print image locations
         run: |
-          echo "✅ Images built and pushed successfully"
-          echo "📦 ghcr.io/${{ env.IMAGE_NAME }}:latest"
-          echo "📦 ghcr.io/${{ env.IMAGE_NAME }}:gateway"
+          echo "✅ 镜像构建并推送成功"
+          echo ""
+          echo "📦 国际源（GHCR）:"
+          echo "   ghcr.io/${{ env.IMAGE_NAME }}:latest"
+          echo "   ghcr.io/${{ env.IMAGE_NAME }}:latest-gateway"
+          echo ""
+          echo "🇨🇳 国内源（阿里云 ACR）:"
+          echo "   ${{ env.ALIYUN_REGISTRY }}/${{ env.IMAGE_NAME }}:latest"
+          echo "   ${{ env.ALIYUN_REGISTRY }}/${{ env.IMAGE_NAME }}:latest-gateway"

README.md

@@ -50,6 +50,25 @@ docker run -d --name openclaw --restart unless-stopped \
 
 启动后打开 **http://localhost:1420**，模型已自动配好，直接可用。
 
+## 🇨🇳 国内加速
+
+GHCR 在国内拉取较慢，推荐使用阿里云镜像源：
+
+```bash
+# 国内用户推荐
+docker run -d --name openclaw --restart unless-stopped \
+  -p 1420:1420 -p 18789:18789 \
+  -v openclaw-data:/root/.openclaw \
+  registry.cn-hangzhou.aliyuncs.com/qingchencloud/openclaw:latest
+```
+
+| 源 | 地址 | 适用 |
+|---|------|------|
+| **阿里云 ACR** | `registry.cn-hangzhou.aliyuncs.com/qingchencloud/openclaw` | 🇨🇳 国内推荐 |
+| **GHCR** | `ghcr.io/qingchencloud/openclaw` | 🌍 国际 |
+
+两个源镜像完全一致，CI 自动双推。
+
 ## 镜像说明
 
 | 镜像标签 | 内容 | 适用场景 |