diff --git a/extensions/discord/api.ts b/extensions/discord/api.ts
index 46726ab9c75..ae957256410 100644
--- a/extensions/discord/api.ts
+++ b/extensions/discord/api.ts
@@ -23,6 +23,12 @@ export {
 } from "./src/accounts.js";
 export { tryHandleDiscordMessageActionGuildAdmin } from "./src/actions/handle-action.guild-admin.js";
 export { buildDiscordComponentMessage } from "./src/components.js";
+type DiscordMessageActionHandler =
+  typeof import("./src/channel-actions.runtime.js").handleDiscordMessageAction;
+
+// Deprecated compatibility surface for existing @openclaw/discord/api.js consumers.
+export const handleDiscordMessageAction: DiscordMessageActionHandler = async (...args) =>
+  (await import("./src/channel-actions.runtime.js")).handleDiscordMessageAction(...args);
 export {
   listDiscordDirectoryGroupsFromConfig,
   listDiscordDirectoryPeersFromConfig,
@@ -52,8 +58,10 @@ export {
   formatDiscordComponentEventText,
   parseDiscordComponentCustomId,
   parseDiscordComponentCustomIdForInteraction,
+  parseDiscordComponentCustomIdForInteraction as parseDiscordComponentCustomIdForCarbon,
   parseDiscordModalCustomId,
   parseDiscordModalCustomIdForInteraction,
+  parseDiscordModalCustomIdForInteraction as parseDiscordModalCustomIdForCarbon,
   readDiscordComponentSpec,
   resolveDiscordComponentAttachmentName,
   type ComponentData,
diff --git a/extensions/discord/src/api-barrel.test.ts b/extensions/discord/src/api-barrel.test.ts
index e8e2899da92..0b8d2e0f90f 100644
--- a/extensions/discord/src/api-barrel.test.ts
+++ b/extensions/discord/src/api-barrel.test.ts
@@ -47,7 +47,10 @@ describe("discord API barrel", () => {
       "discordPlugin",
       "discordSetupPlugin",
       "buildDiscordComponentCustomId",
+      "handleDiscordMessageAction",
+      "parseDiscordComponentCustomIdForCarbon",
       "parseDiscordComponentCustomIdForInteraction",
+      "parseDiscordModalCustomIdForCarbon",
       "parseDiscordModalCustomIdForInteraction",
       "fetchDiscordApplicationSummary",
       "DiscordSendResult",
@@ -63,8 +66,11 @@ describe("discord API barrel", () => {
       "DISCORD_COMPONENT_CUSTOM_ID_KEY",
       "buildDiscordComponentMessageFlags",
       "createDiscordFormModal",
+      "handleDiscordMessageAction",
       "handleDiscordSubagentSpawning",
       "listEnabledDiscordAccounts",
+      "parseDiscordComponentCustomIdForCarbon",
+      "parseDiscordModalCustomIdForCarbon",
       "resolveDiscordRuntimeGroupPolicy",
       "tryHandleDiscordMessageActionGuildAdmin",
     ]) {