移除的表面和替换的表面

旧 (openclaw/plugin-sdk/command-auth)：buildCommandsMessage、 buildCommandsMessagePaginated、buildHelpMessage。

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

// Beforeimport { buildHelpMessage } from "openclaw/plugin-sdk/command-auth"; // Afterimport { buildHelpMessage } from "openclaw/plugin-sdk/command-status";

Old：来自 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 中的原生消息 schema 辅助函数已随原始“actions”通道导出一并移除。请改为通过语义化的 presentation 接口暴露能力——通道插件声明它们渲染的内容（卡片、按钮、选择器），而不是声明它们接受哪些原始操作名称。

Old：tool() 工厂来自 openclaw/plugin-sdk/provider-web-search。

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

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

新：使用 BodyForAgent 加上结构化的用户上下文块。通道插件将路由元数据（线程、主题、回复目标、反应）作为类型化字段附加，而不是将其拼接到提示字符串中。formatAgentEnvelope(...) 辅助函数仍支持为面向 assistant 的合成信封提供服务，但入站纯文本信封即将退出。

受影响的区域：inbound_claim、message_received，以及任何对旧信封文本进行后处理的自定义通道插件。

旧：api.on("subagent_spawning", handler) 返回 threadBindingReady 或 deliveryOrigin。

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

// Beforeapi.on("subagent_spawning", async () => ({  status: "ok",  threadBindingReady: true,  deliveryOrigin: { channel: "discord", to: "channel:123", threadId: "456" },})); // Afterapi.on("subagent_spawned", async (event) => {  await observeSubagentLaunch(event);});

在线程绑定移至核心会话绑定路径后，subagent_spawning 挂钩及其 event/result 类型于 2026 年 8 月被删除。

四个发现类型别名现在是 catalog 时代类型的薄封装：

这些别名以及旧版的 ProviderCapabilities 静态容器已被移除。Provider 插件应使用明确的 provider 钩子，例如 buildReplayPolicy、 normalizeToolSchemas 和 wrapStreamFn，而不是使用静态对象。

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

New：单个 resolveThinkingProfile(ctx)，返回 ProviderThinkingProfile 以及标准 id、可选 label 和排名级别列表。 OpenClaw 在执行期间按配置文件等级钳制不支持的请求，从而保留跨模型切换的存储首选项。

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

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

旧：实现外部 auth 钩子，但未在插件清单中声明 provider。

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

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

旧清单字段：providerAuthEnvVars: { anthropic: ["ANTHROPIC_API_KEY"] }。

New：将相同的环境变量查找镜像到清单上的 setup.providers[].envVars 中。这将 setup/status env 元数据合并到一处，并避免仅仅为了回答 env-var 查找而启动插件运行时。

providerAuthEnvVars 不再被接受。

旧：三个独立调用——api.registerMemoryPromptSection(...)、 api.registerMemoryFlushPlan(...)、api.registerMemoryRuntime(...)。

新：在 memory-state API 上一次调用： registerMemoryCapability(pluginId, { promptBuilder, flushPlanResolver, runtime })。

槽位保持不变，但改为单次注册调用。增量式提示和语料辅助工具 (registerMemoryPromptSupplement, registerMemoryCorpusSupplement) 不受影响。

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

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

通用嵌入提供程序合约可在外部内存中重用，并且是每个提供程序支持的路径。在 2026-08-21 迁移截止日期后，删除了特定于内存的注册 API 和清单合同。

Old：通过ChannelSendRawResult返回{ ok, messageId, error }，并用createRawChannelSendResultAdapter(...)对其进行归一化。

New：返回OutboundDeliveryResult字段并将通道附加到createAttachedChannelResultAdapter(...)。发送失败应该抛出异常而不是返回错误字符串。将平台目标放入target: { kind: "chat" | "channel" | "room" | "conversation", id }；不再接受旧的并行 chatId、channelId、roomId 和 conversationId 结果字段。原始结果类型仍然可用，直到其单独宣布的普通稳定删除版本为止。

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

运行时方法 readSession 已弃用，建议改用 getSessionMessages。签名相同；旧方法会转调新方法。

SQLite session/transcript 翻转删除或弃用了暴露活动 sessions.json 存储、JSONL 转录路径或会话文件列表的面向插件的 API。运行时插件应使用会话标识和 SDK 运行时帮助程序，而不是解析或更改活动文件。

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

与 v2026.7.1-beta.5 一起发布的官方 @openclaw/codex 和 @openclaw/feishu 插件导入了已退役的桥。 SDK-owner 于 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 或更新版本，因此外部包扫描还会在发布之前标记整个存储会话帮助程序、会话文件路径帮助程序、旧副本文件目标和低级副本帮助程序。

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

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

任务注册表和 TaskFlow 编排 API 已被删除，包括 api.runtime.tasks、registerDetachedTaskRuntime 和 agent-harness-task-runtime SDK 子路径。不存在兼容性外观。使用本机子代理 launch/wait/history API、cron 运行历史记录和普通 Lobster 运行程序来执行各自的操作。harness完成路由使用仅完成 agent-harness-completion 子路径。此删除不会更改物理数据库架构。现有的 task_runs、task_delivery_state 和 flow_runs 表、列和索引保持不变。 Cron 仅读取和写入 task_runs 中的 runtime = 'cron' 历史记录行；非 Cron 任务和 TaskFlow 行保持不变，并且不被运行时使用。 Codex 插件的 Doctor 迁移 在现有父绑定元数据中保留合格的所有者标记的本机恢复事实，使源行字节相同。它不添加运行时任务读取器或替换 SDK 表面；当前的请求者权限仍然控制完成交付。请参阅 版本控制合约 。

中介绍了如何迁移。为了完整起见，此处包含：已删除的仅限嵌入式运行程序的 api.registerEmbeddedExtensionFactory(...) 路径由 api.registerAgentToolResultMiddleware(...) 替换，并在 contracts.agentToolResultMiddleware 中包含显式运行时列表。

OpenClawSchemaType root-SDK 别名已删除。使用主 OpenClawConfig 名称。

// Beforeimport type { OpenClawSchemaType } from "openclaw/plugin-sdk";// Afterimport type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";