@xmoxmo/bncr 0.2.6 → 0.2.7

package/README.md

@@ -34,7 +34,7 @@ openclaw plugins update bncr
 openclaw gateway restart
 ```
 
-> 兼容范围：`openclaw >= 2026.5.3-1`
+> 兼容范围：`openclaw >= 2026.5.27`
 >
 > 如果你是从精确版本升级，或本地安装记录仍钉在旧版本，也可以显式执行：
 >
@@ -95,6 +95,10 @@ bncr 当前采用两层模型：
    - 在 OpenClaw 内部按正式 `channel plugin` 建模
    - 负责入站解析、消息分发、出站适配、状态与治理
 
+出站可靠投递的边界：bncr 后面仍有自己的服务框架和 outbox / ACK / retry / deadLetter 体系。对 OpenClaw 宿主来说，消息成功交给 bncr 插件并进入 bncr 自管 outbox，即表示频道 handoff 完成；这不等价于客户端 ACK 或目标平台最终送达。后续可靠投递由 bncr 自身负责。
+
+当前已注册生产 `channel.message` 作为 bncr 的频道专用 handoff adapter：`text` / `media` / `payload` 会转换为 bncr outbox entry。原有通用 `message.send` / `channel.actions.send` 发送能力继续保留；`channel.message` 是频道专用入口，不替代通用发送入口。该 adapter 仍不启用 `durableFinal`；进入 outbox 后的客户端 ACK、目标平台送达、retry、deadLetter 继续由 bncr 服务框架负责。
+
 当前代码结构：
 
 ```text
@@ -246,6 +250,7 @@ npm root -g
 cd plugins/bncr
 npm test
 npm run selfcheck
