branches: [main]

pull_request:

types: [opened, reopened, synchronize, ready_for_review, converted_to_draft]

schedule:

- cron: "17 3 * * *"

workflow_dispatch:

permissions:

outputs:

docs_only: ${{ steps.manifest.outputs.docs_only }}

run_install_smoke: ${{ steps.manifest.outputs.run_install_smoke }}

run_fast_install_smoke: ${{ steps.manifest.outputs.run_fast_install_smoke }}

run_full_install_smoke: ${{ steps.manifest.outputs.run_full_install_smoke }}

steps:

- name: Checkout

uses: actions/checkout@v6

submodules: false

- name: Ensure preflight base commit

if: github.event_name != 'workflow_dispatch'

if: github.event_name != 'workflow_dispatch' && github.event_name != 'schedule'

uses: ./.github/actions/ensure-base-commit

with:

base-sha: ${{ github.event_name == 'push' && github.event.before || github.event.pull_request.base.sha }}

- name: Detect changed smoke scope

id: changed_scope

if: github.event_name != 'workflow_dispatch' && steps.docs_scope.outputs.docs_only != 'true'

if: github.event_name != 'workflow_dispatch' && github.event_name != 'schedule' && steps.docs_scope.outputs.docs_only != 'true'

shell: bash

run: |

set -euo pipefail

id: manifest

env:

OPENCLAW_CI_DOCS_ONLY: ${{ steps.docs_scope.outputs.docs_only }}

OPENCLAW_CI_FORCE_INSTALL_SMOKE: ${{ github.event_name == 'workflow_dispatch' && 'true' || 'false' }}

OPENCLAW_CI_RUN_CHANGED_SMOKE: ${{ steps.changed_scope.outputs.run_changed_smoke || 'false' }}

OPENCLAW_CI_FORCE_FULL_INSTALL_SMOKE: ${{ (github.event_name == 'workflow_dispatch' || github.event_name == 'schedule' || github.event_name == 'push') && 'true' || 'false' }}

OPENCLAW_CI_RUN_FAST_INSTALL_SMOKE: ${{ steps.changed_scope.outputs.run_fast_install_smoke || steps.changed_scope.outputs.run_changed_smoke || 'false' }}

OPENCLAW_CI_RUN_FULL_INSTALL_SMOKE: ${{ steps.changed_scope.outputs.run_full_install_smoke || 'false' }}

run: |

docs_only="${OPENCLAW_CI_DOCS_ONLY:-false}"

force_install_smoke="${OPENCLAW_CI_FORCE_INSTALL_SMOKE:-false}"

run_changed_smoke="${OPENCLAW_CI_RUN_CHANGED_SMOKE:-false}"

force_full_install_smoke="${OPENCLAW_CI_FORCE_FULL_INSTALL_SMOKE:-false}"

run_changed_fast_install_smoke="${OPENCLAW_CI_RUN_FAST_INSTALL_SMOKE:-false}"

run_changed_full_install_smoke="${OPENCLAW_CI_RUN_FULL_INSTALL_SMOKE:-false}"

run_fast_install_smoke=false

run_full_install_smoke=false

run_install_smoke=false

if [ "$force_install_smoke" = "true" ]; then

if [ "$force_full_install_smoke" = "true" ]; then

run_fast_install_smoke=true

run_full_install_smoke=true

run_install_smoke=true

elif [ "$docs_only" != "true" ] && [ "$run_changed_smoke" = "true" ]; then

elif [ "$docs_only" != "true" ] && [ "$run_changed_full_install_smoke" = "true" ]; then

run_fast_install_smoke=true

run_full_install_smoke=true

run_install_smoke=true

elif [ "$docs_only" != "true" ] && [ "$run_changed_fast_install_smoke" = "true" ]; then

run_fast_install_smoke=true

run_install_smoke=true

fi

{

echo "docs_only=$docs_only"

echo "run_install_smoke=$run_install_smoke"

echo "run_fast_install_smoke=$run_fast_install_smoke"

echo "run_full_install_smoke=$run_full_install_smoke"

} >> "$GITHUB_OUTPUT"

install-smoke-fast:

needs: [preflight]

