@clawling/clawchat-plugin-openclaw 2026.5.12-31 → 2026.5.12-32

package/dist/src/commands.js

@@ -64,18 +64,16 @@ function persistOutputVisibility(draft, chatId, outputVisibility) {
     });
 }
 function formatOutputVisibilityResult(outputVisibility) {
-    const runtimeStatus = outputVisibility === "full" ? "on" : "off";
     const detailLevel = {
-        minimal: "quiet",
-        normal: "normal",
-        full: "verbose",
+        minimal: "final only",
+        normal: "final plus block media",
+        full: "final plus buffered reasoning, tool/progress, and block output",
     };
     return [
         "**ClawChat output updated**",
         "",
         `- visibility: \`${outputVisibility}\``,
-        `- runtime status: \`${runtimeStatus}\``,
-        `- detail level: \`${detailLevel[outputVisibility]}\``,
+        `- output: \`${detailLevel[outputVisibility]}\``,
         "",
         "Applies to new ClawChat messages.",
     ].join("\n");

package/dist/src/config.js

@@ -191,6 +191,29 @@ function readGroupMode(value) {
 function readGroupCommandMode(value) {
     return value === "all" || value === "off" ? value : "owner";
 }
+function readOutputVisibility(value) {
+    return value === "minimal" || value === "full" ? value : "normal";
+}
+function readOptionalOutputVisibility(value) {
+    return value === "minimal" || value === "normal" || value === "full" ? value : undefined;
+}
+function readChats(value) {
+    const rawChats = value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+    const chats = {};
+    for (const [chatId, rawChat] of Object.entries(rawChats)) {
+        if (!chatId)
+            continue;
+        const chat = rawChat && typeof rawChat === "object" && !Array.isArray(rawChat)
+            ? rawChat
+            : {};
+        const outputVisibility = readOptionalOutputVisibility(chat.outputVisibility);
+        if (outputVisibility)
+            chats[chatId] = { outputVisibility };
+    }
+    return chats;
+}
 function readGroups(value) {
     const rawGroups = value && typeof value === "object" && !Array.isArray(value)
         ? value
@@ -202,9 +225,11 @@ function readGroups(value) {
         const group = rawGroup && typeof rawGroup === "object" && !Array.isArray(rawGroup)
             ? rawGroup
             : {};
+        const outputVisibility = readOptionalOutputVisibility(group.outputVisibility);
         groups[chatId] = {
             groupMode: readGroupMode(group.groupMode),
             groupCommandMode: readGroupCommandMode(group.groupCommandMode),
+            ...(outputVisibility ? { outputVisibility } : {}),
         };
     }
     return groups;
@@ -219,6 +244,13 @@ export function effectiveGroupCommandMode(account, chatId) {
         ?? account.groups["*"]?.groupCommandMode
         ?? account.groupCommandMode;
 }
+export function effectiveOutputVisibility(account, chatId, chatType) {
+    return account.chats?.[chatId]?.outputVisibility
+        ?? (chatType === "group" ? account.groups?.[chatId]?.outputVisibility : undefined)
+        ?? (chatType === "group" ? account.groups?.["*"]?.outputVisibility : undefined)
+        ?? account.outputVisibility
+        ?? "normal";
+}
 function readReconnect(raw) {
     const s = raw && typeof raw === "object" ? raw : {};
     return {
@@ -261,6 +293,8 @@ export function resolveOpenclawClawlingAccount(cfg, env = process.env) {
     const userId = readOptionalString(channel.userId) || readEnvString(env, CLAWCHAT_USER_ID_ENV);
     const ownerUserId = readOptionalString(channel.ownerUserId) || readEnvString(env, CLAWCHAT_OWNER_USER_ID_ENV);
     const enabled = typeof channel.enabled === "boolean" ? channel.enabled : true;
+    const outputVisibility = readOutputVisibility(channel.outputVisibility);
+    const chats = readChats(channel.chats);
     const groupMode = readGroupMode(channel.groupMode);
     const groupCommandMode = readGroupCommandMode(channel.groupCommandMode);
     const groups = readGroups(channel.groups);
@@ -284,6 +318,8 @@ export function resolveOpenclawClawlingAccount(cfg, env = process.env) {
         agentId,
         userId,
         ownerUserId,
+        outputVisibility,
+        chats,
         groupMode,
         groupCommandMode,
         groups,

package/dist/src/reply-dispatcher.js

@@ -1,6 +1,7 @@
 import { interactiveReplyToPresentation, renderMessagePresentationFallbackText, } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolveOutboundMediaUrls } from "openclaw/plugin-sdk/reply-payload";
 import { createOpenclawClawlingApiClient } from "./api-client.js";
+import { effectiveOutputVisibility, } from "./config.js";
 import { uploadOutboundMedia } from "./media-runtime.js";
 import { sendOpenclawClawlingText, } from "./outbound.js";
 import { isClawChatNoopResponseText } from "./profile-prompt.js";
@@ -106,15 +107,14 @@ function resolvePayloadText(payload) {
 /**
  * Reply dispatcher for clawchat-plugin-openclaw.
  *
- * The plugin intentionally forces complete-message delivery. It sets
- * `disableBlockStreaming: true` in reply options so OpenClaw does not split
- * deliver blocks for this channel. If the host still delivers non-final
- * blocks, the dispatcher buffers or ignores them and only emits materialized
- * `message.send` / `message.reply` frames for the final reply.
+ * ClawChat emits only materialized `message.send` / `message.reply` frames for
+ * the final reply. Non-final OpenClaw deliveries are ignored or buffered
+ * according to outputVisibility and are never sent as separate ClawChat frames.
  */
 export function createOpenclawClawlingReplyDispatcher(options) {
     const { cfg, runtime, account, client, target, replyCtx, inboundMessageId, store, log, } = options;
     const isGroupTarget = target.chatType === "group";
+    const outputVisibility = effectiveOutputVisibility(account, target.chatId, target.chatType);
     const ownerDirectTarget = () => {
         const ownerUserId = account.ownerUserId?.trim();
         return ownerUserId ? { chatId: ownerUserId, chatType: "direct" } : null;
@@ -142,6 +142,8 @@ export function createOpenclawClawlingReplyDispatcher(options) {
     }
     // ----- Reply state ------------------------------------------------------
     let reasoningText = "";
+    let bufferedOutputText = "";
+    const bufferedOutputUrls = [];
     let runDone = false;
     let typingActive = false;
     let terminalReplySuppressed = false;
@@ -229,6 +231,37 @@ export function createOpenclawClawlingReplyDispatcher(options) {
         recordOutbound("thinking", messageId, thinkingText);
         reasoningText = "";
     };
+    const resetBufferedOutput = () => {
+        bufferedOutputText = "";
+        bufferedOutputUrls.length = 0;
+    };
+    const appendBufferedText = (value) => {
+        const trimmed = value.trim();
+        if (!trimmed)
+            return;
+        bufferedOutputText = bufferedOutputText ? `${bufferedOutputText}\n${trimmed}` : trimmed;
+    };
+    const appendBufferedUrls = (urls) => {
+        for (const url of urls) {
+            if (url && !bufferedOutputUrls.includes(url))
+                bufferedOutputUrls.push(url);
+        }
+    };
+    const mergeFinalText = (text) => {
+        if (outputVisibility !== "full")
+            return text;
+        return [bufferedOutputText.trim(), text.trim()].filter(Boolean).join("\n");
+    };
+    const mergeFinalUrls = (urls) => {
+        if (outputVisibility === "minimal")
+            return urls;
+        const merged = bufferedOutputUrls.slice();
+        for (const url of urls) {
+            if (url && !merged.includes(url))
+                merged.push(url);
+        }
+        return merged;
+    };
     const mintStaticMessageId = () => `${account.userId}-msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     const emitTyping = (isTyping) => {
         if (!isTyping && !typingActive)
@@ -342,6 +375,7 @@ export function createOpenclawClawlingReplyDispatcher(options) {
         onReplyStart: async () => {
             emitTyping(true);
             reasoningText = "";
+            resetBufferedOutput();
             runDone = false;
         },
         deliver: async (payload, info) => {
@@ -362,13 +396,30 @@ export function createOpenclawClawlingReplyDispatcher(options) {
                 return;
             }
             if (payload.isReasoning) {
-                if (isGroupTarget || !account.forwardThinking)
+                if (isGroupTarget || outputVisibility !== "full")
                     return;
-                reasoningText = text;
+                appendBufferedText(text);
+                const trimmed = text.trim();
+                if (trimmed)
+                    reasoningText = reasoningText ? `${reasoningText}\n${trimmed}` : trimmed;
+                return;
+            }
+            if (info?.kind === "tool") {
+                if (!isGroupTarget && outputVisibility === "full") {
+                    appendBufferedText(text);
+                    appendBufferedUrls(urls);
+                }
                 return;
             }
-            if (info?.kind === "tool")
+            if (info?.kind === "block") {
+                if (!isGroupTarget && outputVisibility === "normal")
+                    appendBufferedUrls(urls);
+                if (!isGroupTarget && outputVisibility === "full") {
+                    appendBufferedText(text);
+                    appendBufferedUrls(urls);
+                }
                 return;
+            }
             if (info?.kind === "final") {
                 if (isClawChatNoopResponseText(text) && !richFragment && urls.length === 0) {
                     log?.info?.(`[${account.accountId}] clawchat-plugin-openclaw final suppressed: no-reply token`);
@@ -391,15 +442,15 @@ export function createOpenclawClawlingReplyDispatcher(options) {
                     });
                     return;
                 }
-                const mediaFragments = await uploadMediaUrls(urls);
-                const result = await sendStatic(text, mediaFragments, richFragment && account.richInteractions ? [richFragment] : [], { recordMessage: true });
+                const finalText = richFragment && account.richInteractions ? mergeFinalText("") : mergeFinalText(text);
+                const finalUrls = mergeFinalUrls(urls);
+                const mediaFragments = await uploadMediaUrls(finalUrls);
+                const result = await sendStatic(finalText, mediaFragments, richFragment && account.richInteractions ? [richFragment] : [], { recordMessage: true });
                 if (result?.messageId)
                     recordThinkingIfLinked(result.messageId);
                 return;
             }
-            // kind === "block" or unknown: OpenClaw may still call this path while
-            // the model is producing output. ClawChat gets only the final materialized
-            // reply.
+            // Unknown delivery kind: keep ClawChat output tied to OpenClaw final.
         },
         onError: (error, info) => {
             const errorText = normalizeReplyErrorText(error);
@@ -424,7 +475,7 @@ export function createOpenclawClawlingReplyDispatcher(options) {
         replyOptions: {
             ...base.replyOptions,
             sourceReplyDeliveryMode: "automatic",
-            disableBlockStreaming: true,
+            disableBlockStreaming: outputVisibility !== "full",
         },
         markDispatchIdle: base.markDispatchIdle,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawling/clawchat-plugin-openclaw",
-  "version": "2026.5.12-31",
+  "version": "2026.5.12-32",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "files": [

package/src/commands.ts

@@ -76,18 +76,16 @@ function persistOutputVisibility(
 }
 
 function formatOutputVisibilityResult(outputVisibility: OutputVisibility): string {
-  const runtimeStatus = outputVisibility === "full" ? "on" : "off";
   const detailLevel: Record<OutputVisibility, string> = {
-    minimal: "quiet",
-    normal: "normal",
-    full: "verbose",
+    minimal: "final only",
+    normal: "final plus block media",
+    full: "final plus buffered reasoning, tool/progress, and block output",
   };
   return [
     "**ClawChat output updated**",
     "",
     `- visibility: \`${outputVisibility}\``,
-    `- runtime status: \`${runtimeStatus}\``,
-    `- detail level: \`${detailLevel[outputVisibility]}\``,
+    `- output: \`${detailLevel[outputVisibility]}\``,
     "",
     "Applies to new ClawChat messages.",
   ].join("\n");

package/src/config.ts

@@ -266,6 +266,8 @@ export type ResolvedOpenclawClawlingAccount = {
   agentId: string;
   userId: string;
   ownerUserId: string;
+  outputVisibility: OutputVisibility;
+  chats: Record<string, OpenclawClawlingChatConfig>;
   groupMode: GroupMode;
   groupCommandMode: GroupCommandMode;
   groups: Record<string, OpenclawClawlingGroupConfig>;
@@ -315,6 +317,30 @@ function readGroupCommandMode(value: unknown): GroupCommandMode {
   return value === "all" || value === "off" ? value : "owner";
 }
 
+function readOutputVisibility(value: unknown): OutputVisibility {
+  return value === "minimal" || value === "full" ? value : "normal";
+}
+
+function readOptionalOutputVisibility(value: unknown): OutputVisibility | undefined {
+  return value === "minimal" || value === "normal" || value === "full" ? value : undefined;
+}
+
+function readChats(value: unknown): Record<string, OpenclawClawlingChatConfig> {
+  const rawChats = value && typeof value === "object" && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : {};
+  const chats: Record<string, OpenclawClawlingChatConfig> = {};
+  for (const [chatId, rawChat] of Object.entries(rawChats)) {
+    if (!chatId) continue;
+    const chat = rawChat && typeof rawChat === "object" && !Array.isArray(rawChat)
+      ? (rawChat as Record<string, unknown>)
+      : {};
+    const outputVisibility = readOptionalOutputVisibility(chat.outputVisibility);
+    if (outputVisibility) chats[chatId] = { outputVisibility };
+  }
+  return chats;
+}
+
 function readGroups(value: unknown): Record<string, OpenclawClawlingGroupConfig> {
   const rawGroups = value && typeof value === "object" && !Array.isArray(value)
     ? (value as Record<string, unknown>)
@@ -325,9 +351,11 @@ function readGroups(value: unknown): Record<string, OpenclawClawlingGroupConfig>
     const group = rawGroup && typeof rawGroup === "object" && !Array.isArray(rawGroup)
       ? (rawGroup as Record<string, unknown>)
       : {};
+    const outputVisibility = readOptionalOutputVisibility(group.outputVisibility);
     groups[chatId] = {
       groupMode: readGroupMode(group.groupMode),
       groupCommandMode: readGroupCommandMode(group.groupCommandMode),
+      ...(outputVisibility ? { outputVisibility } : {}),
     };
   }
   return groups;
@@ -351,6 +379,18 @@ export function effectiveGroupCommandMode(
     ?? account.groupCommandMode;
 }
 
+export function effectiveOutputVisibility(
+  account: Pick<ResolvedOpenclawClawlingAccount, "outputVisibility" | "chats" | "groups">,
+  chatId: string,
+  chatType: "direct" | "group",
+): OutputVisibility {
+  return account.chats?.[chatId]?.outputVisibility
+    ?? (chatType === "group" ? account.groups?.[chatId]?.outputVisibility : undefined)
+    ?? (chatType === "group" ? account.groups?.["*"]?.outputVisibility : undefined)
+    ?? account.outputVisibility
+    ?? "normal";
+}
+
 function readReconnect(raw: unknown): Required<OpenclawClawlingReconnectConfig> {
   const s = raw && typeof raw === "object" ? (raw as Record<string, unknown>) : {};
   return {
@@ -406,6 +446,8 @@ export function resolveOpenclawClawlingAccount(
   const ownerUserId =
     readOptionalString(channel.ownerUserId) || readEnvString(env, CLAWCHAT_OWNER_USER_ID_ENV);
   const enabled = typeof channel.enabled === "boolean" ? channel.enabled : true;
+  const outputVisibility = readOutputVisibility(channel.outputVisibility);
+  const chats = readChats(channel.chats);
   const groupMode = readGroupMode(channel.groupMode);
   const groupCommandMode = readGroupCommandMode(channel.groupCommandMode);
   const groups = readGroups(channel.groups);
@@ -433,6 +475,8 @@ export function resolveOpenclawClawlingAccount(
     agentId,
     userId,
     ownerUserId,
+    outputVisibility,
+    chats,
     groupMode,
     groupCommandMode,
     groups,

package/src/reply-dispatcher.ts

@@ -13,7 +13,10 @@ import { resolveOutboundMediaUrls } from "openclaw/plugin-sdk/reply-payload";
 import type { ReplyPayload } from "openclaw/plugin-sdk/reply-runtime";
 import { createOpenclawClawlingApiClient } from "./api-client.ts";
 import type { ChatType } from "./client.ts";
-import type { ResolvedOpenclawClawlingAccount } from "./config.ts";
+import {
+  effectiveOutputVisibility,
+  type ResolvedOpenclawClawlingAccount,
+} from "./config.ts";
 import { uploadOutboundMedia, type ClawlingMediaFragment } from "./media-runtime.ts";
 import {
   sendOpenclawClawlingText,
@@ -65,7 +68,7 @@ type TypedReplyDispatcherResult = ReturnType<
 type ClawChatReplyOptions = TypedReplyDispatcherResult["replyOptions"] &
   {
     sourceReplyDeliveryMode: "automatic";
-    disableBlockStreaming: true;
+    disableBlockStreaming: boolean;
   };
 
 type RichAction = {
@@ -188,11 +191,9 @@ function resolvePayloadText(payload: ReplyPayload): string {
 /**
  * Reply dispatcher for clawchat-plugin-openclaw.
  *
- * The plugin intentionally forces complete-message delivery. It sets
- * `disableBlockStreaming: true` in reply options so OpenClaw does not split
- * deliver blocks for this channel. If the host still delivers non-final
- * blocks, the dispatcher buffers or ignores them and only emits materialized
- * `message.send` / `message.reply` frames for the final reply.
+ * ClawChat emits only materialized `message.send` / `message.reply` frames for
+ * the final reply. Non-final OpenClaw deliveries are ignored or buffered
+ * according to outputVisibility and are never sent as separate ClawChat frames.
  */
 export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOptions): {
   dispatcher: TypedReplyDispatcherResult["dispatcher"];
@@ -211,6 +212,7 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
     log,
   } = options;
   const isGroupTarget = target.chatType === "group";
+  const outputVisibility = effectiveOutputVisibility(account, target.chatId, target.chatType);
   const ownerDirectTarget = () => {
     const ownerUserId = account.ownerUserId?.trim();
     return ownerUserId ? { chatId: ownerUserId, chatType: "direct" as const } : null;
@@ -242,6 +244,8 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
   // ----- Reply state ------------------------------------------------------
 
   let reasoningText = "";
+  let bufferedOutputText = "";
+  const bufferedOutputUrls: string[] = [];
   let runDone = false;
   let typingActive = false;
   let terminalReplySuppressed = false;
@@ -327,6 +331,32 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
     recordOutbound("thinking", messageId, thinkingText);
     reasoningText = "";
   };
+  const resetBufferedOutput = () => {
+    bufferedOutputText = "";
+    bufferedOutputUrls.length = 0;
+  };
+  const appendBufferedText = (value: string) => {
+    const trimmed = value.trim();
+    if (!trimmed) return;
+    bufferedOutputText = bufferedOutputText ? `${bufferedOutputText}\n${trimmed}` : trimmed;
+  };
+  const appendBufferedUrls = (urls: string[]) => {
+    for (const url of urls) {
+      if (url && !bufferedOutputUrls.includes(url)) bufferedOutputUrls.push(url);
+    }
+  };
+  const mergeFinalText = (text: string): string => {
+    if (outputVisibility !== "full") return text;
+    return [bufferedOutputText.trim(), text.trim()].filter(Boolean).join("\n");
+  };
+  const mergeFinalUrls = (urls: string[]): string[] => {
+    if (outputVisibility === "minimal") return urls;
+    const merged = bufferedOutputUrls.slice();
+    for (const url of urls) {
+      if (url && !merged.includes(url)) merged.push(url);
+    }
+    return merged;
+  };
 
   const mintStaticMessageId = () =>
     `${account.userId}-msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
@@ -462,6 +492,7 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
     onReplyStart: async () => {
       emitTyping(true);
       reasoningText = "";
+      resetBufferedOutput();
       runDone = false;
     },
     deliver: async (payload: ReplyPayload, info?: { kind: "tool" | "block" | "final" }) => {
@@ -488,12 +519,29 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
       }
 
       if (payload.isReasoning) {
-        if (isGroupTarget || !account.forwardThinking) return;
-        reasoningText = text;
+        if (isGroupTarget || outputVisibility !== "full") return;
+        appendBufferedText(text);
+        const trimmed = text.trim();
+        if (trimmed) reasoningText = reasoningText ? `${reasoningText}\n${trimmed}` : trimmed;
         return;
       }
 
-      if (info?.kind === "tool") return;
+      if (info?.kind === "tool") {
+        if (!isGroupTarget && outputVisibility === "full") {
+          appendBufferedText(text);
+          appendBufferedUrls(urls);
+        }
+        return;
+      }
+
+      if (info?.kind === "block") {
+        if (!isGroupTarget && outputVisibility === "normal") appendBufferedUrls(urls);
+        if (!isGroupTarget && outputVisibility === "full") {
+          appendBufferedText(text);
+          appendBufferedUrls(urls);
+        }
+        return;
+      }
 
       if (info?.kind === "final") {
         if (isClawChatNoopResponseText(text) && !richFragment && urls.length === 0) {
@@ -517,9 +565,11 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
           });
           return;
         }
-        const mediaFragments = await uploadMediaUrls(urls);
+        const finalText = richFragment && account.richInteractions ? mergeFinalText("") : mergeFinalText(text);
+        const finalUrls = mergeFinalUrls(urls);
+        const mediaFragments = await uploadMediaUrls(finalUrls);
         const result = await sendStatic(
-          text,
+          finalText,
           mediaFragments,
           richFragment && account.richInteractions ? ([richFragment] as unknown as Fragment[]) : [],
           { recordMessage: true },
@@ -528,9 +578,7 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
         return;
       }
 
-      // kind === "block" or unknown: OpenClaw may still call this path while
-      // the model is producing output. ClawChat gets only the final materialized
-      // reply.
+      // Unknown delivery kind: keep ClawChat output tied to OpenClaw final.
     },
     onError: (error: unknown, info: { kind: string }) => {
       const errorText = normalizeReplyErrorText(error);
@@ -559,7 +607,7 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
     replyOptions: {
       ...base.replyOptions,
       sourceReplyDeliveryMode: "automatic",
-      disableBlockStreaming: true,
+      disableBlockStreaming: outputVisibility !== "full",
     },
     markDispatchIdle: base.markDispatchIdle,
   };