已移除的界面

command-status"> 旧（openclaw/plugin-sdk/command-auth）：buildCommandsMessage、 buildCommandsMessagePaginated、buildHelpMessage。

新（openclaw/plugin-sdk/command-status）：相同签名，从更窄的子路径导入。command-auth 兼容性重新导出已被移除。

// Before
import { buildHelpMessage } from "openclaw/plugin-sdk/command-auth";

// After
import { buildHelpMessage } from "openclaw/plugin-sdk/command-status";

resolveInboundMentionDecision"> 旧：openclaw/plugin-sdk/channel-inbound 或 openclaw/plugin-sdk/channel-mention-gating 中的 resolveMentionGating(params) 和 resolveMentionGatingWithBypass(params)。

新：resolveInboundMentionDecision({ facts, policy }) - 一个决策对象，而不是两种拆分的调用形状。

已在 Discord、iMessage、Matrix、MS Teams、QQBot、Signal、Telegram、WhatsApp 和 Zalo 中采用。Slack 自身的 app_mention 事件模型不使用此辅助函数。

openclaw/plugin-sdk/channel-runtime 已被移除。使用 openclaw/plugin-sdk/channel-runtime-context 注册运行时对象。

openclaw/plugin-sdk/channel-actions 中的原生消息模式辅助函数已随原始 "actions" 通道导出一起移除。改为通过语义化的 presentation 表面公开能力 - 通道插件声明它们渲染的内容（卡片、按钮、选择器），而不是它们接受哪些原始操作名称。

createTool() on the plugin"> 旧：来自 openclaw/plugin-sdk/provider-web-search 的 tool() 工厂。

新：直接在提供者插件上实现 createTool(...)。 OpenClaw 不再需要 SDK 辅助函数来注册工具包装器。

BodyForAgent"> 旧：api.runtime.channel.reply.formatInboundEnvelope(...)（以及入站消息对象上的 channelEnvelope 字段），用于从入站通道消息构建扁平的纯文本提示信封。

核心线程绑定"> 旧：api.on("subagent_spawning", handler) 返回 threadBindingReady 或 deliveryOrigin。

新：让核心通过通道会话绑定适配器准备 thread: true 子代理绑定。 仅使用 api.on("subagent_spawned", handler) 进行启动后观察。

// Before
api.on("subagent_spawning", async () => ({
  status: "ok",
  threadBindingReady: true,
  deliveryOrigin: { channel: "discord", to: "channel:123", threadId: "456" },
}));

// After
api.on("subagent_spawned", async (event) => {
  await observeSubagentLaunch(event);
});

subagent_spawning 钩子及其事件/结果类型已在 2026 年 8 月移除，因为线程绑定已迁移到核心会话绑定路径。

提供商目录类型"> 四个发现类型别名现在是目录时代类型的薄封装：

这些别名和旧版 ProviderCapabilities 静态对象集合已被 移除。提供商插件 应使用显式的提供商钩子，例如 buildReplayPolicy、 normalizeToolSchemas 和 wrapStreamFn，而不是静态对象。

resolveThinkingProfile"> 旧（ProviderThinkingPolicy 上的三个独立钩子）： isBinaryThinking(ctx)、supportsXHighThinking(ctx) 和 resolveDefaultThinkingLevel(ctx)。

新：单个 resolveThinkingProfile(ctx)，返回一个 ProviderThinkingProfile，包含规范的 id、可选的 label 以及 按等级排序的级别列表。OpenClaw 会根据配置文件等级自动 降级过时的存储值。

上下文包含 provider、modelId、可选的合并 reasoning 以及可选的合并模型 compat 事实。提供商插件可以使用这些 目录事实，仅在已配置的请求契约支持时暴露特定于模型的配置文件。

实现一个钩子而不是三个。旧版钩子已被移除。

contracts.externalAuthProviders"> 旧：在插件清单中未声明提供商的情况下实现外部身份验证钩子。

新：在插件清单中声明 contracts.externalAuthProviders 并且实现 resolveExternalAuthProfiles(...)。

{
  "contracts": {
    "externalAuthProviders": ["anthropic", "openai"]
  }
}

setup.providers[].envVars"> 旧清单字段：providerAuthEnvVars: { anthropic: ["ANTHROPIC_API_KEY"] }。

新：将相同的环境变量查找镜像到清单中的 setup.providers[].envVars。 这会将设置/状态环境变量元数据集中在一处， 并避免仅为回答环境变量查找而启动插件运行时。

providerAuthEnvVars 不再被接受。

registerMemoryCapability"> 旧：三个独立调用 - api.registerMemoryPromptSection(...)、 api.registerMemoryFlushPlan(...)、api.registerMemoryRuntime(...)。

新：在内存状态 API 上的一次调用 - registerMemoryCapability(pluginId, { promptBuilder, flushPlanResolver, runtime })。

相同的槽位，单次注册调用。增量提示和语料库辅助函数 （registerMemoryPromptSupplement、registerMemoryCorpusSupplement） 不受影响。

旧：api.registerMemoryEmbeddingProvider(...) 加上 contracts.memoryEmbeddingProviders。

新：api.registerEmbeddingProvider(...) 加上 contracts.embeddingProviders。

