- src/plugins/bundled-dir.ts

- src/plugins/bundled-plugin-metadata.ts

- src/plugins/bundled-public-surface-runtime-root.ts

- src/plugins/bundled-runtime-deps.ts

- src/plugins/bundled-runtime-root.ts

- src/plugins/plugin-sdk-dist-alias.ts

- src/plugins/captured-registration.ts

- src/plugins/config-activation-shared.ts

- src/plugins/config-contracts.ts

- src/plugins/bundled-dir.ts

- src/plugins/bundled-plugin-metadata.ts

- src/plugins/bundled-plugin-scan.ts

- src/plugins/bundled-runtime-deps*.ts

- src/plugins/bundled-runtime-root.ts

- src/plugins/plugin-sdk-dist-alias.ts

- src/plugins/cli-registry-loader.ts

- src/plugins/config-activation-shared.ts

- src/plugins/config-contracts.ts

- name: Smoke test built bundled plugin singleton

run: pnpm test:build:singleton

- name: Smoke test built bundled runtime deps

run: pnpm test:build:bundled-runtime-deps

- name: Check CLI startup memory

run: pnpm test:startup:memory

with:

install-bun: "false"

install-deps: "true"

- name: Run fast bundled plugin Docker E2E

env:

OPENCLAW_BUNDLED_CHANNEL_DEPS_E2E_IMAGE: openclaw-bundled-channel-fast:local

OPENCLAW_BUNDLED_CHANNEL_DOCKER_RUN_TIMEOUT: 90s

run: timeout 480s pnpm test:docker:bundled-channel-deps:fast

- chunk_id: plugins-runtime-install-h

label: plugins/runtime install H

timeout_minutes: 120

- chunk_id: bundled-channels-core

label: bundled channels core

timeout_minutes: 90

- chunk_id: bundled-channels-update-a

label: bundled channels update A

timeout_minutes: 45

- chunk_id: bundled-channels-update-discord

label: bundled channels update Discord

timeout_minutes: 30

- chunk_id: bundled-channels-update-b

label: bundled channels update B

timeout_minutes: 45

- chunk_id: bundled-channels-contracts

label: bundled channels contracts

timeout_minutes: 90

env:

OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

OPENAI_BASE_URL: ${{ secrets.OPENAI_BASE_URL }}

artifact_name: ${{ needs.prepare_release_package.outputs.artifact_name }}

package_sha256: ${{ needs.prepare_release_package.outputs.package_sha256 }}

suite_profile: custom

docker_lanes: bundled-channel-deps-compat plugins-offline

docker_lanes: plugins-offline plugin-update

telegram_mode: mock-openai

telegram_scenarios: telegram-help-command,telegram-commands-command,telegram-tools-compact-command,telegram-whoami-command,telegram-context-command,telegram-mention-gating

secrets:

docker_lanes="npm-onboard-channel-agent gateway-network config-reload"

;;

package)

docker_lanes="npm-onboard-channel-agent doctor-switch update-channel-switch upgrade-survivor published-upgrade-survivor bundled-channel-deps-compat plugins-offline plugin-update"

docker_lanes="npm-onboard-channel-agent doctor-switch update-channel-switch upgrade-survivor published-upgrade-survivor plugins-offline plugin-update"

;;

product)

docker_lanes="npm-onboard-channel-agent doctor-switch update-channel-switch upgrade-survivor published-upgrade-survivor bundled-channel-deps-compat plugins plugin-update mcp-channels cron-mcp-cleanup openai-web-search-minimal openwebui"

docker_lanes="npm-onboard-channel-agent doctor-switch update-channel-switch upgrade-survivor published-upgrade-survivor plugins plugin-update mcp-channels cron-mcp-cleanup openai-web-search-minimal openwebui"

include_openwebui=true

;;

full)

COPY ui/package.json ./ui/package.json

COPY patches ./patches

