**Environment/network test import:** `openclaw/plugin-sdk/test-env`

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

The testing subpath exports a narrow set of helpers for plugin authors:

```typescript

import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime";

import { describeOpenAIProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts";

import { withEnv, withFetchPreconnect } from "openclaw/plugin-sdk/test-env";

import { createCliRuntimeCapture, typedCases } from "openclaw/plugin-sdk/test-fixtures";

```

### Available exports

| Export | Purpose |

| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |

| `createTestPluginApi` | Build a minimal plugin API mock for direct registration unit tests. Import from `plugin-sdk/plugin-test-api` |

| `expectChannelInboundContextContract` | Assert channel inbound context shape. Import from `plugin-sdk/channel-contract-testing` |

| `installChannelOutboundPayloadContractSuite` | Install channel outbound payload contract cases. Import from `plugin-sdk/channel-contract-testing` |

| `createStartAccountContext` | Build channel account lifecycle contexts. Import from `plugin-sdk/channel-test-helpers` |

| `describePluginRegistrationContract` | Install plugin registration contract checks. Import from `plugin-sdk/plugin-test-contracts` |

| `registerSingleProviderPlugin` | Register one provider plugin in loader smoke tests. Import from `plugin-sdk/plugin-test-runtime` |

| `registerProviderPlugin` | Capture all provider kinds from one plugin. Import from `plugin-sdk/plugin-test-runtime` |

| `registerProviderPlugins` | Capture provider registrations across multiple plugins. Import from `plugin-sdk/plugin-test-runtime` |

| `requireRegisteredProvider` | Assert that a provider collection contains an id. Import from `plugin-sdk/plugin-test-runtime` |

| `createRuntimeEnv` | Build a mocked CLI/plugin runtime environment. Import from `plugin-sdk/plugin-test-runtime` |

| `createPluginSetupWizardStatus` | Build setup status helpers for channel plugins. Import from `plugin-sdk/plugin-test-runtime` |

| `describeOpenAIProviderRuntimeContract` | Install provider-family runtime contract checks. Import from `plugin-sdk/provider-test-contracts` |

| `installCommonResolveTargetErrorCases` | Shared test cases for target resolution error handling |

| `shouldAckReaction` | Check whether a channel should add an ack reaction |

| `removeAckReactionAfterReply` | Remove ack reaction after reply delivery |

| `createTestRegistry` | Build a channel plugin registry fixture |

| `createEmptyPluginRegistry` | Build an empty plugin registry fixture |

| `setActivePluginRegistry` | Install a registry fixture for plugin runtime tests |

| `createRequestCaptureJsonFetch` | Capture JSON fetch requests in media helper tests. Import from `plugin-sdk/test-env` |

| `withFetchPreconnect` | Run fetch tests with preconnect hooks installed. Import from `plugin-sdk/test-env` |

| `withEnv` / `withEnvAsync` | Temporarily patch environment variables. Import from `plugin-sdk/test-env` |

| `createTempHomeEnv` / `withTempDir` | Create isolated filesystem test fixtures. Import from `plugin-sdk/test-env` |

| `createMockServerResponse` | Create a minimal HTTP server response mock. Import from `plugin-sdk/test-env` |

| `runProviderCatalog` | Execute a provider catalog hook with test dependencies |

| `resolveProviderWizardOptions` | Resolve provider setup wizard choices in contract tests |

| `resolveProviderModelPickerEntries` | Resolve provider model-picker entries in contract tests |

| `buildProviderPluginMethodChoice` | Build provider wizard choice ids for assertions |

| `setProviderWizardProvidersResolverForTest` | Inject provider wizard providers for isolated tests |

| `createProviderUsageFetch` | Build provider usage fetch fixtures |

| `useFrozenTime` / `useRealTime` | Freeze and restore timers for time-sensitive tests. Import from `plugin-sdk/test-env` |

| `createTestWizardPrompter` | Build a mocked setup wizard prompter |

| `createRuntimeTaskFlow` | Create isolated runtime task-flow state |

| `typedCases` | Preserve literal types for table-driven tests |

| Export | Purpose |

| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |

| `createTestPluginApi` | Build a minimal plugin API mock for direct registration unit tests. Import from `plugin-sdk/plugin-test-api` |

| `expectChannelInboundContextContract` | Assert channel inbound context shape. Import from `plugin-sdk/channel-contract-testing` |

| `installChannelOutboundPayloadContractSuite` | Install channel outbound payload contract cases. Import from `plugin-sdk/channel-contract-testing` |

| `createStartAccountContext` | Build channel account lifecycle contexts. Import from `plugin-sdk/channel-test-helpers` |

