diff --git a/src/plugin-sdk/channel-config-schema-legacy.ts b/src/plugin-sdk/channel-config-schema-legacy.ts
index c056d7eff70..fe19e213208 100644
--- a/src/plugin-sdk/channel-config-schema-legacy.ts
+++ b/src/plugin-sdk/channel-config-schema-legacy.ts
@@ -1,5 +1,5 @@
 /**
- * @deprecated Deprecated bundled-channel compatibility surface.
+ * @deprecated Deprecated bundled-channel compatibility surface. Compatibility surface for bundled channel schemas.
  *
  * OpenClaw-maintained bundled plugins should import
  * openclaw/plugin-sdk/bundled-channel-config-schema. Third-party plugins should