docs(plugin-sdk): mark compatibility facades deprecated

src/plugin-sdk/channel-config-schema-legacy.ts

@@ -1,5 +1,5 @@
 /**
- * Deprecated bundled-channel compatibility surface.
+ * @deprecated Compatibility surface for bundled channel schemas.
  *
  * OpenClaw-maintained bundled plugins should import
  * openclaw/plugin-sdk/bundled-channel-config-schema. Third-party plugins should

src/plugin-sdk/discord.ts

@@ -12,6 +12,10 @@ import {
 } from "./facade-loader.js";
 import { getRuntimeConfig, getRuntimeConfigSnapshot } from "./runtime-config-snapshot.js";
 
+/**
+ * @deprecated Compatibility facade for the `openclaw/plugin-sdk/discord` subpath.
+ * New channel plugins should use generic channel SDK subpaths.
+ */
 export type { ChannelMessageActionAdapter, ChannelMessageActionName } from "./channel-contract.js";
 export type { ChannelPlugin } from "./channel-core.js";
 export type { OpenClawConfig } from "./config-types.js";

src/plugin-sdk/telegram-account.ts

@@ -1,10 +1,18 @@
 import type { OpenClawConfig } from "./config-types.js";
 import { loadBundledPluginPublicSurfaceModuleSync } from "./facade-loader.js";
 
+/**
+ * @deprecated Compatibility type for the `openclaw/plugin-sdk/telegram-account` facade.
+ * New channel plugins should prefer injected runtime helpers and generic SDK subpaths.
+ */
 export type TelegramAccountConfig = NonNullable<
   NonNullable<OpenClawConfig["channels"]>["telegram"]
 >;
 
+/**
+ * @deprecated Compatibility type for the `openclaw/plugin-sdk/telegram-account` facade.
+ * New channel plugins should prefer injected runtime helpers and generic SDK subpaths.
+ */
 export type ResolvedTelegramAccount = {
   accountId: string;
   enabled: boolean;