@clawling/clawchat-plugin-openclaw 2026.6.30-1 → 2026.6.30-2

package/dist/src/runtime.js

@@ -279,12 +279,17 @@ function withClawChatSessionScope(cfg) {
     };
 }
 function buildActivationBootstrapText() {
+    // Worded to make the greeting the single required action. Earlier wording
+    // ("ClawChat activation bootstrap: ... do both ...") led some agents to treat
+    // it as a setup task and write a `BOOTSTRAP.md` file instead of replying, so
+    // no greeting reached the user. Lead with the chat reply, forbid file/tool
+    // detours, and keep the profile update strictly optional and secondary.
     return [
-        "ClawChat activation bootstrap: You are now connected to this ClawChat direct conversation.",
-        "Please do both:",
-        "1. Send a brief, friendly greeting to the user in this ClawChat direct conversation.",
-        "2. If you have local profile information for yourself, such as display name, bio, or avatar, update the connected ClawChat account profile using the available ClawChat tools. Use `clawchat_update_account_profile` for display name/bio/avatar URL, and use `clawchat_upload_avatar_image` first if the avatar is only available as a local image path. If you do not have local profile information, skip profile updates and only greet the user.",
-        "Do not ask the user for profile information just for this bootstrap.",
+        "You are now connected to a ClawChat direct conversation with your user.",
+        "Reply now with one short, friendly greeting message in this conversation: introduce yourself and say you are connected and ready.",
+        "Send it as a normal chat reply. Do not write or create any files or notes, and do not call tools just to greet.",
+        "Only if you already have your own profile details (display name, bio, or avatar) may you also call `clawchat_update_account_profile` (use `clawchat_upload_avatar_image` first for a local avatar image); otherwise skip that and just greet.",
+        "Do not ask the user for profile information.",
     ].join("\n");
 }
 function buildActivationBootstrapEnvelope(params) {
@@ -1440,6 +1445,11 @@ export async function startOpenclawClawlingGateway(params) {
         }));
     };
     let dispatchActivationBootstrap = async () => { };
