- Channels/QQBot: add full group chat support (history tracking, @-mention gating, activation modes, per-group config, FIFO message queue with deliver debounce), C2C `stream_messages` streaming with a `StreamingController` lifecycle manager, unified `sendMedia` with chunked upload for large files, and refactor the engine into pipeline stages, focused outbound submodules, builtin slash-command modules, and explicit DI ports via `createEngineAdapters()`. (#70624) Thanks @cxyhhhhh.

- Gateway/runtime: reuse the current plugin metadata snapshot for provider discovery so repeated model-provider discovery avoids rebuilding plugin manifest metadata. Thanks @shakkernerd.

- Gateway/startup: pass the plugin metadata snapshot from config validation into plugin bootstrap so startup reuses one manifest product instead of rebuilding plugin metadata. Thanks @shakkernerd.

- Plugin SDK/testing: move core-only channel contract fixtures under the channel contract test tree and retire the old `test/helpers/channels` bridge directory so plugin tests stay on focused SDK surfaces. Thanks @vincentkoc.

- Plugin SDK/testing: promote bundled plugin/provider/channel contract helpers to focused SDK test subpaths and retire the repo-only `test/helpers/plugins` TypeScript bridge. Thanks @vincentkoc.

- Plugin SDK/testing: expose generic channel action, setup, status, and directory contract helpers through `plugin-sdk/channel-test-helpers` so bundled extension tests no longer import repo-only channel helper bridges. Thanks @vincentkoc.

- Plugin SDK/testing: add `plugin-sdk/channel-target-testing` for shared channel target-resolution cases, document channel reaction helpers on `plugin-sdk/channel-feedback`, and keep the old `plugin-sdk/test-utils` alias as compatibility-only. Thanks @vincentkoc.

## Test utilities

**Compatibility import:** `openclaw/plugin-sdk/testing`

**Plugin API mock import:** `openclaw/plugin-sdk/plugin-test-api`

**Channel contract import:** `openclaw/plugin-sdk/channel-contract-testing`

**Generic fixture import:** `openclaw/plugin-sdk/test-fixtures`

Prefer the focused subpaths below for new plugin tests. The broad

`openclaw/plugin-sdk/testing` barrel remains for compatibility with older tests

and helpers that have not moved to a narrower documented surface yet.

`openclaw/plugin-sdk/testing` barrel is legacy compatibility only.

```typescript

import {

### Types

The testing subpath also re-exports types useful in test files:

Focused testing subpaths also re-export types useful in test files:

```typescript

import type {

ChannelAccountSnapshot,

ChannelGatewayContext,

OpenClawConfig,

PluginRuntime,

RuntimeEnv,

MockFn,

} from "openclaw/plugin-sdk/testing";

} from "openclaw/plugin-sdk/channel-contract";

import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";

