@clawling/clawchat-plugin-openclaw 2026.7.29-1 → 2026.7.29-3

package/dist/src/awareness-note-turn.js

@@ -16,7 +16,7 @@ export function buildAwarenessNoteEnvelope(params) {
         event: EVENT.MESSAGE_SEND,
         trace_id: `clawchat-plugin-openclaw-awareness-${now}`,
         emitted_at: now,
-        chat_id: ownerConversationId ?? account.ownerUserId,
+        chat_id: ownerConversationId,
         chat_type: "direct",
         to: { id: account.userId, type: "direct" },
         sender: { id: "clawchat-awareness", type: "direct", nick_name: "ClawChat" },

package/dist/src/no-reply.js

@@ -8,10 +8,12 @@
  * anchored, wrapping decorations (`<>`, `[]`, `{}`, `/`, backticks, `*`) are
  * tolerated for free and must not be written into the pattern itself.
  *
- * RULE B — the host's bare markers (`NO_REPLY` / `[SILENT]` / `SILENT` /
- * `NO REPLY`), matched as a WHOLE STRING ONLY. These are ordinary English
- * words; substring-matching them would swallow prose such as "there is no reply
- * from the server".
+ * RULE B — bare runtime silence markers (`NO_REPLY` / `[SILENT]` / `SILENT` /
+ * `NO REPLY`), matched as a WHOLE STRING ONLY. OpenClaw itself has no such
+ * convention; these are carried because other agent runtimes define them, so a
+ * model may fall back to one instead of the `clawchat:` form. They are ordinary
+ * English words — substring-matching them would swallow prose such as "there is
+ * no reply from the server".
  *
  * This module MUST stay a literal mirror of the Hermes plugin's equivalent
  * module. When one side changes, change the other in the same breath.

package/dist/src/permission-result.js