通用嵌入提供商契约可在内存之外复用，并且 是每个提供商的受支持路径。特定于内存的注册 API 和清单契约在 2026-08-21 迁移截止日期后已被移除。

OutboundDeliveryResult"> 旧：通过 ChannelSendRawResult 返回 { ok, messageId, error }， 并使用 createRawChannelSendResultAdapter(...) 对其进行规范化。

新：返回 OutboundDeliveryResult 字段，并使用 createAttachedChannelResultAdapter(...) 附加通道。发送失败时应抛出异常， 而不是返回错误字符串。将平台目标放入 target: { kind: "chat" | "channel" | "room" | "conversation", id }； 旧的并行 chatId、channelId、roomId 和 conversationId 结果字段不再被接受。原始结果类型将在下一个 plugin-SDK 主要版本发布前保持可用。

两个旧版类型别名仍从 src/plugins/runtime/types.ts 导出：

SQLite 会话/转录切换会移除或弃用面向插件的 API， 这些 API 曾暴露活动 sessions.json 存储、JSONL 转录路径，或 会话文件列表。运行时插件应使用会话标识和 SDK 运行时 辅助函数，而不是解析或修改活动文件。

旧版 JSONL 转录文件仍可作为导入、归档、导出和支持工件保持有效。 它们不再是活动会话的稳态运行时契约。

随 v2026.7.1-beta.5 发布的官方 @openclaw/codex 和 @openclaw/feishu 插件 导入了已退役的桥接。SDK 所有者于 2026 年 9 月 30 日批准，提前结束了其兼容性窗口， 取代了原定的 10 月 12 日截止日期。受支持插件的截止日期排除了该 版本以及任何仍在导入该 桥接的包。在升级 OpenClaw 之前，将受影响的插件升级到使用替代方案 的版本。仅版本号更新本身并不能证明已完成迁移。

openclaw/plugin-sdk/session-store-runtime 和 resolveStorePath(...) 仍受支持。显式地将选定的 agentId 传递给作用域行 操作；解析路径不再为后续的整个存储调用记录代理选择。 此移除不会更改 SQLite 架构或 旧状态导入和 Doctor 迁移。

openclaw plugins inspect --all --runtime 会报告非捆绑插件，其 加载错误或诊断信息仍引用这些已移除的文件 API。 @openclaw/plugin-inspector 建议扫描必须使用版本 0.3.17 或 更高版本，以便外部包扫描也能在发布前标记整个存储会话辅助函数、 会话文件路径辅助函数、旧版转录文件目标和低级 转录辅助函数。

V2 主机能力契约"> 新的或更新的 harness 插件应实现 AgentHarnessV2，并使用 AgentHarnessAttemptParamsV2、EmbeddedRunAttemptParamsV2 或 AgentHarnessSideQuestionParamsV2。V2 参数类型要求 hostCapabilities，与核心在所选 harness 边界处提供的内容一致。采用这些 V2 契约的插件必须在其包 清单中声明 openclaw.compat.pluginApi: ">=2026.8.1"（或更高的下限），以便旧宿主在加载插件前拒绝该插件。

现有插件可以继续实现 AgentHarness，并构造旧版 AgentHarnessAttemptParams、EmbeddedRunAttemptParams 或 AgentHarnessSideQuestionParams 类型而不带该字段，直到 2026-10-12。这些契约仅为源代码兼容性保留该能力为可选；它们不会创建无能力的运行时路径。请通过更改导入的类型名称，并通过 params.hostCapabilities 绑定工具或原生操作表面来迁移。

Tasks 注册表和 TaskFlow 编排 API 已移除， 包括 api.runtime.tasks、registerDetachedTaskRuntime 以及 agent-harness-task-runtime SDK 子路径。没有兼容性门面保留。 请分别使用原生子代理启动/等待/历史 API、cron 运行历史，以及 普通 Lobster runner 执行相应操作。Harness 完成 路由使用仅完成的 agent-harness-completion 子路径。 此移除不会更改物理数据库架构。现有 task_runs、task_delivery_state 和 flow_runs 表、列和索引 保持不变。Cron 只读取和写入其 runtime = 'cron' 历史 行，位于 task_runs 中；非 Cron Task 和 TaskFlow 行保持未触及， 且运行时不使用。Codex 插件的 Doctor 迁移 会在现有父绑定元数据中保留符合条件的、带有所有者标记的原生恢复事实， 使源行保持字节级一致。它不会添加运行时 Task 读取器或替代 SDK 表面；当前请求者权限仍控制 完成投递。请参阅版本契约。

代理工具结果中间件"> 已在如何迁移中涵盖。此处为完整性而包含： 已移除的仅限嵌入式运行时的 api.registerEmbeddedExtensionFactory(...) 路径由 api.registerAgentToolResultMiddleware(...) 替代，并在 contracts.agentToolResultMiddleware 中提供显式运行时列表。

OpenClawConfig"> 已移除 OpenClawSchemaType 根 SDK 别名。请使用规范的 OpenClawConfig 名称。

// Before
import type { OpenClawSchemaType } from "openclaw/plugin-sdk";
// After
import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";