- Crabbox: keep AWS hydration compatible with local Actions replay by inlining the hydrate workflow's Node/pnpm setup instead of invoking repo-local composite actions.

- Agents/subagents: simplify native sub-agent completion handoff so children report their latest visible assistant result to the requester without using `message`, while keeping parent-owned message-tool delivery policy intact. Fixes #85070. (#85089) Thanks @brokemac79.

- Docker setup: stop printing the Gateway bearer token in setup logs and printed follow-up commands.

- Gateway: defer channel account startup work until HTTP readiness and remove startup model prewarm, avoiding startup event-loop stalls and timer-delay warnings.

- Models/perf: reuse plugin metadata during models.json planning, keep bundled catalog augmentation manifest/static, and use static provider catalogs for metadata-only startup discovery so provider model normalization, auth discovery, and Gateway startup metadata do not reload broad plugin runtimes.

- Agents: let embedded compaction fallback retries proceed when PI-compatible candidates do not need agent harness plugin preparation.

- Agents/tools: honor configured custom provider API keys when deciding whether media, image-generation, video-generation, music-generation, and PDF tools are available. (#85570)

- StepFun: stop advertising stale generic API key auth choices so onboarding only offers runtime-backed Standard and Step Plan choices.

Top-level fields:

| Field | Type | What it means |

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

| `providers` | `Record<string, object>` | Catalog rows for provider ids owned by this plugin. Keys should also appear in top-level `providers`. |

| `aliases` | `Record<string, object>` | Provider aliases that should resolve to an owned provider for catalog or suppression planning. |

| `suppressions` | `object[]` | Model rows from another source that this plugin suppresses for a provider-specific reason. |

| `discovery` | `Record<string, "static" \| "refreshable" \| "runtime">` | Whether the provider catalog can be read from manifest metadata, refreshed into cache, or requires runtime. |

| Field | Type | What it means |

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

| `providers` | `Record<string, object>` | Catalog rows for provider ids owned by this plugin. Keys should also appear in top-level `providers`. |

| `aliases` | `Record<string, object>` | Provider aliases that should resolve to an owned provider for catalog or suppression planning. |

| `suppressions` | `object[]` | Model rows from another source that this plugin suppresses for a provider-specific reason. |

| `discovery` | `Record<string, "static" \| "refreshable" \| "runtime">` | Whether the provider catalog can be read from manifest metadata, refreshed into cache, or requires runtime. |

| `runtimeAugment` | `boolean` | Set to `true` only when the provider runtime must append catalog rows after manifest/config planning. |

`aliases` participates in provider ownership lookup for model-catalog planning.

Alias targets must be top-level providers owned by the same plugin. When a

"enabledByDefault": true,

"providers": ["anthropic"],

"providerCatalogEntry": "./provider-discovery.ts",

"modelCatalog": {

"providers": {

"claude-cli": {

"models": [

{

"id": "claude-opus-4-7",

"name": "Claude Opus 4.7 (Claude CLI)",

"reasoning": true,

"input": ["text", "image"],

"contextWindow": 200000

},

{

"id": "claude-sonnet-4-6",

"name": "Claude Sonnet 4.6 (Claude CLI)",

"reasoning": true,

"input": ["text", "image"],

"contextWindow": 200000

},

{

"id": "claude-opus-4-6",

"name": "Claude Opus 4.6 (Claude CLI)",

"reasoning": true,

"input": ["text", "image"],

"contextWindow": 200000

},

{

"id": "claude-opus-4-5",

"name": "Claude Opus 4.5 (Claude CLI)",

"reasoning": true,

"input": ["text", "image"],

"contextWindow": 200000

},

{

"id": "claude-sonnet-4-5",

"name": "Claude Sonnet 4.5 (Claude CLI)",

"reasoning": true,

"input": ["text", "image"],

"contextWindow": 200000

},

{

"id": "claude-haiku-4-5",

"name": "Claude Haiku 4.5 (Claude CLI)",

"reasoning": true,

"input": ["text", "image"],

"contextWindow": 200000

}

]

}

},

"discovery": {

"claude-cli": "static"

}

},

"modelSupport": {

"modelPrefixes": ["claude-"]

},

);

expect(env.OPENCLAW_QA_ALLOW_LOCAL_IMAGE_PROVIDER).toBe("1");

expect(env.OPENCLAW_ALLOW_SLOW_REPLY_TESTS).toBe("1");

expect(env.OPENCLAW_SKIP_STARTUP_MODEL_PREWARM).toBe("1");

expect(env.OPENCLAW_BUNDLED_PLUGINS_DIR).toBe("/tmp/openclaw-qa/bundled-plugins");

expect(env.OPENCLAW_COMPATIBILITY_HOST_VERSION).toBe("2026.4.8");

});

OPENCLAW_SKIP_BROWSER_CONTROL_SERVER: "1",

OPENCLAW_SKIP_GMAIL_WATCHER: "1",

OPENCLAW_SKIP_CANVAS_HOST: "1",

OPENCLAW_SKIP_STARTUP_MODEL_PREWARM: "1",

OPENCLAW_NO_RESPAWN: "1",

OPENCLAW_TEST_FAST: "1",