@@ -64,9 +64,16 @@ function buildOutcomeNote(metadata) {
  * Mirrors the `buildAwarenessNoteEnvelope` pattern: a synthetic inbound
  * `message.send` targeting the owner's direct conversation, routed through
  * `handleInboundEnvelope` so the agent can reason about the outcome.
+ *
+ * `ownerConversationId` MUST be the owner's direct conversation id (`cnv_…`)
+ * recorded at activation, never `account.ownerUserId`. The agent's in-turn
+ * reply inherits this note's `chat_id`, and msghub resolves chat_id through
+ * member-backend — a `usr_…` there comes back "invalid conversation id", so the
+ * reply is dropped and the sender never learns. Hence the required non-null
+ * parameter: there is no safe value to fall back to.
  */
 export function buildPermissionResultEnvelope(params) {
-    const { account, metadata } = params;
+    const { account, metadata, ownerConversationId } = params;
     const text = buildOutcomeNote(metadata);
     const now = Date.now();
     return {
@@ -74,7 +81,7 @@ export function buildPermissionResultEnvelope(params) {
         event: EVENT.MESSAGE_SEND,
         trace_id: `clawchat-plugin-openclaw-permission-result-${metadata.request_id}-${now}`,
         emitted_at: now,
-        chat_id: account.ownerUserId,
+        chat_id: ownerConversationId,
         chat_type: "direct",
         to: { id: account.userId, type: "direct" },
         sender: {
@@ -109,12 +116,20 @@ export function buildPermissionResultEnvelope(params) {
  *
  * Returns a synthetic context-note {@link Envelope} on a fresh receipt so
  * the caller can feed it to `handleInboundEnvelope`; returns `null` when
- * the `request_id` has already been processed.
+ * the `request_id` has already been processed, or when `ownerConversationId`
+ * is absent.
+ *
+ * A null `ownerConversationId` (activation has not recorded the owner's direct
+ * conversation yet) is checked BEFORE the dedup mark on purpose: the receipt
+ * cannot be routed anywhere, so burning its dedup slot would permanently
+ * swallow it — the replayed copy must still render once the id is known.
  */
-export function handlePermissionResult(metadata, account) {
+export function handlePermissionResult(metadata, account, ownerConversationId) {
+    if (!ownerConversationId)
+        return null;
     if (metadata.request_id && _seenRequestIds.has(metadata.request_id))
         return null;
     if (metadata.request_id)
         _seenRequestIds.add(metadata.request_id);
-    return buildPermissionResultEnvelope({ account, metadata });
+    return buildPermissionResultEnvelope({ account, metadata, ownerConversationId });
 }

package/dist/src/reply-dispatcher.js

@@ -256,14 +256,23 @@ function formatApprovalSummary(payload) {
  * as separate ClawChat messages.
  */
 export function createOpenclawClawlingReplyDispatcher(options) {
-    const { cfg, runtime, account, client, target, replyCtx, inboundMessageId, store, log, } = options;
+    const { cfg, runtime, account, client, target, replyCtx, inboundMessageId, store, resolveOwnerConversationId, log, } = options;
     const isGroupTarget = target.chatType === "group";
     const outputVisibility = effectiveOutputVisibility(account, target.chatId, target.chatType);
     const splitFullOutput = outputVisibility === "full";
     const splitNormalBlockOutput = outputVisibility === "normal";
+    // The escalation target is the owner's ACTIVATION CONVERSATION id, never the
+    // owner's usr_… id: chat_id is resolved by msghub through member-backend, and
+    // a usr_… comes back "invalid conversation id" — the frame is dropped with no
+    // negative ack to this client, so the owner silently never gets the approval
+    // request. Both ids are required: ownerUserId gates whether an owner exists at
+    // all, the conversation id is where a frame can actually be delivered.
     const ownerDirectTarget = () => {
         const ownerUserId = account.ownerUserId?.trim();
-        return ownerUserId ? { chatId: ownerUserId, chatType: "direct" } : null;
+        if (!ownerUserId)
+            return null;
+        const conversationId = resolveOwnerConversationId?.()?.trim();
+        return conversationId ? { chatId: conversationId, chatType: "direct" } : null;
     };
     const humanDelay = runtime.channel.reply.resolveHumanDelayConfig(cfg, account.userId);
     const buildApiClient = () => {
@@ -448,7 +457,10 @@ export function createOpenclawClawlingReplyDispatcher(options) {
     const sendOwnerAttention = async (fallbackText, richFragment = null) => {
         const ownerTarget = ownerDirectTarget();
         if (!ownerTarget) {
-            log?.error?.(`[${account.accountId}] clawchat-plugin-openclaw group owner attention suppressed reason=missing_owner_user_id group=${target.chatId}`);
+            const reason = account.ownerUserId?.trim()
+                ? "missing_owner_conversation"
+                : "missing_owner_user_id";
+            log?.error?.(`[${account.accountId}] clawchat-plugin-openclaw group owner attention suppressed reason=${reason} group=${target.chatId}`);
             return;
         }
         await sendOpenclawClawlingText({

package/dist/src/runtime.js

@@ -2028,10 +2028,16 @@ export async function startOpenclawClawlingGateway(params) {
                     pendingAwarenessNote = true;
                     queueMicrotask(() => {
                         pendingAwarenessNote = false;
-                        void handleInboundEnvelope(buildAwarenessNoteEnvelope({
-                            account,
-                            ownerConversationId: resolveOwnerDirectConversationId(),
-                        }));
+                        // No activation conversation ⇒ no routable chat_id. Skip the note
+                        // rather than address it to the owner's usr_… id, which
+                        // member-backend rejects as "invalid conversation id" (the agent's
+                        // in-turn replies are then dropped with no negative ack).
+                        const ownerConversationId = resolveOwnerDirectConversationId();
+                        if (!ownerConversationId) {
+                            log?.info?.(`[${accountId}] clawchat-plugin-openclaw awareness note skipped: no activation conversation recorded`);
+                            return;
+                        }
+                        void handleInboundEnvelope(buildAwarenessNoteEnvelope({ account, ownerConversationId }));
                     });
                 }
             }
@@ -2405,6 +2411,10 @@ export async function startOpenclawClawlingGateway(params) {
                         updateMessageByIdentity: (input) => store.updateMessageByIdentity?.(input),
                     }
                     : null,
+                // Group owner-attention escalations address the owner's activation
+                // conversation, not `ownerUserId` (a usr_… chat_id is rejected by
+                // member-backend). Passed as a thunk so it is resolved at send time.
+                resolveOwnerConversationId: resolveOwnerDirectConversationId,
                 log,
             });
             const agentsConfigured = Object.keys(cfg.agents ?? {});
@@ -2658,7 +2668,21 @@ export async function startOpenclawClawlingGateway(params) {
                     // A permission_result receipt closes the loop on an earlier request.
                     // Dedup by request_id; on a fresh receipt feed the synthetic context
                     // note back to the agent so it can react to the outcome.
-                    const note = handlePermissionResult(metadata, account);
+                    //
+                    // The note is addressed to the owner's ACTIVATION CONVERSATION id
+                    // (cnv_…), never `account.ownerUserId`: the agent's in-turn reply
+                    // inherits this chat_id, and member-backend rejects a usr_… with
+                    // "invalid conversation id" — the reply is then dropped server-side
+                    // with no negative ack, so the outcome silently never reaches the
+                    // owner. With no conversation on record the receipt is skipped
+                    // outright (see handlePermissionResult — the dedup slot is preserved
+                    // so a replay after activation still renders).
+                    const ownerConversationId = resolveOwnerDirectConversationId();
+                    if (!ownerConversationId) {
+                        log?.info?.(`[${accountId}] clawchat-plugin-openclaw permission_result receipt op=${metadata.operation} outcome=${metadata.outcome} request_id=${metadata.request_id} skipped: no activation conversation recorded`);
+                        return;
+                    }
+                    const note = handlePermissionResult(metadata, account, ownerConversationId);
                     if (note) {
                         log?.info?.(`[${accountId}] clawchat-plugin-openclaw permission_result receipt op=${metadata.operation} outcome=${metadata.outcome} request_id=${metadata.request_id}; dispatching context note`);
                         void handleInboundEnvelope(note);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawling/clawchat-plugin-openclaw",
-  "version": "2026.7.29-1",
+  "version": "2026.7.29-3",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "author": "CLAWLING PTE. LTD.",

package/src/awareness-note-turn.ts

@@ -13,11 +13,15 @@ import type { ResolvedOpenclawClawlingAccount } from "./config.ts";
 export interface BuildAwarenessNoteEnvelopeParams {
   account: ResolvedOpenclawClawlingAccount;
   /**
-   * The owner's direct conversation id (cnv_…) recorded at activation, or
-   * null when none is recorded (the note still runs, but replies will not be
-   * deliverable until activation records the owner conversation).
+   * The owner's direct conversation id (cnv_…) recorded at activation.
+   *
+   * Required and non-null: there is no valid fallback. Addressing the note to
+   * `account.ownerUserId` instead makes the agent's in-turn replies unroutable
+   * (member-backend answers "invalid conversation id"), so callers must skip
+   * the note entirely while no conversation is on record rather than hand a
+   * usr_… id down here.
    */
-  ownerConversationId: string | null;
+  ownerConversationId: string;
 }
 
 export function buildAwarenessNoteEnvelope(
@@ -30,7 +34,7 @@ export function buildAwarenessNoteEnvelope(
     event: EVENT.MESSAGE_SEND,
     trace_id: `clawchat-plugin-openclaw-awareness-${now}`,
     emitted_at: now,
-    chat_id: ownerConversationId ?? account.ownerUserId,
+    chat_id: ownerConversationId,
     chat_type: "direct",
     to: { id: account.userId, type: "direct" },
     sender: { id: "clawchat-awareness", type: "direct", nick_name: "ClawChat" },

package/src/no-reply.ts

@@ -8,10 +8,12 @@
  * anchored, wrapping decorations (`<>`, `[]`, `{}`, `/`, backticks, `*`) are
  * tolerated for free and must not be written into the pattern itself.
  *
- * RULE B — the host's bare markers (`NO_REPLY` / `[SILENT]` / `SILENT` /
- * `NO REPLY`), matched as a WHOLE STRING ONLY. These are ordinary English
- * words; substring-matching them would swallow prose such as "there is no reply
- * from the server".
+ * RULE B — bare runtime silence markers (`NO_REPLY` / `[SILENT]` / `SILENT` /
+ * `NO REPLY`), matched as a WHOLE STRING ONLY. OpenClaw itself has no such
+ * convention; these are carried because other agent runtimes define them, so a
+ * model may fall back to one instead of the `clawchat:` form. They are ordinary
+ * English words — substring-matching them would swallow prose such as "there is
+ * no reply from the server".
  *
  * This module MUST stay a literal mirror of the Hermes plugin's equivalent
  * module. When one side changes, change the other in the same breath.

package/src/permission-result.ts

@@ -79,12 +79,20 @@ function buildOutcomeNote(metadata: PermissionResultMetadata): string {
  * Mirrors the `buildAwarenessNoteEnvelope` pattern: a synthetic inbound
  * `message.send` targeting the owner's direct conversation, routed through
  * `handleInboundEnvelope` so the agent can reason about the outcome.
+ *
+ * `ownerConversationId` MUST be the owner's direct conversation id (`cnv_…`)
+ * recorded at activation, never `account.ownerUserId`. The agent's in-turn
+ * reply inherits this note's `chat_id`, and msghub resolves chat_id through
+ * member-backend — a `usr_…` there comes back "invalid conversation id", so the
+ * reply is dropped and the sender never learns. Hence the required non-null
+ * parameter: there is no safe value to fall back to.
  */
 export function buildPermissionResultEnvelope(params: {
   account: Pick<ResolvedOpenclawClawlingAccount, "userId" | "ownerUserId">;
   metadata: PermissionResultMetadata;
+  ownerConversationId: string;
 }): Envelope {
-  const { account, metadata } = params;
+  const { account, metadata, ownerConversationId } = params;
   const text = buildOutcomeNote(metadata);
   const now = Date.now();
   return {
@@ -92,7 +100,7 @@ export function buildPermissionResultEnvelope(params: {
     event: EVENT.MESSAGE_SEND,
     trace_id: `clawchat-plugin-openclaw-permission-result-${metadata.request_id}-${now}`,
     emitted_at: now,
-    chat_id: account.ownerUserId,
+    chat_id: ownerConversationId,
     chat_type: "direct",
     to: { id: account.userId, type: "direct" },
     sender: {
@@ -128,13 +136,21 @@ export function buildPermissionResultEnvelope(params: {
  *
  * Returns a synthetic context-note {@link Envelope} on a fresh receipt so
  * the caller can feed it to `handleInboundEnvelope`; returns `null` when
- * the `request_id` has already been processed.
+ * the `request_id` has already been processed, or when `ownerConversationId`
+ * is absent.
+ *
+ * A null `ownerConversationId` (activation has not recorded the owner's direct
+ * conversation yet) is checked BEFORE the dedup mark on purpose: the receipt
+ * cannot be routed anywhere, so burning its dedup slot would permanently
+ * swallow it — the replayed copy must still render once the id is known.
  */
 export function handlePermissionResult(
   metadata: PermissionResultMetadata,
   account: Pick<ResolvedOpenclawClawlingAccount, "userId" | "ownerUserId">,
+  ownerConversationId: string | null,
 ): Envelope | null {
+  if (!ownerConversationId) return null;
   if (metadata.request_id && _seenRequestIds.has(metadata.request_id)) return null;
   if (metadata.request_id) _seenRequestIds.add(metadata.request_id);
-  return buildPermissionResultEnvelope({ account, metadata });
+  return buildPermissionResultEnvelope({ account, metadata, ownerConversationId });
 }

package/src/reply-dispatcher.ts

@@ -59,6 +59,18 @@ export interface ReplyDispatcherOptions {
     ClawChatStore,
     "insertMessage" | "claimMessageOnce" | "markMessageAcknowledged" | "updateMessageByIdentity"
   > | null;
+  /**
+   * Resolves the owner's direct conversation id (`cnv_…`) recorded at
+   * activation, or null when none is on record. Used only by the group
+   * owner-attention escalation, which must address a conversation id — NOT
+   * `account.ownerUserId`. member-backend rejects a `usr_…` chat_id with
+   * "invalid conversation id", so such an escalation is dropped server-side
+   * and the owner never sees it.
+   *
+   * Called lazily at send time, so an activation that lands after this
+   * dispatcher was constructed is still picked up.
+   */
+  resolveOwnerConversationId?: () => string | null;
   log?: { info?: (m: string) => void; error?: (m: string) => void };
 }
 
@@ -387,15 +399,24 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
     replyCtx,
     inboundMessageId,
     store,
+    resolveOwnerConversationId,
     log,
   } = options;
   const isGroupTarget = target.chatType === "group";
   const outputVisibility = effectiveOutputVisibility(account, target.chatId, target.chatType);
   const splitFullOutput = outputVisibility === "full";
   const splitNormalBlockOutput = outputVisibility === "normal";
-  const ownerDirectTarget = () => {
+  // The escalation target is the owner's ACTIVATION CONVERSATION id, never the
+  // owner's usr_… id: chat_id is resolved by msghub through member-backend, and
+  // a usr_… comes back "invalid conversation id" — the frame is dropped with no
+  // negative ack to this client, so the owner silently never gets the approval
+  // request. Both ids are required: ownerUserId gates whether an owner exists at
+  // all, the conversation id is where a frame can actually be delivered.
+  const ownerDirectTarget = (): { chatId: string; chatType: "direct" } | null => {
     const ownerUserId = account.ownerUserId?.trim();
-    return ownerUserId ? { chatId: ownerUserId, chatType: "direct" as const } : null;
+    if (!ownerUserId) return null;
+    const conversationId = resolveOwnerConversationId?.()?.trim();
+    return conversationId ? { chatId: conversationId, chatType: "direct" as const } : null;
   };
   const humanDelay = runtime.channel.reply.resolveHumanDelayConfig(cfg, account.userId);
 
@@ -585,8 +606,11 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
   ): Promise<void> => {
     const ownerTarget = ownerDirectTarget();
     if (!ownerTarget) {
+      const reason = account.ownerUserId?.trim()
+        ? "missing_owner_conversation"
+        : "missing_owner_user_id";
       log?.error?.(
-        `[${account.accountId}] clawchat-plugin-openclaw group owner attention suppressed reason=missing_owner_user_id group=${target.chatId}`,
+        `[${account.accountId}] clawchat-plugin-openclaw group owner attention suppressed reason=${reason} group=${target.chatId}`,
       );
       return;
     }

package/src/runtime.ts

@@ -2451,11 +2451,19 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
           pendingAwarenessNote = true;
           queueMicrotask(() => {
             pendingAwarenessNote = false;
+            // No activation conversation ⇒ no routable chat_id. Skip the note
+            // rather than address it to the owner's usr_… id, which
+            // member-backend rejects as "invalid conversation id" (the agent's
+            // in-turn replies are then dropped with no negative ack).
+            const ownerConversationId = resolveOwnerDirectConversationId();
+            if (!ownerConversationId) {
+              log?.info?.(
+                `[${accountId}] clawchat-plugin-openclaw awareness note skipped: no activation conversation recorded`,
+              );
+              return;
+            }
             void handleInboundEnvelope(
-              buildAwarenessNoteEnvelope({
-                account,
-                ownerConversationId: resolveOwnerDirectConversationId(),
-              }),
+              buildAwarenessNoteEnvelope({ account, ownerConversationId }),
             );
           });
         }
@@ -2864,6 +2872,10 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
                 updateMessageByIdentity: (input) => store.updateMessageByIdentity?.(input),
               }
             : null,
+          // Group owner-attention escalations address the owner's activation
+          // conversation, not `ownerUserId` (a usr_… chat_id is rejected by
+          // member-backend). Passed as a thunk so it is resolved at send time.
+          resolveOwnerConversationId: resolveOwnerDirectConversationId,
           log,
         });
 
@@ -3164,7 +3176,23 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
           // A permission_result receipt closes the loop on an earlier request.
           // Dedup by request_id; on a fresh receipt feed the synthetic context
           // note back to the agent so it can react to the outcome.
-          const note = handlePermissionResult(metadata, account);
+          //
+          // The note is addressed to the owner's ACTIVATION CONVERSATION id
+          // (cnv_…), never `account.ownerUserId`: the agent's in-turn reply
+          // inherits this chat_id, and member-backend rejects a usr_… with
+          // "invalid conversation id" — the reply is then dropped server-side
+          // with no negative ack, so the outcome silently never reaches the
+          // owner. With no conversation on record the receipt is skipped
+          // outright (see handlePermissionResult — the dedup slot is preserved
+          // so a replay after activation still renders).
+          const ownerConversationId = resolveOwnerDirectConversationId();
+          if (!ownerConversationId) {
+            log?.info?.(
+              `[${accountId}] clawchat-plugin-openclaw permission_result receipt op=${metadata.operation} outcome=${metadata.outcome} request_id=${metadata.request_id} skipped: no activation conversation recorded`,
+            );
+            return;
+          }
+          const note = handlePermissionResult(metadata, account, ownerConversationId);
           if (note) {
             log?.info?.(
               `[${accountId}] clawchat-plugin-openclaw permission_result receipt op=${metadata.operation} outcome=${metadata.outcome} request_id=${metadata.request_id}; dispatching context note`,

package/dist/src/friend-request-turn.js

@@ -1,83 +0,0 @@
-/**
- * Synthetic reasoning-turn builder for `friend.request` notify.signal events.
- *
- * When the server fires a `friend.request` signal the runtime dispatches one
- * deduped synthetic `message.send` envelope so the agent can reason about the
- * pending request. The prompt text varies by the current "friend.add" permission
- * policy state: a deny policy yields a decline/inform prompt; ask or allow
- * yields a prompt that instructs the agent to review the request via the
- * `clawchat_list_friend_requests` tool.
- */
-import { EVENT } from "./protocol-types.js";
-/**
- * Returns canned prompt text for a friend-request reasoning turn based on the
- * current "friend.add" permission policy state.
- *
- * - `deny`  → inform the agent it should decline; no accept instruction.
- * - `ask` / `allow` → instruct the agent to review the pending request.
- *
- * The requester's user id is embedded so the agent does not go looking up the
- * synthetic sender ("clawchat-friend-request" is not a real user).
- */
-export function friendRequestPromptFor(state, requesterUserId) {
-    const arrived = requesterUserId
-        ? `A new friend request has arrived from user ${requesterUserId}.`
-        : "A new friend request has arrived.";
-    if (state === "deny") {
-        return [
-            arrived,
-            "Your current friend-add policy is set to deny.",
-            "Do not add this contact.",
-            "You may inform the requester that you cannot add them at this time.",
-        ].join(" ");
-    }
-    return [
-        arrived,
-        "Please review the pending request by calling `clawchat_list_friend_requests`",
-        "and decide whether to accept it.",
-    ].join(" ");
-}
-/**
- * Builds a synthetic `message.send` envelope that triggers one agent reasoning
- * turn for a pending friend request. The envelope shape mirrors the
- * activation-bootstrap envelope; it targets the owner's direct conversation so
- * the agent has context about who it is reasoning for.
- */
-export function buildFriendRequestEnvelope(params) {
-    const { account, state, entityId, ownerConversationId } = params;
-    const text = friendRequestPromptFor(state, entityId);
-    const now = Date.now();
-    // Fall back to ownerUserId only when no activation conversation is recorded:
-    // the turn still runs (the agent can act via tools, e.g. accept the request),
-    // but its in-chat replies will not be deliverable until activation records
-    // the owner conversation.
-    return {
-        version: "2",
-        event: EVENT.MESSAGE_SEND,
-        trace_id: `clawchat-plugin-openclaw-friend-request-${entityId}-${now}`,
-        emitted_at: now,
-        chat_id: ownerConversationId ?? account.ownerUserId,
-        chat_type: "direct",
-        to: { id: account.userId, type: "direct" },
-        sender: {
-            id: "clawchat-friend-request",
-            type: "direct",
-            nick_name: "ClawChat",
-        },
-        payload: {
-            message_id: `clawchat-plugin-openclaw-friend-request-${entityId}-${now}`,
-            message_mode: "normal",
-            message: {
-                body: { fragments: [{ kind: "text", text }] },
-                context: { mentions: [], reply: null },
-                streaming: {
-                    status: "static",
-                    sequence: 0,
-                    mutation_policy: "sealed",
-                    started_at: null,
-                    completed_at: null,
-                },
-            },
-        },
-    };
-}