| `describePluginRegistrationContract` | Install plugin registration contract checks. Import from `plugin-sdk/plugin-test-contracts` |

| `registerSingleProviderPlugin` | Register one provider plugin in loader smoke tests. Import from `plugin-sdk/plugin-test-runtime` |

| `registerProviderPlugin` | Capture all provider kinds from one plugin. Import from `plugin-sdk/plugin-test-runtime` |

| `registerProviderPlugins` | Capture provider registrations across multiple plugins. Import from `plugin-sdk/plugin-test-runtime` |

| `requireRegisteredProvider` | Assert that a provider collection contains an id. Import from `plugin-sdk/plugin-test-runtime` |

| `createRuntimeEnv` | Build a mocked CLI/plugin runtime environment. Import from `plugin-sdk/plugin-test-runtime` |

| `createPluginSetupWizardStatus` | Build setup status helpers for channel plugins. Import from `plugin-sdk/plugin-test-runtime` |

| `describeOpenAIProviderRuntimeContract` | Install provider-family runtime contract checks. Import from `plugin-sdk/provider-test-contracts` |

| `installCommonResolveTargetErrorCases` | Shared test cases for target resolution error handling |

| `shouldAckReaction` | Check whether a channel should add an ack reaction |

| `removeAckReactionAfterReply` | Remove ack reaction after reply delivery |

| `createTestRegistry` | Build a channel plugin registry fixture |

| `createEmptyPluginRegistry` | Build an empty plugin registry fixture |

| `setActivePluginRegistry` | Install a registry fixture for plugin runtime tests |

| `createRequestCaptureJsonFetch` | Capture JSON fetch requests in media helper tests. Import from `plugin-sdk/test-env` |

| `withFetchPreconnect` | Run fetch tests with preconnect hooks installed. Import from `plugin-sdk/test-env` |

| `withEnv` / `withEnvAsync` | Temporarily patch environment variables. Import from `plugin-sdk/test-env` |

| `createTempHomeEnv` / `withTempDir` | Create isolated filesystem test fixtures. Import from `plugin-sdk/test-env` |

| `createMockServerResponse` | Create a minimal HTTP server response mock. Import from `plugin-sdk/test-env` |

| `createCliRuntimeCapture` | Capture CLI runtime output in tests. Import from `plugin-sdk/test-fixtures` |

| `createSandboxTestContext` | Build sandbox test contexts. Import from `plugin-sdk/test-fixtures` |

| `writeSkill` | Write skill fixtures. Import from `plugin-sdk/test-fixtures` |

| `makeAgentAssistantMessage` | Build agent transcript message fixtures. Import from `plugin-sdk/test-fixtures` |

| `peekSystemEvents` / `resetSystemEventsForTest` | Inspect and reset system event fixtures. Import from `plugin-sdk/test-fixtures` |

| `sanitizeTerminalText` | Sanitize terminal output for assertions. Import from `plugin-sdk/test-fixtures` |

| `countLines` / `hasBalancedFences` | Assert chunking output shape. Import from `plugin-sdk/test-fixtures` |

| `runProviderCatalog` | Execute a provider catalog hook with test dependencies |

| `resolveProviderWizardOptions` | Resolve provider setup wizard choices in contract tests |

| `resolveProviderModelPickerEntries` | Resolve provider model-picker entries in contract tests |

| `buildProviderPluginMethodChoice` | Build provider wizard choice ids for assertions |

| `setProviderWizardProvidersResolverForTest` | Inject provider wizard providers for isolated tests |

| `createProviderUsageFetch` | Build provider usage fetch fixtures |

| `useFrozenTime` / `useRealTime` | Freeze and restore timers for time-sensitive tests. Import from `plugin-sdk/test-env` |

| `createTestWizardPrompter` | Build a mocked setup wizard prompter |

| `createRuntimeTaskFlow` | Create isolated runtime task-flow state |

| `typedCases` | Preserve literal types for table-driven tests. Import from `plugin-sdk/test-fixtures` |

Bundled-plugin contract suites also use SDK testing subpaths for test-only

registry, manifest, public-artifact, and runtime fixture helpers. Core-only

documented SDK subpath such as `plugin-sdk/plugin-test-api` or

`plugin-sdk/channel-contract-testing`, `plugin-sdk/channel-test-helpers`,

`plugin-sdk/plugin-test-contracts`, `plugin-sdk/plugin-test-runtime`,

`plugin-sdk/provider-test-contracts`, or `plugin-sdk/test-env` rather than

`plugin-sdk/provider-test-contracts`, `plugin-sdk/test-env`, or

`plugin-sdk/test-fixtures` rather than

importing repo `src/**` files or repo `test/helpers/plugins/*` bridges directly.

### Types