From 98c8920729b7374f89a8f49349d16710f9ec1729 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 23 Apr 2026 08:47:40 +0100
Subject: [PATCH] ci: add focused live model dispatch

---
 .../openclaw-live-and-e2e-checks-reusable.yml    | 16 +++++++++++++---
 docs/help/testing.md                             |  2 ++
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/openclaw-live-and-e2e-checks-reusable.yml b/.github/workflows/openclaw-live-and-e2e-checks-reusable.yml
index 65b2fad9a7a..7647153f96f 100644
--- a/.github/workflows/openclaw-live-and-e2e-checks-reusable.yml
+++ b/.github/workflows/openclaw-live-and-e2e-checks-reusable.yml
@@ -28,6 +28,11 @@ on:
         required: false
         default: true
         type: boolean
+      live_models_only:
+        description: Whether to run only the Docker live model matrix when live suites are enabled
+        required: false
+        default: false
+        type: boolean
   workflow_call:
     inputs:
       ref:
@@ -54,6 +59,11 @@ on:
         required: false
         default: true
         type: boolean
+      live_models_only:
+        description: Whether to run only the Docker live model matrix when live suites are enabled
+        required: false
+        default: false
+        type: boolean
     secrets:
       OPENAI_API_KEY:
         required: false
@@ -212,7 +222,7 @@ jobs:
 
   validate_release_live_cache:
     needs: validate_selected_ref
-    if: inputs.include_live_suites
+    if: inputs.include_live_suites && !inputs.live_models_only
     runs-on: blacksmith-8vcpu-ubuntu-2404
     timeout-minutes: 60
     env:
@@ -278,7 +288,7 @@ jobs:
 
   validate_special_e2e:
     needs: validate_selected_ref
-    if: inputs.include_repo_e2e || inputs.include_live_suites
+    if: inputs.include_repo_e2e || (inputs.include_live_suites && !inputs.live_models_only)
     runs-on: blacksmith-32vcpu-ubuntu-2404
     timeout-minutes: ${{ matrix.timeout_minutes }}
     strategy:
@@ -745,7 +755,7 @@ jobs:
 
   validate_live_provider_suites:
     needs: validate_selected_ref
-    if: inputs.include_live_suites
+    if: inputs.include_live_suites && !inputs.live_models_only
     runs-on: blacksmith-32vcpu-ubuntu-2404
     timeout-minutes: ${{ matrix.timeout_minutes }}
     strategy:
diff --git a/docs/help/testing.md b/docs/help/testing.md
index ffced1e0f86..c6042284f3d 100644
--- a/docs/help/testing.md
+++ b/docs/help/testing.md
@@ -44,6 +44,8 @@ When debugging real providers/models (requires real creds):
     `OpenClaw Release Checks` both call the reusable live/E2E workflow with
     `include_live_suites: true`, which includes separate Docker live model
     matrix jobs sharded by provider.
+  - For focused CI reruns, dispatch `OpenClaw Live And E2E Checks (Reusable)`
+    with `include_live_suites: true` and `live_models_only: true`.
   - Add new high-signal provider secrets to `scripts/ci-hydrate-live-auth.sh`
     plus `.github/workflows/openclaw-live-and-e2e-checks-reusable.yml` and its
     scheduled/release callers.