COPY scripts/postinstall-bundled-plugins.mjs scripts/preinstall-package-manager-warning.mjs scripts/npm-runner.mjs scripts/windows-cmd-helpers.mjs ./scripts/

COPY scripts/lib/bundled-runtime-deps-install.mjs ./scripts/lib/bundled-runtime-deps-install.mjs

COPY scripts/lib/package-dist-imports.mjs ./scripts/lib/package-dist-imports.mjs

COPY --from=ext-deps /out/ ./${OPENCLAW_BUNDLED_PLUGIN_DIR}/

RUN ln -sf /app/openclaw.mjs /usr/local/bin/openclaw \

&& chmod 755 /app/openclaw.mjs

# Pre-create the default state and runtime-deps dirs so first-run Docker named

# volumes mounted here inherit node ownership instead of root-owned state.

# Pre-create the default state dir so first-run Docker named volumes mounted

# here inherit node ownership instead of root-owned state.

RUN install -d -m 0700 -o node -g node /home/node/.openclaw && \

install -d -m 0700 -o node -g node /var/lib/openclaw/plugin-runtime-deps && \

stat -c '%U:%G %a' /home/node/.openclaw | grep -qx 'node:node 700' && \

stat -c '%U:%G %a' /var/lib/openclaw/plugin-runtime-deps | grep -qx 'node:node 700'

stat -c '%U:%G %a' /home/node/.openclaw | grep -qx 'node:node 700'

ENV NODE_ENV=production

CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY:-}

CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY:-}

CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE:-}

OPENCLAW_PLUGIN_STAGE_DIR: /var/lib/openclaw/plugin-runtime-deps

TZ: ${OPENCLAW_TZ:-UTC}

volumes:

- ${OPENCLAW_CONFIG_DIR:-${HOME:-/tmp}/.openclaw}:/home/node/.openclaw

- ${OPENCLAW_WORKSPACE_DIR:-${HOME:-/tmp}/.openclaw/workspace}:/home/node/.openclaw/workspace

- openclaw-plugin-runtime-deps:/var/lib/openclaw/plugin-runtime-deps

## Uncomment the lines below to enable sandbox isolation

## (agents.defaults.sandbox). Requires Docker CLI in the image

## (build with --build-arg OPENCLAW_INSTALL_DOCKER_CLI=1) or use

CLAUDE_AI_SESSION_KEY: ${CLAUDE_AI_SESSION_KEY:-}

CLAUDE_WEB_SESSION_KEY: ${CLAUDE_WEB_SESSION_KEY:-}

CLAUDE_WEB_COOKIE: ${CLAUDE_WEB_COOKIE:-}

OPENCLAW_PLUGIN_STAGE_DIR: /var/lib/openclaw/plugin-runtime-deps

TZ: ${OPENCLAW_TZ:-UTC}

volumes:

- ${OPENCLAW_CONFIG_DIR:-${HOME:-/tmp}/.openclaw}:/home/node/.openclaw

- ${OPENCLAW_WORKSPACE_DIR:-${HOME:-/tmp}/.openclaw/workspace}:/home/node/.openclaw/workspace

- openclaw-plugin-runtime-deps:/var/lib/openclaw/plugin-runtime-deps

stdin_open: true

tty: true

init: true

entrypoint: ["node", "dist/index.js"]

depends_on:

- openclaw-gateway

volumes:

openclaw-plugin-runtime-deps:

plugin supports C2C private chat, group @messages, and guild channel messages with

rich media (images, voice, video, files).

Status: bundled plugin. Direct messages, group chats, guild channels, and

Status: downloadable plugin. Direct messages, group chats, guild channels, and

media are supported. Reactions and threads are not supported.

## Bundled plugin

## Install

Current OpenClaw releases bundle QQ Bot, so normal packaged builds do not need

a separate `openclaw plugins install` step.

Install QQ Bot before setup:

```bash

openclaw plugins install @openclaw/qqbot

```

## Setup