import type { MockFn, PluginRuntime, RuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";

```

## Testing target resolution

- Test wrapper runs end with a short `[test] passed|failed|skipped ... in ...` summary. Vitest's own duration line stays the per-shard detail.

- Full, extension, and include-pattern shard runs update local timing data in `.artifacts/vitest-shard-timings.json`; later whole-config runs use those timings to balance slow and fast shards. Include-pattern CI shards append the shard name to the timing key, which keeps filtered shard timings visible without replacing whole-config timing data. Set `OPENCLAW_TEST_PROJECTS_TIMINGS=0` to ignore the local timing artifact.

- Selected `plugin-sdk` and `commands` test files now route through dedicated light lanes that keep only `test/setup.ts`, leaving runtime-heavy cases on their existing lanes.

- Source files with sibling tests map to that sibling before falling back to wider directory globs. Helper edits under `test/helpers/channels`, `src/plugin-sdk/test-helpers`, and `src/plugins/contracts` use a local import graph to run importing tests instead of broad-running every shard when the dependency path is precise.

- Source files with sibling tests map to that sibling before falling back to wider directory globs. Helper edits under `src/channels/plugins/contracts/test-helpers`, `src/plugin-sdk/test-helpers`, and `src/plugins/contracts` use a local import graph to run importing tests instead of broad-running every shard when the dependency path is precise.

- `auto-reply` now also splits into three dedicated configs (`core`, `top-level`, `reply`) so the reply harness does not dominate the lighter top-level status/token/helper tests.

- Base Vitest config now defaults to `pool: "threads"` and `isolate: false`, with the shared non-isolated runner enabled across the repo configs.

- `pnpm test:channels` runs `vitest.channels.config.ts`.

pattern: /["'](?:\.\.\/)+(?:test\/helpers\/channels\/)[^"']+["']/,

hint: "Use openclaw/plugin-sdk/channel-test-helpers or another focused SDK test subpath instead of repo-only channel helper bridges.",

},

{

pattern: /["'](?:\.\.\/)+(?:src\/channels\/plugins\/contracts\/test-helpers\/)[^"']+["']/,

hint: "Use openclaw/plugin-sdk/channel-test-helpers or another focused SDK test subpath instead of core-only channel contract helpers.",

},

{

pattern: /["'](?:\.\.\/)+(?:src\/test-utils\/)[^"']+["']/,

hint: "Use a documented openclaw/plugin-sdk test subpath for public surfaces.",

function main() {

const extensionsDir = path.join(process.cwd(), "extensions");

const pluginHelpersDir = path.join(process.cwd(), "test/helpers/plugins");

const retiredChannelHelpersDir = path.join(process.cwd(), "test/helpers/channels");

const files = collectExtensionTestFiles(extensionsDir);

const pluginHelperFiles = collectPluginHelperFiles(pluginHelpersDir);

const retiredChannelHelperFiles = fs.existsSync(retiredChannelHelpersDir)

? collectFilesSync(retiredChannelHelpersDir, { includeFile: isCodeFile })

: [];

const offenders: Offender[] = [];

for (const file of retiredChannelHelperFiles) {

offenders.push({

file,

hint: "Keep core channel contract helpers under src/channels/plugins/contracts/test-helpers and public plugin helpers under focused openclaw/plugin-sdk test subpaths.",

});

}

for (const file of RETIRED_EXTENSION_TEST_HELPER_BRIDGE_FILES) {

const filePath = path.join(process.cwd(), file);

if (!fs.existsSync(filePath)) {

describeBundledMetadataOnlyChannelCatalogContract,

describeChannelCatalogEntryContract,

describeOfficialFallbackChannelCatalogContract,

} from "../../../../test/helpers/channels/channel-catalog-contract.js";

} from "./test-helpers/channel-catalog-contract.js";

describeChannelCatalogEntryContract({

channelId: "msteams",

import { installDirectoryContractRegistryShard } from "../../../../test/helpers/channels/registry-backed-contract-shards.js";

import { installDirectoryContractRegistryShard } from "./test-helpers/registry-backed-contract-shards.js";

installDirectoryContractRegistryShard({ shardIndex: 0, shardCount: 8 });

import { installDirectoryContractRegistryShard } from "../../../../test/helpers/channels/registry-backed-contract-shards.js";

import { installDirectoryContractRegistryShard } from "./test-helpers/registry-backed-contract-shards.js";

installDirectoryContractRegistryShard({ shardIndex: 1, shardCount: 8 });

import { installDirectoryContractRegistryShard } from "../../../../test/helpers/channels/registry-backed-contract-shards.js";

import { installDirectoryContractRegistryShard } from "./test-helpers/registry-backed-contract-shards.js";

installDirectoryContractRegistryShard({ shardIndex: 2, shardCount: 8 });

import { installDirectoryContractRegistryShard } from "../../../../test/helpers/channels/registry-backed-contract-shards.js";

import { installDirectoryContractRegistryShard } from "./test-helpers/registry-backed-contract-shards.js";

installDirectoryContractRegistryShard({ shardIndex: 3, shardCount: 8 });

import { installDirectoryContractRegistryShard } from "../../../../test/helpers/channels/registry-backed-contract-shards.js";

import { installDirectoryContractRegistryShard } from "./test-helpers/registry-backed-contract-shards.js";

installDirectoryContractRegistryShard({ shardIndex: 4, shardCount: 8 });