OPENCLAW_QA_PARENT_PID: String(process.pid),

if (!syntheticAuthProviderRefs) {

return true;

}

if (resolveProviderConfig(params.cfg, params.provider)) {

return true;

}

const eligibleRefs = new Set(

syntheticAuthProviderRefs.map((ref) => normalizeProviderId(ref)).filter(Boolean),

);

expect(entry.contextWindow).toBe(128_000);

});

it("merges manifest model catalog rows on the normal catalog path", async () => {

mockSingleOpenAiCatalogModel();

currentPluginMetadataSnapshotMock.mockReturnValue({

...emptyPluginMetadataSnapshot(),

plugins: [

{

id: "byteplus",

origin: "bundled",

providers: ["byteplus"],

modelCatalog: {

providers: {

byteplus: {

baseUrl: "https://ark.ap-southeast.bytepluses.com/api/v3",

api: "openai-completions",

models: [

{

id: "seed-1-8-251228",

name: "Doubao Seed 1.8",

input: ["text", "image"],

contextWindow: 256_000,

},

],

},

},

},

},

],

});

const result = await loadModelCatalog({ config: {} as OpenClawConfig });

const entry = requireCatalogEntry(result, "byteplus", "seed-1-8-251228");

expect(entry.name).toBe("Doubao Seed 1.8");

expect(entry.input).toEqual(["text", "image"]);

expect(entry.contextWindow).toBe(256_000);

});

it("keeps configured LM Studio models visible without runtime catalog augmentation", async () => {

mockSingleOpenAiCatalogModel();

augmentCatalogMock.mockResolvedValueOnce([]);

const result = await loadModelCatalog({

config: {

models: {

providers: {

lmstudio: {

baseUrl: "http://127.0.0.1:1234/v1",

models: [

{

id: "qwen3.6-27b@iq3_xxs",

name: "Qwen 3.6 27B",

input: ["text"],

reasoning: false,

contextWindow: 128_000,

maxTokens: 8192,

cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },

},

],

},

},

},

} as OpenClawConfig,

});

const entry = requireCatalogEntry(result, "lmstudio", "qwen3.6-27b@iq3_xxs");

expect(entry.name).toBe("Qwen 3.6 27B");

expect(entry.contextWindow).toBe(128_000);

});

it("dedupes configured models against discovered provider aliases", async () => {

mockPiDiscoveryModels([{ id: "glm-5", provider: "z.ai", name: "GLM-5" }]);

const sortModels = sortModelCatalogEntries;

try {

const cfg = params?.config ?? getRuntimeConfig();

let manifestMetadataSnapshot: PluginMetadataSnapshot | undefined;

let manifestPlugins: ProviderModelIdNormalizationOptions["manifestPlugins"];

const getManifestPlugins = () => {

manifestPlugins ??=

params?.metadataSnapshot?.plugins ??

const getManifestMetadataSnapshot = () => {

manifestMetadataSnapshot ??=

params?.metadataSnapshot ??

loadManifestMetadataSnapshot({

config: cfg,

env: process.env,

}).plugins;

});

return manifestMetadataSnapshot;

};

const getManifestPlugins = () => {

manifestPlugins ??= getManifestMetadataSnapshot().plugins;

return manifestPlugins;

};

if (!readOnly) {

compat,

});

}

appendCatalogEntriesIfAbsent(

models,

loadManifestModelCatalog({

config: cfg,

env: process.env,

metadataSnapshot: getManifestMetadataSnapshot(),

}),

);

logStage("manifest-models-merged", `entries=${models.length}`);

if (!readOnly) {

const supplemental = await augmentModelCatalogWithProviderPlugins({

config: cfg,

import type { ModelCatalogEntry } from "./model-catalog.types.js";

const modelCatalogMocks = vi.hoisted(() => ({

loadModelCatalog: vi.fn<() => Promise<ModelCatalogEntry[]>>(),

loadModelCatalog: vi.fn<(params?: unknown) => Promise<ModelCatalogEntry[]>>(),

}));

const modelAuthMocks = vi.hoisted(() => ({

expect(firstLookup).toBe(secondLookup);

});

it("uses the read-only model catalog while warming provider auth", async () => {

const cfg = {} as OpenClawConfig;

modelCatalogMocks.loadModelCatalog.mockResolvedValue([

{ id: "gpt", name: "gpt", provider: "openai" },

]);

modelAuthMocks.hasRuntimeAvailableProviderAuth.mockReturnValue(false);

await warmCurrentProviderAuthState(cfg);

expect(modelCatalogMocks.loadModelCatalog).toHaveBeenCalledWith({

config: cfg,

readOnly: true,

});

});

it("hasAuthForModelProvider returns the prepared answer after warm and falls through to compute after clear", async () => {

const cfg = {} as OpenClawConfig;

modelCatalogMocks.loadModelCatalog.mockResolvedValue([

const ownGeneration = currentProviderAuthStateGeneration;

const isWarmStale = () =>

options.isCancelled?.() === true || ownGeneration !== currentProviderAuthStateGeneration;

const catalog = await loadModelCatalog({ config: cfg });

const catalog = await loadModelCatalog({ config: cfg, readOnly: true });

if (isWarmStale()) {

return;

}