+    // Set by dispatchTurnToAgent when it dispatches the synthetic
+    // `clawchat-bootstrap` turn: true only if the agent actually produced a final
+    // outbound message (the greeting). The bootstrap dispatcher reads it to decide
+    // whether to mark the bootstrap sent or leave it pending for a later retry.
+    let bootstrapProducedFinal = false;
     client.on("state", ({ from, to }) => {
         log?.info?.(`[${accountId}] clawchat-plugin-openclaw state ${from} -> ${to}`);
         wsReady = to === "connected";
@@ -2131,6 +2141,12 @@ export async function startOpenclawClawlingGateway(params) {
                 });
                 const counts = dispatchResult?.counts ?? {};
                 const queuedFinal = Boolean(dispatchResult?.queuedFinal);
+                if (turn.senderId === "clawchat-bootstrap") {
+                    // Did the agent actually emit a greeting? A final outbound message
+                    // means yes; block/tool-only (or nothing) means the greeting never
+                    // reached the user, so the bootstrap dispatcher will keep it pending.
+                    bootstrapProducedFinal = queuedFinal || (counts.final ?? 0) > 0;
+                }
                 log?.info?.(`[${accountId}] clawchat-plugin-openclaw dispatch complete msg=${turn.messageId} queuedFinal=${queuedFinal} counts=${JSON.stringify(counts)}`);
                 if (!queuedFinal && Object.values(counts).every((n) => !n)) {
                     log?.info?.(`[${accountId}] clawchat-plugin-openclaw NO reply was produced (no final / block / tool dispatched). ` +
@@ -2388,11 +2404,22 @@ export async function startOpenclawClawlingGateway(params) {
             if (!bootstrap)
                 return;
             const claimedBootstrap = bootstrap;
+            bootstrapProducedFinal = false;
             const result = await handleInboundEnvelope(buildActivationBootstrapEnvelope({ account, conversationId: claimedBootstrap.conversationId }));
             if (result !== "submitted") {
                 releaseBootstrap();
                 return;
             }
+            // Only mark the bootstrap done once the agent has actually sent a greeting
+            // (a final outbound message). If the turn was handed off but produced no
+            // final reply — e.g. the agent went off to write a file/note instead of
+            // replying — leave the bootstrap pending (release the claim) so the next
+            // ready re-dispatches it, rather than silently consuming it forever.
+            if (!bootstrapProducedFinal) {
+                log?.info?.(`[${accountId}] clawchat-plugin-openclaw activation bootstrap dispatched but produced no final reply; leaving pending for retry`);
+                releaseBootstrap();
+                return;
+            }
             recordConnection("activation bootstrap sent", () => store.markActivationBootstrapSent?.({
                 platform: "openclaw",
                 accountId,

package/package.json

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

package/src/runtime.ts

@@ -427,12 +427,17 @@ function withClawChatSessionScope(cfg: OpenClawConfig): OpenClawConfig {
 }
 
 function buildActivationBootstrapText(): string {
+  // Worded to make the greeting the single required action. Earlier wording
+  // ("ClawChat activation bootstrap: ... do both ...") led some agents to treat
+  // it as a setup task and write a `BOOTSTRAP.md` file instead of replying, so
+  // no greeting reached the user. Lead with the chat reply, forbid file/tool
+  // detours, and keep the profile update strictly optional and secondary.
   return [
-    "ClawChat activation bootstrap: You are now connected to this ClawChat direct conversation.",
-    "Please do both:",
-    "1. Send a brief, friendly greeting to the user in this ClawChat direct conversation.",
-    "2. If you have local profile information for yourself, such as display name, bio, or avatar, update the connected ClawChat account profile using the available ClawChat tools. Use `clawchat_update_account_profile` for display name/bio/avatar URL, and use `clawchat_upload_avatar_image` first if the avatar is only available as a local image path. If you do not have local profile information, skip profile updates and only greet the user.",
-    "Do not ask the user for profile information just for this bootstrap.",
+    "You are now connected to a ClawChat direct conversation with your user.",
+    "Reply now with one short, friendly greeting message in this conversation: introduce yourself and say you are connected and ready.",
+    "Send it as a normal chat reply. Do not write or create any files or notes, and do not call tools just to greet.",
+    "Only if you already have your own profile details (display name, bio, or avatar) may you also call `clawchat_update_account_profile` (use `clawchat_upload_avatar_image` first for a local avatar image); otherwise skip that and just greet.",
+    "Do not ask the user for profile information.",
   ].join("\n");
 }
 
@@ -1816,6 +1821,11 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
     );
   };
   let dispatchActivationBootstrap: () => Promise<void> = async () => {};
+  // Set by dispatchTurnToAgent when it dispatches the synthetic
+  // `clawchat-bootstrap` turn: true only if the agent actually produced a final
+  // outbound message (the greeting). The bootstrap dispatcher reads it to decide
+  // whether to mark the bootstrap sent or leave it pending for a later retry.
+  let bootstrapProducedFinal = false;
 
   client.on("state", ({ from, to }) => {
     log?.info?.(`[${accountId}] clawchat-plugin-openclaw state ${from} -> ${to}`);
@@ -2579,6 +2589,12 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
         const queuedFinal = Boolean(
           (dispatchResult as { queuedFinal?: boolean } | undefined)?.queuedFinal,
         );
+        if (turn.senderId === "clawchat-bootstrap") {
+          // Did the agent actually emit a greeting? A final outbound message
+          // means yes; block/tool-only (or nothing) means the greeting never
+          // reached the user, so the bootstrap dispatcher will keep it pending.
+          bootstrapProducedFinal = queuedFinal || (counts.final ?? 0) > 0;
+        }
         log?.info?.(
           `[${accountId}] clawchat-plugin-openclaw dispatch complete msg=${turn.messageId} queuedFinal=${queuedFinal} counts=${JSON.stringify(counts)}`,
         );
@@ -2877,6 +2893,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
       );
       if (!bootstrap) return;
       const claimedBootstrap = bootstrap;
+      bootstrapProducedFinal = false;
       const result = await handleInboundEnvelope(
         buildActivationBootstrapEnvelope({ account, conversationId: claimedBootstrap.conversationId }),
       );
@@ -2884,6 +2901,18 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
         releaseBootstrap();
         return;
       }
+      // Only mark the bootstrap done once the agent has actually sent a greeting
+      // (a final outbound message). If the turn was handed off but produced no
+      // final reply — e.g. the agent went off to write a file/note instead of
+      // replying — leave the bootstrap pending (release the claim) so the next
+      // ready re-dispatches it, rather than silently consuming it forever.
+      if (!bootstrapProducedFinal) {
+        log?.info?.(
+          `[${accountId}] clawchat-plugin-openclaw activation bootstrap dispatched but produced no final reply; leaving pending for retry`,
+        );
+        releaseBootstrap();
+        return;
+      }
       recordConnection("activation bootstrap sent", () =>
         store.markActivationBootstrapSent?.({
           platform: "openclaw",