@@ -8,6 +8,7 @@ export const PLUGIN_COMPAT_RECORDS = [
88introduced: "2026-04-24",
99deprecated: "2026-04-24",
1010warningStarts: "2026-04-24",
11+removeAfter: "2026-07-01",
1112replacement: "`before_model_resolve` and `before_prompt_build` hooks",
1213docsPath: "/plugins/sdk-migration",
1314surfaces: ["plugin hooks", "plugins inspect", "status diagnostics"],
@@ -34,6 +35,7 @@ export const PLUGIN_COMPAT_RECORDS = [
3435introduced: "2026-04-24",
3536deprecated: "2026-04-24",
3637warningStarts: "2026-04-24",
38+removeAfter: "2026-07-01",
3739replacement: "focused `openclaw/plugin-sdk/<subpath>` imports",
3840docsPath: "/plugins/sdk-migration",
3941surfaces: ["openclaw/plugin-sdk", "openclaw/plugin-sdk/compat"],
@@ -83,6 +85,7 @@ export const PLUGIN_COMPAT_RECORDS = [
8385introduced: "2026-04-24",
8486deprecated: "2026-04-24",
8587warningStarts: "2026-04-24",
88+removeAfter: "2026-07-01",
8689replacement: "`setup.providers[].envVars` and `providerAuthChoices`",
8790docsPath: "/plugins/manifest",
8891surfaces: ["openclaw.plugin.json providerAuthEnvVars", "provider setup"],
@@ -96,6 +99,7 @@ export const PLUGIN_COMPAT_RECORDS = [
9699introduced: "2026-04-24",
97100deprecated: "2026-04-24",
98101warningStarts: "2026-04-24",
102+removeAfter: "2026-07-01",
99103replacement: "`channelConfigs.<id>.schema` and setup descriptors",
100104docsPath: "/plugins/manifest",
101105surfaces: ["openclaw.plugin.json channelEnvVars", "channel setup"],
@@ -105,6 +109,18 @@ export const PLUGIN_COMPAT_RECORDS = [
105109"src/channels/plugins/setup-group-access.test.ts",
106110],
107111},
112+{
113+code: "activation-agent-harness-hint",
114+status: "active",
115+owner: "plugin-execution",
116+introduced: "2026-04-24",
117+replacement:
118+"top-level `cliBackends[]` for CLI aliases and future `agentRuntime` ownership metadata",
119+docsPath: "/plugins/manifest",
120+surfaces: ["activation.onAgentHarnesses", "activation planner"],
121+diagnostics: ["activation plan compat reason"],
122+tests: ["src/plugins/activation-planner.test.ts"],
123+},
108124{
109125code: "activation-provider-hint",
110126status: "active",
@@ -167,11 +183,12 @@ export const PLUGIN_COMPAT_RECORDS = [
167183introduced: "2026-04-24",
168184deprecated: "2026-04-25",
169185warningStarts: "2026-04-25",
186+removeAfter: "2026-08-01",
170187replacement: "`agentRuntime` config naming",
171188docsPath: "/plugins/sdk-agent-harness",
172189surfaces: ["agents.defaults.embeddedHarness", "model/provider runtime selection"],
173190diagnostics: ["agent runtime config compatibility"],
174-tests: ["src/agents/config.test.ts", "src/agents/runtime-selection.test.ts"],
191+tests: ["src/commands/doctor/shared/legacy-config-migrate.test.ts"],
175192},
176193{
177194code: "agent-harness-sdk-alias",
@@ -180,6 +197,7 @@ export const PLUGIN_COMPAT_RECORDS = [
180197introduced: "2026-04-24",
181198deprecated: "2026-04-25",
182199warningStarts: "2026-04-25",
200+removeAfter: "2026-08-01",
183201replacement: "`openclaw/plugin-sdk/agent-runtime`",
184202docsPath: "/plugins/sdk-agent-harness",
185203surfaces: ["openclaw/plugin-sdk/agent-harness", "openclaw/plugin-sdk/agent-harness-runtime"],
@@ -193,6 +211,7 @@ export const PLUGIN_COMPAT_RECORDS = [
193211introduced: "2026-04-24",
194212deprecated: "2026-04-25",
195213warningStarts: "2026-04-25",
214+removeAfter: "2026-08-01",
196215replacement: "`agentRuntime` ids and policy metadata",
197216docsPath: "/plugins/sdk-agent-harness",
198217surfaces: ["manifest/catalog execution policy", "runtime selection"],
@@ -217,12 +236,131 @@ export const PLUGIN_COMPAT_RECORDS = [
217236introduced: "2026-04-25",
218237deprecated: "2026-04-25",
219238warningStarts: "2026-04-25",
239+removeAfter: "2026-07-15",
220240replacement: "`openclaw plugins registry --refresh` and `openclaw doctor --fix`",
221241docsPath: "/cli/plugins#registry",
222242surfaces: ["OPENCLAW_DISABLE_PERSISTED_PLUGIN_REGISTRY", "plugin registry reads"],
223243diagnostics: ["persisted-registry-disabled"],
224244tests: ["src/plugins/plugin-registry.test.ts"],
225245},
246+{
247+code: "plugin-registry-install-migration-env",
248+status: "deprecated",
249+owner: "config",
250+introduced: "2026-04-25",
251+deprecated: "2026-04-25",
252+warningStarts: "2026-04-25",
253+removeAfter: "2026-07-15",
254+replacement: "`openclaw plugins registry --refresh` and `openclaw doctor --fix`",
255+docsPath: "/cli/plugins#registry",
256+surfaces: [
257+"OPENCLAW_DISABLE_PLUGIN_REGISTRY_MIGRATION",
258+"OPENCLAW_FORCE_PLUGIN_REGISTRY_MIGRATION",
259+"package postinstall plugin registry migration",
260+],
261+diagnostics: ["postinstall migration skip", "postinstall migration force deprecation warning"],
262+tests: ["src/commands/doctor/shared/plugin-registry-migration.test.ts"],
263+},
264+{
265+code: "plugin-activate-entrypoint-alias",
266+status: "deprecated",
267+owner: "sdk",
268+introduced: "2026-04-24",
269+deprecated: "2026-04-26",
270+warningStarts: "2026-04-26",
271+removeAfter: "2026-08-01",
272+replacement: "`register(api)` plugin entrypoint",
273+docsPath: "/plugins/sdk-entrypoints",
274+surfaces: ["plugin module `activate(api)`", "plugin loader registration"],
275+diagnostics: ["loader compatibility path"],
276+tests: ["src/plugins/loader.test.ts"],
277+},
278+{
279+code: "setup-runtime-fallback",
280+status: "active",
281+owner: "setup",
282+introduced: "2026-04-24",
283+replacement: "`setup.requiresRuntime: false` with complete setup descriptors",
284+docsPath: "/plugins/manifest#setup-reference",
285+surfaces: ["setup-api runtime fallback", "setup.requiresRuntime omitted"],
286+diagnostics: ["setup registry runtime diagnostic"],
287+tests: ["src/plugins/setup-registry.test.ts", "src/plugins/setup-registry.runtime.test.ts"],
288+},
289+{
290+code: "provider-discovery-hook-alias",
291+status: "deprecated",
292+owner: "provider",
293+introduced: "2026-04-24",
294+deprecated: "2026-04-26",
295+warningStarts: "2026-04-26",
296+removeAfter: "2026-08-01",
297+replacement: "`catalog.run(...)` provider catalog hook",
298+docsPath: "/plugins/sdk-migration",
299+surfaces: ["provider plugin `discovery` hook", "provider catalog resolution"],
300+diagnostics: ["provider validation warning when catalog and discovery both register"],
301+tests: ["src/plugins/provider-discovery.test.ts", "src/plugins/provider-validation.test.ts"],
302+},
303+{
304+code: "channel-exposure-legacy-aliases",
305+status: "deprecated",
306+owner: "channel",
307+introduced: "2026-04-24",
308+deprecated: "2026-04-26",
309+warningStarts: "2026-04-26",
310+removeAfter: "2026-08-01",
311+replacement: "`openclaw.channel.exposure` metadata",
312+docsPath: "/plugins/sdk-setup",
313+surfaces: ["openclaw.channel.showConfigured", "openclaw.channel.showInSetup"],
314+diagnostics: ["channel exposure compatibility path"],
315+tests: ["src/commands/channel-setup/discovery.test.ts"],
316+},
317+{
318+code: "channel-runtime-sdk-alias",
319+status: "deprecated",
320+owner: "sdk",
321+introduced: "2026-04-24",
322+deprecated: "2026-04-26",
323+warningStarts: "2026-04-26",
324+removeAfter: "2026-08-01",
325+replacement:
326+"focused channel SDK subpaths, especially `openclaw/plugin-sdk/channel-runtime-context`",
327+docsPath: "/plugins/sdk-migration",
328+surfaces: ["openclaw/plugin-sdk/channel-runtime"],
329+diagnostics: ["plugin SDK compatibility warning"],
330+tests: ["src/plugins/contracts/plugin-sdk-subpaths.test.ts"],
331+},
332+{
333+code: "command-auth-status-builders",
334+status: "deprecated",
335+owner: "sdk",
336+introduced: "2026-04-24",
337+deprecated: "2026-04-26",
338+warningStarts: "2026-04-26",
339+removeAfter: "2026-08-01",
340+replacement: "`openclaw/plugin-sdk/command-status`",
341+docsPath: "/plugins/sdk-migration",
342+surfaces: [
343+"openclaw/plugin-sdk/command-auth buildCommandsMessage",
344+"openclaw/plugin-sdk/command-auth buildCommandsMessagePaginated",
345+"openclaw/plugin-sdk/command-auth buildHelpMessage",
346+],
347+diagnostics: ["plugin SDK compatibility warning"],
348+tests: ["src/plugin-sdk/command-auth.test.ts"],
349+},
350+{
351+code: "clawdbot-config-type-alias",
352+status: "deprecated",
353+owner: "sdk",
354+introduced: "2026-04-24",
355+deprecated: "2026-04-26",
356+warningStarts: "2026-04-26",
357+removeAfter: "2026-08-01",
358+replacement: "`OpenClawConfig`",
359+docsPath: "/plugins/sdk-migration",
360+surfaces: ["openclaw/plugin-sdk `ClawdbotConfig` type export"],
361+diagnostics: ["plugin SDK compatibility warning"],
362+tests: ["src/plugins/contracts/plugin-sdk-index.test.ts"],
363+},
226364] as const satisfies readonly PluginCompatRecord[];
227365228366export type PluginCompatCode = (typeof PLUGIN_COMPAT_RECORDS)[number]["code"];
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。