+npm run check-pack
 npm pack
 ```
 
@@ -253,6 +258,7 @@ npm pack
 
 - `npm test`：跑回归测试
 - `npm run selfcheck`：检查插件骨架是否完整
+- `npm run check-pack`：执行 `npm pack --dry-run --json`，确认发布包包含关键入口与 OpenClaw adapter 文件
 - `npm pack`：确认当前版本可正常打包
 - `npm run check-register-drift -- --duration-sec 300 --interval-sec 15`：静置采样 `bncr.diagnostics`，观察 `registerCount / apiGeneration / postWarmupRegisterCount` 是否在 warmup 后继续增长
 

package/index.ts

@@ -5,6 +5,10 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { BncrConfigSchema } from './src/core/config-schema.ts';
 import { emitBncrLogLine } from './src/core/logging.ts';
+import {
+  getOpenClawRuntimeConfig,
+  mutateOpenClawRuntimeConfigFile,
+} from './src/openclaw/config-runtime.ts';
 
 const pluginFile = fileURLToPath(import.meta.url);
 const pluginDir = path.dirname(pluginFile);
@@ -660,35 +664,46 @@ const registerBncrCli = (api: OpenClawPluginApi & { registerCli?: (...args: any[
           'Seed minimal channels.bncr config (adds enabled=true and allowTool=false only when missing)',
         )
         .action(async () => {
-          const cfg = api.runtime.config.current() as Record<string, unknown>;
-          const next = structuredClone(cfg);
-          if (!isPlainObject(next.channels)) next.channels = {};
-
-          const existing = isPlainObject(next.channels.bncr) ? next.channels.bncr : {};
-          const bncrCfg: Record<string, unknown> = { ...existing };
+          const cfg = getOpenClawRuntimeConfig(api) as Record<string, unknown>;
+          const channels = isPlainObject(cfg.channels) ? cfg.channels : {};
+          const existing = isPlainObject(channels.bncr) ? channels.bncr : {};
           const added: string[] = [];
 
-          if (bncrCfg.enabled === undefined) {
-            bncrCfg.enabled = true;
+          if (existing.enabled === undefined) {
             added.push('enabled=true');
           }
 
-          if (bncrCfg.allowTool === undefined) {
-            bncrCfg.allowTool = false;
+          if (existing.allowTool === undefined) {
             added.push('allowTool=false');
           }
 
-          next.channels.bncr = bncrCfg;
-
           if (added.length === 0) {
             console.log('Minimal bncr config already present. No changes made.');
             return;
           }
 
-          await api.runtime.config.writeConfigFile(next);
+          await mutateOpenClawRuntimeConfigFile(api, {
+            afterWrite: { mode: 'auto' },
+            mutate(draft: Record<string, unknown>) {
+              if (!isPlainObject(draft.channels)) draft.channels = {};
+              const draftChannels = draft.channels as Record<string, unknown>;
+              const draftExisting = isPlainObject(draftChannels.bncr) ? draftChannels.bncr : {};
+              const draftBncrCfg: Record<string, unknown> = { ...draftExisting };
+
+              if (draftBncrCfg.enabled === undefined) {
+                draftBncrCfg.enabled = true;
+              }
+
+              if (draftBncrCfg.allowTool === undefined) {
+                draftBncrCfg.allowTool = false;
+              }
+
+              draftChannels.bncr = draftBncrCfg;
+            },
+          });
           console.log('Seeded minimal bncr config at channels.bncr.');
           console.log(`Added missing fields: ${added.join(', ')}`);
-          console.log('Restart the gateway to apply changes.');
+          console.log('Gateway will apply the config using the host afterWrite policy.');
         });
     },
     { commands: ['bncr'] },
@@ -801,7 +816,7 @@ const plugin = {
 
     const resolveDebug = async () => {
       try {
-        const cfg = api.runtime.config.current();
+        const cfg = getOpenClawRuntimeConfig(api);
         return Boolean((cfg as any)?.channels?.bncr?.debug?.verbose);
       } catch {
         return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoxmo/bncr",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -27,17 +27,18 @@
     "selfcheck": "node ./scripts/selfcheck.mjs",
     "test": "node --import ./tests/register-ts-hooks.mjs --test ./tests/*.test.mjs",
     "check-register-drift": "node ./scripts/check-register-drift.mjs",
+    "check-pack": "node ./scripts/check-pack.mjs",
     "format:check": "biome format --check .",
     "format": "biome format --write .",
     "lint": "biome lint .",
     "check": "biome check ."
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.3-1"
+    "openclaw": ">=2026.5.27"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
-    "openclaw": ">=2026.5.3-1"
+    "openclaw": ">=2026.5.27"
   },
   "openclaw": {
     "extensions": [

package/scripts/check-pack.mjs

@@ -0,0 +1,61 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const root = path.resolve(__dirname, '..');
+
+const requiredPackFiles = [
+  'README.md',
+  'index.ts',
+  'openclaw.plugin.json',
+  'package.json',
+  'scripts/selfcheck.mjs',
+  'scripts/check-register-drift.mjs',
+  'src/channel.ts',
+  'src/messaging/outbound/durable-message-adapter.ts',
+  'src/messaging/outbound/durable-queue-adapter.ts',
+  'src/openclaw/config-runtime.ts',
+  'src/openclaw/inbound-session-runtime.ts',
+  'src/openclaw/ingress-runtime.ts',
+  'src/openclaw/media-runtime.ts',
+  'src/openclaw/reply-runtime.ts',
+  'src/openclaw/routing-runtime.ts',
+  'src/openclaw/sdk-helpers.ts',
+  'src/openclaw/session-route-runtime.ts',
+];
+
+const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+const output = execFileSync('npm', ['pack', '--dry-run', '--json'], {
+  cwd: root,
+  encoding: 'utf8',
+  stdio: ['ignore', 'pipe', 'pipe'],
+});
+const [pack] = JSON.parse(output);
+const packedFiles = new Set((pack?.files ?? []).map((file) => file.path));
+const missing = requiredPackFiles.filter((file) => !packedFiles.has(file));
+const channelSource = fs.readFileSync(path.join(root, 'src/channel.ts'), 'utf8');
+const channelMessageChecks = {
+  registered: channelSource.includes('message: {'),
+  text: channelSource.includes('channelMessageSendText'),
+  media: channelSource.includes('channelMessageSendMedia'),
+  payload: channelSource.includes('channelMessageSendPayload'),
+  manualAck: channelSource.includes("defaultAckPolicy: 'manual'"),
+  genericActionsPreserved: channelSource.includes('actions: messageActions'),
+  noDurableFinal: !channelSource.includes('durableFinal:'),
+};
+const channelMessageOk = Object.values(channelMessageChecks).every(Boolean);
+
+const result = {
+  ok: missing.length === 0 && pkg.peerDependencies?.openclaw === '>=2026.5.27' && channelMessageOk,
+  package: pack?.id,
+  entryCount: pack?.entryCount,
+  missing,
+  openclaw: pkg.peerDependencies?.openclaw,
+  channelMessageChecks,
+};
+
+console.log(JSON.stringify(result, null, 2));
+if (!result.ok) process.exit(1);

package/scripts/selfcheck.mjs

@@ -24,6 +24,16 @@ const requiredFiles = [
   'src/messaging/outbound/send.ts',
   'src/messaging/outbound/media.ts',
   'src/messaging/outbound/actions.ts',
+  'src/messaging/outbound/durable-message-adapter.ts',
+  'src/messaging/outbound/durable-queue-adapter.ts',
+  'src/openclaw/config-runtime.ts',
+  'src/openclaw/inbound-session-runtime.ts',
+  'src/openclaw/ingress-runtime.ts',
+  'src/openclaw/media-runtime.ts',
+  'src/openclaw/reply-runtime.ts',
+  'src/openclaw/routing-runtime.ts',
+  'src/openclaw/sdk-helpers.ts',
+  'src/openclaw/session-route-runtime.ts',
 ];
 
 const readPackageVersion = () => {

package/src/channel.ts

@@ -1,21 +1,11 @@
 import { createHash, randomUUID } from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
-import { readBooleanParam } from 'openclaw/plugin-sdk/boolean-param';
 import type {
   GatewayRequestHandlerOptions,
   OpenClawPluginApi,
   OpenClawPluginServiceContext,
 } from 'openclaw/plugin-sdk/core';
-import {
-  applyAccountNameToChannelSection,
-  jsonResult,
-  setAccountEnabledInConfigSection,
-} from 'openclaw/plugin-sdk/core';
-import { readJsonFileWithFallback, writeJsonFileAtomically } from 'openclaw/plugin-sdk/json-store';
-import { readStringParam } from 'openclaw/plugin-sdk/param-readers';
-import { createDefaultChannelRuntimeState } from 'openclaw/plugin-sdk/status-helpers';
-import { extractToolSend } from 'openclaw/plugin-sdk/tool-send';
 import {
   BNCR_DEFAULT_ACCOUNT_ID,
   CHANNEL_ID,
@@ -78,6 +68,27 @@ import { buildExtendedDiagnostics as buildExtendedDiagnosticsFromRuntime } from
 import { observeLeaseState, matchesTransferOwner as matchesTransferOwnerFromRuntime } from './core/lease-state.ts';
 import { emitBncrLog, emitBncrLogLine } from './core/logging.ts';
 import { resolveBncrChannelPolicy, resolveBncrConfigWarnings } from './core/policy.ts';
+import {
+  getOpenClawRuntimeConfig,
+  getOpenClawRuntimeConfigOrDefault,
+} from './openclaw/config-runtime.ts';
+import {
+  loadOpenClawWebMedia,
+  saveOpenClawChannelMediaBuffer,
+  type OpenClawLoadedMedia,
+} from './openclaw/media-runtime.ts';
+import { resolveOpenClawAgentRoute } from './openclaw/routing-runtime.ts';
+import {
+  applyOpenClawAccountNameToChannelSection,
+  createOpenClawDefaultChannelRuntimeState,
+  extractOpenClawToolSend,
+  openClawJsonResult,
+  readOpenClawBooleanParam,
+  readOpenClawJsonFileWithFallback,
+  readOpenClawStringParam,
+  setOpenClawAccountEnabledInConfigSection,
+  writeOpenClawJsonFileAtomically,
+} from './openclaw/sdk-helpers.ts';
 import {
   buildRegisterTraceSummary as buildRegisterTraceSummaryFromEntries,
   classifyRegisterTrace as classifyRegisterTraceFromStack,
@@ -309,6 +320,7 @@ import {
   computeRetryRerouteDecision,
 } from './messaging/outbound/retry-policy.ts';
 import { sendBncrMedia, sendBncrText } from './messaging/outbound/send.ts';
+import { buildBncrDurableQueuedResult } from './messaging/outbound/durable-queue-adapter.ts';
 import { resolveBncrOutboundSessionRoute } from './messaging/outbound/session-route.ts';
 import {
   looksLikeBncrExplicitTarget,
@@ -481,20 +493,20 @@ function normalizeBncrSendParams(input: {
   accountId: string;
 }): NormalizedBncrSendParams {
   const paramsObj = isPlainObject(input.params) ? input.params : {};
-  const to = readStringParam(paramsObj, 'to', { required: true });
+  const to = readOpenClawStringParam(paramsObj, 'to', { required: true });
   const resolvedAccountId = normalizeAccountId(
-    readStringParam(paramsObj, 'accountId') ?? input.accountId,
+    readOpenClawStringParam(paramsObj, 'accountId') ?? input.accountId,
   );
 
-  const message = readStringParam(paramsObj, 'message', { allowEmpty: true }) ?? '';
-  const caption = readStringParam(paramsObj, 'caption', { allowEmpty: true }) ?? '';
+  const message = readOpenClawStringParam(paramsObj, 'message', { allowEmpty: true }) ?? '';
+  const caption = readOpenClawStringParam(paramsObj, 'caption', { allowEmpty: true }) ?? '';
   const mediaUrl =
-    readStringParam(paramsObj, 'media', { trim: false }) ??
-    readStringParam(paramsObj, 'path', { trim: false }) ??
-    readStringParam(paramsObj, 'filePath', { trim: false }) ??
-    readStringParam(paramsObj, 'mediaUrl', { trim: false });
-  const asVoice = readBooleanParam(paramsObj, 'asVoice') ?? false;
-  const audioAsVoice = readBooleanParam(paramsObj, 'audioAsVoice') ?? false;
+    readOpenClawStringParam(paramsObj, 'media', { trim: false }) ??
+    readOpenClawStringParam(paramsObj, 'path', { trim: false }) ??
+    readOpenClawStringParam(paramsObj, 'filePath', { trim: false }) ??
+    readOpenClawStringParam(paramsObj, 'mediaUrl', { trim: false });
+  const asVoice = readOpenClawBooleanParam(paramsObj, 'asVoice') ?? false;
+  const audioAsVoice = readOpenClawBooleanParam(paramsObj, 'audioAsVoice') ?? false;
 
   if (asVoice && !mediaUrl) throw new Error('send voice requires media path');
 
@@ -1198,7 +1210,7 @@ class BncrBridgeRuntime {
     this.stopped = false;
     this.statePath = path.join(ctx.stateDir, 'bncr-bridge-state.json');
     try {
-      const cfg = this.api.runtime.config.current();
+      const cfg = getOpenClawRuntimeConfig(this.api);
       this.initializeCanonicalAgentId(cfg);
       for (const warning of resolveBncrConfigWarnings(cfg?.channels?.[CHANNEL_ID] || {})) {
         this.logWarn('config', warning);
@@ -1292,7 +1304,7 @@ class BncrBridgeRuntime {
 
   private async refreshDebugFlagFromConfig(options?: { forceLog?: boolean }) {
     try {
-      const cfg = this.api.runtime.config.current();
+      const cfg = getOpenClawRuntimeConfig(this.api);
       const raw = (cfg as any)?.channels?.[CHANNEL_ID]?.debug?.verbose;
       const next = typeof raw === 'boolean' ? raw : false;
       const changed = next !== BNCR_DEBUG_VERBOSE;
@@ -1316,7 +1328,7 @@ class BncrBridgeRuntime {
     channelId?: string;
   }): string | null {
     try {
-      const resolved = this.api.runtime.channel.routing.resolveAgentRoute({
+      const resolved = resolveOpenClawAgentRoute(this.api, {
         cfg: args.cfg,
         channel: args.channelId || CHANNEL_ID,
         accountId: normalizeAccountId(args.accountId),
@@ -1440,7 +1452,7 @@ class BncrBridgeRuntime {
 
   private async loadState() {
     if (!this.statePath) return;
-    const loaded = await readJsonFileWithFallback(this.statePath, {
+    const loaded = await readOpenClawJsonFileWithFallback(this.statePath, {
       outbox: [],
       deadLetter: [],
       sessionRoutes: [],
@@ -1709,7 +1721,7 @@ class BncrBridgeRuntime {
         : null,
     };
 
-    await writeJsonFileAtomically(this.statePath, data);
+    await writeOpenClawJsonFileAtomically(this.statePath, data);
   }
 
   private resolveMessageAck(messageId: string, result: 'acked' | 'timeout' = 'acked') {
@@ -2863,10 +2875,10 @@ class BncrBridgeRuntime {
     });
   }
 
-  private prepareInboundAcceptance(args: {
+  private async prepareInboundAcceptance(args: {
     parsed: ReturnType<typeof parseBncrInboundParams>;
     canonicalAgentId: string;
-  }):
+  }): Promise<
     | {
         ok: true;
         accountId: string;
@@ -2878,7 +2890,8 @@ class BncrBridgeRuntime {
         ok: false;
         status: boolean;
         payload: ReturnType<typeof buildInboundResponsePayload>;
-      } {
+      }
+  > {
     const { parsed, canonicalAgentId } = args;
     const {
       accountId,
@@ -2915,8 +2928,8 @@ class BncrBridgeRuntime {
       };
     }
 
-    const cfg = this.api.runtime.config.current();
-    const gate = checkBncrMessageGate({
+    const cfg = getOpenClawRuntimeConfig(this.api);
+    const gate = await checkBncrMessageGate({
       parsed,
       cfg,
       account: resolveAccount(cfg, accountId),
@@ -2944,7 +2957,7 @@ class BncrBridgeRuntime {
       taskKey: extracted.taskKey,
       text,
       extractedText: extracted.text,
-      resolveAgentRoute: (params) => this.api.runtime.channel.routing.resolveAgentRoute(params),
+      resolveAgentRoute: (params) => resolveOpenClawAgentRoute(this.api, params),
     });
 
     return {
@@ -3089,7 +3102,7 @@ class BncrBridgeRuntime {
 
   private isOutboundAckRequired(accountId?: string) {
     try {
-      const cfg = this.api.runtime.config.current();
+      const cfg = getOpenClawRuntimeConfig(this.api);
       const channelCfg = (cfg as any)?.channels?.[CHANNEL_ID];
       const accountCfg =
         accountId && channelCfg?.accounts && typeof channelCfg.accounts === 'object'
@@ -3108,7 +3121,7 @@ class BncrBridgeRuntime {
   private buildRuntimeFlags(accountId?: string) {
     let ackPolicySource: 'channel' | 'default' = 'default';
     try {
-      const cfg = this.api.runtime.config.current();
+      const cfg = getOpenClawRuntimeConfig(this.api);
       const global = (cfg as any)?.channels?.[CHANNEL_ID]?.outboundRequireAck;
       if (typeof global === 'boolean') ackPolicySource = 'channel';
     } catch {
@@ -3920,7 +3933,7 @@ class BncrBridgeRuntime {
     const canonicalAgentId =
       this.canonicalAgentId ||
       this.ensureCanonicalAgentId({
-        cfg: this.api.runtime.config?.get?.() || {},
+        cfg: getOpenClawRuntimeConfigOrDefault(this.api, {}),
         accountId: acc,
         channelId: CHANNEL_ID,
         peer: { kind: 'direct', id: route.groupId === '0' ? route.userId : route.groupId },
@@ -4568,7 +4581,7 @@ class BncrBridgeRuntime {
     mediaUrl: string,
     mediaLocalRoots?: readonly string[],
   ): Promise<{ mediaBase64: string; mimeType?: string; fileName?: string }> {
-    const loaded = await this.api.runtime.media.loadWebMedia(mediaUrl, {
+    const loaded = await loadOpenClawWebMedia(this.api, mediaUrl, {
       localRoots: mediaLocalRoots,
       maxBytes: 20 * 1024 * 1024,
     });
@@ -4583,12 +4596,12 @@ class BncrBridgeRuntime {
     mediaUrl: string;
     mediaLocalRoots?: readonly string[];
   }): Promise<{
-    loaded: Awaited<ReturnType<OpenClawPluginApi['runtime']['media']['loadWebMedia']>>;
+    loaded: OpenClawLoadedMedia;
     size: number;
     mimeType?: string;
     fileName: string;
   }> {
-    const loaded = await this.api.runtime.media.loadWebMedia(params.mediaUrl, {
+    const loaded = await loadOpenClawWebMedia(this.api, params.mediaUrl, {
       localRoots: params.mediaLocalRoots,
       maxBytes: 50 * 1024 * 1024,
     });
@@ -5408,7 +5421,7 @@ class BncrBridgeRuntime {
 
   handleDiagnostics = async ({ params, respond }: GatewayRequestHandlerOptions) => {
     const accountId = normalizeAccountId(asString(params?.accountId || ''));
-    const cfg = this.api.runtime.config.current();
+    const cfg = getOpenClawRuntimeConfig(this.api);
     const runtime = this.getAccountRuntimeSnapshot(accountId);
     const diagnostics = this.buildExtendedDiagnostics(accountId);
 
@@ -5703,7 +5716,8 @@ class BncrBridgeRuntime {
         throw new Error('file sha256 mismatch');
       }
 
-      const saved = await this.api.runtime.channel.media.saveMediaBuffer(
+      const saved = await saveOpenClawChannelMediaBuffer(
+        this.api,
         merged,
         st.mimeType,
         'inbound',
@@ -6038,14 +6052,14 @@ class BncrBridgeRuntime {
     this.lastInboundAtGlobal = now();
     this.incrementCounter(this.inboundEventsByAccount, accountId);
 
-    const cfg = this.api.runtime.config.current();
+    const cfg = getOpenClawRuntimeConfig(this.api);
     const canonicalAgentId = this.ensureCanonicalAgentId({
       cfg,
       accountId,
       peer,
       channelId: CHANNEL_ID,
     });
-    const acceptance = this.prepareInboundAcceptance({ parsed, canonicalAgentId });
+    const acceptance = await this.prepareInboundAcceptance({ parsed, canonicalAgentId });
     if (!acceptance.ok) {
       respond(acceptance.status, acceptance.payload);
       return;
@@ -6352,6 +6366,65 @@ class BncrBridgeRuntime {
       createMessageId: () => randomUUID(),
     });
   };
+
+  private async enqueueChannelMessageHandoff(ctx: any, payload: ReplyPayloadInput) {
+    const accountId = normalizeAccountId(ctx.accountId);
+    const to = asString(ctx.to || '').trim();
+    const verified = this.resolveVerifiedTarget(to, accountId);
+    this.rememberSessionRoute(verified.sessionKey, accountId, verified.route);
+    const before = new Set(this.outbox.keys());
+    await this.enqueueFromReply({
+      accountId,
+      sessionKey: verified.sessionKey,
+      route: verified.route,
+      payload,
+      mediaLocalRoots: ctx.mediaLocalRoots,
+    });
+    const entries = Array.from(this.outbox.values()).filter((entry) => !before.has(entry.messageId));
+    if (!entries.length) {
+      throw new Error('bncr channel.message handoff did not enqueue an outbox entry');
+    }
+    return entries[entries.length - 1];
+  }
+
+  channelMessageSendText = async (ctx: any) => {
+    const entry = await this.enqueueChannelMessageHandoff(ctx, {
+      text: asString(ctx.text || ''),
+      kind: ctx?.kind,
+      replyToId: this.resolveChannelSendReplyToId(ctx),
+    });
+    return buildBncrDurableQueuedResult({ entry });
+  };
+
+  channelMessageSendMedia = async (ctx: any) => {
+    const entry = await this.enqueueChannelMessageHandoff(ctx, {
+      text: asString(ctx.text || ''),
+      mediaUrl: asString(ctx.mediaUrl || ''),
+      mediaUrls: Array.isArray(ctx?.mediaUrls) ? ctx.mediaUrls : undefined,
+      asVoice: ctx?.asVoice === true,
+      audioAsVoice: ctx?.audioAsVoice === true,
+      kind: ctx?.kind,
+      replyToId: this.resolveChannelSendReplyToId(ctx),
+    });
+    return buildBncrDurableQueuedResult({ entry });
+  };
+
+  channelMessageSendPayload = async (ctx: any) => {
+    const payload = ctx?.payload || {};
+    if (!payload || typeof payload !== 'object') {
+      throw new Error('bncr channel.message payload must be an object');
+    }
+    const entry = await this.enqueueChannelMessageHandoff(ctx, {
+      text: asString(payload.text || payload.message || payload.caption || ''),
+      mediaUrl: asString(payload.mediaUrl || ''),
+      mediaUrls: Array.isArray(payload.mediaUrls) ? payload.mediaUrls : undefined,
+      asVoice: payload.asVoice === true,
+      audioAsVoice: payload.audioAsVoice === true,
+      kind: payload.kind,
+      replyToId: asString(payload.replyToId || ctx?.replyToId || ctx?.replyToMessageId || '').trim() || undefined,
+    });
+    return buildBncrDurableQueuedResult({ entry });
+  };
 }
 
 export function createBncrBridge(api: OpenClawPluginApi) {
@@ -6387,7 +6460,7 @@ export function createBncrChannelPlugin(getBridge: () => BncrBridgeRuntime) {
       };
     },
     supportsAction: ({ action }) => action === 'send',
-    extractToolSend: ({ args }) => extractToolSend(args, 'sendMessage'),
+    extractToolSend: ({ args })  => extractOpenClawToolSend(args, 'sendMessage'),
     handleAction: async ({ action, params, accountId, mediaLocalRoots }) => {
       if (action !== 'send')
         throw new Error(`Action ${action} is not supported for provider ${CHANNEL_ID}.`);
@@ -6425,7 +6498,7 @@ export function createBncrChannelPlugin(getBridge: () => BncrBridgeRuntime) {
             createMessageId: () => randomUUID(),
           });
 
-      return jsonResult({ ok: true, ...result });
+      return openClawJsonResult({ ok: true, ...result });
     },
   };
 
@@ -6440,6 +6513,17 @@ export function createBncrChannelPlugin(getBridge: () => BncrBridgeRuntime) {
       aliases: ['bncr'],
     },
     actions: messageActions,
+    message: {
+      receive: {
+        defaultAckPolicy: 'manual' as const,
+        supportedAckPolicies: ['manual'] as const,
+      },
+      send: {
+        text: async (ctx: any) => getBridge().channelMessageSendText(ctx),
+        media: async (ctx: any) => getBridge().channelMessageSendMedia(ctx),
+        payload: async (ctx: any) => getBridge().channelMessageSendPayload(ctx),
+      },
+    },
     capabilities: {
       chatTypes: ['direct'] as ChatType[],
       media: true,
@@ -6528,7 +6612,7 @@ export function createBncrChannelPlugin(getBridge: () => BncrBridgeRuntime) {
       listAccountIds,
       resolveAccount,
       setAccountEnabled: ({ cfg, accountId, enabled }: any) =>
-        setAccountEnabledInConfigSection({
+        setOpenClawAccountEnabledInConfigSection({
           cfg,
           sectionKey: CHANNEL_ID,
           accountId,
@@ -6552,7 +6636,7 @@ export function createBncrChannelPlugin(getBridge: () => BncrBridgeRuntime) {
     },
     setup: {
       applyAccountName: ({ cfg, accountId, name }: any) =>
-        applyAccountNameToChannelSection({
+        applyOpenClawAccountNameToChannelSection({
           cfg,
           channelKey: CHANNEL_ID,
           accountId,
@@ -6604,7 +6688,7 @@ export function createBncrChannelPlugin(getBridge: () => BncrBridgeRuntime) {
         }),
     },
     status: {
-      defaultRuntime: createDefaultChannelRuntimeState(BNCR_DEFAULT_ACCOUNT_ID, {
+      defaultRuntime: createOpenClawDefaultChannelRuntimeState(BNCR_DEFAULT_ACCOUNT_ID, {
         mode: 'ws-offline',
       }),
       buildChannelSummary: async ({ defaultAccountId }: any) => {

package/src/core/targets.ts

@@ -51,8 +51,17 @@ function parseRouteFromStandardDisplayScope(scope: string): BncrRoute | null {
   return null;
 }
 
-export function parseRouteFromDisplayScope(scope: string): BncrRoute | null {
+function normalizeDisplayScopePrefix(scope: string): string {
   const raw = asString(scope).trim();
+  if (!raw) return '';
+  if (raw.startsWith('Bncr:')) return raw;
+  if (/^bncr[:-]/i.test(raw)) return raw;
+  if (!parseRouteFromStandardDisplayScope(raw)) return raw;
+  return `Bncr:${raw}`;
+}
+
+export function parseRouteFromDisplayScope(scope: string): BncrRoute | null {
+  const raw = normalizeDisplayScopePrefix(scope);
   if (!raw) return null;
 
   const payload = raw.match(/^Bncr:(.+)$/)?.[1];