if: needs.preflight.outputs.run_fast_install_smoke == 'true' && needs.preflight.outputs.run_full_install_smoke != 'true'

runs-on: blacksmith-16vcpu-ubuntu-2404

env:

DOCKER_BUILD_SUMMARY: "false"

DOCKER_BUILD_RECORD_UPLOAD: "false"

steps:

- name: Checkout CLI

uses: actions/checkout@v6

- name: Set up Blacksmith Docker Builder

uses: useblacksmith/setup-docker-builder@ac083cc84672d01c60d5e8561d0a939b697de542 # v1

# Blacksmith's builder owns the Docker layer cache; keep smoke builds off

# explicit gha cache directives so local tags still load cleanly.

- name: Build root Dockerfile smoke image

uses: useblacksmith/build-push-action@cbd1f60d194a98cb3be5523b15134501eaf0fbf3 # v2

with:

context: .

file: ./Dockerfile

build-args: |

OPENCLAW_DOCKER_APT_UPGRADE=0

OPENCLAW_EXTENSIONS=matrix

tags: |

openclaw-dockerfile-smoke:local

openclaw-ext-smoke:local

load: true

push: false

provenance: false

- name: Run root Dockerfile CLI smoke

run: |

docker run --rm --entrypoint sh openclaw-dockerfile-smoke:local -lc 'which openclaw && openclaw --version'

- name: Run Docker gateway network e2e

env:

OPENCLAW_GATEWAY_NETWORK_E2E_IMAGE: openclaw-dockerfile-smoke:local

OPENCLAW_GATEWAY_NETWORK_E2E_SKIP_BUILD: "1"

run: bash scripts/e2e/gateway-network-docker.sh

- name: Smoke test Dockerfile with matrix extension build arg

run: |

docker run --rm --entrypoint sh openclaw-ext-smoke:local -lc '

which openclaw &&

openclaw --version &&

node -e "

const Module = require(\"node:module\");

const matrixPackage = require(\"/app/extensions/matrix/package.json\");

const requireFromMatrix = Module.createRequire(\"/app/extensions/matrix/package.json\");

const runtimeDeps = Object.keys(matrixPackage.dependencies ?? {});

if (runtimeDeps.length === 0) {

throw new Error(

\"matrix package has no declared runtime dependencies; smoke cannot validate install mirroring\",

);

}

for (const dep of runtimeDeps) {

requireFromMatrix.resolve(dep);

}

const { spawnSync } = require(\"node:child_process\");

const run = spawnSync(\"openclaw\", [\"plugins\", \"list\", \"--json\"], { encoding: \"utf8\" });

if (run.status !== 0) {

process.stderr.write(run.stderr || run.stdout || \"plugins list failed\\n\");

process.exit(run.status ?? 1);

}

const parsed = JSON.parse(run.stdout);

const matrix = (parsed.plugins || []).find((entry) => entry.id === \"matrix\");

if (!matrix) {

throw new Error(\"matrix plugin missing from bundled plugin list\");

}

const matrixDiag = (parsed.diagnostics || []).filter(

(diag) =>

typeof diag.source === \"string\" &&

diag.source.includes(\"/extensions/matrix\") &&

typeof diag.message === \"string\" &&

diag.message.includes(\"extension entry escapes package directory\"),

);

if (matrixDiag.length > 0) {

throw new Error(

\"unexpected matrix diagnostics: \" +

matrixDiag.map((diag) => diag.message).join(\"; \"),

);

}

"

'

install-smoke:

needs: [preflight]

if: needs.preflight.outputs.run_install_smoke == 'true'

if: needs.preflight.outputs.run_full_install_smoke == 'true'

runs-on: blacksmith-16vcpu-ubuntu-2404

env:

DOCKER_BUILD_SUMMARY: "false"

docker-e2e-fast:

needs: [preflight]

if: needs.preflight.outputs.run_install_smoke == 'true'

if: needs.preflight.outputs.run_fast_install_smoke == 'true' || needs.preflight.outputs.run_full_install_smoke == 'true'

runs-on: blacksmith-16vcpu-ubuntu-2404

timeout-minutes: 8

env: