@clawling/clawchat-plugin-openclaw 2026.7.15-1 → 2026.7.21-1

package/dist/src/api-client.js

@@ -391,6 +391,10 @@ export function createOpenclawClawlingApiClient(opts) {
         async getConversation(conversationId) {
             return await call("GET", `/v1/conversations/${encodeURIComponent(conversationId)}`);
         },
+        async leaveConversation(conversationId) {
+            assertNonBlankId(conversationId, "leaveConversation: conversationId");
+            return await call("POST", `/v1/conversations/${encodeURIComponent(conversationId)}/leave`);
+        },
         async patchConversation(conversationId, patch) {
             assertNonBlankId(conversationId, "patchConversation: conversationId");
             const body = pickPatch(patch, ["title", "description"], "patchConversation");

package/dist/src/reply-dispatcher.js

@@ -284,7 +284,15 @@ export function createOpenclawClawlingReplyDispatcher(options) {
             log?.info?.(`[${account.accountId}] clawchat-plugin-openclaw outbound media skipped: baseUrl not configured`);
             return [];
         }
-        return await uploadOutboundMedia(urls, { apiClient, runtime, log });
+        const fragments = await uploadOutboundMedia(urls, { apiClient, runtime, log });
+        if (fragments.length < urls.length) {
+            // uploadOutboundMedia drops a failed item with only a log line. A shortfall
+            // means an attachment never reached the media service; surfacing it (parity
+            // with the adapter path in outbound.ts and with the Hermes plugin) stops a
+            // text-only frame from going out and reading as a successful send.
+            throw new Error(`clawchat-plugin-openclaw failed to upload ${urls.length - fragments.length}/${urls.length} outbound media attachment(s); message not sent`);
+        }
+        return fragments;
     }
     // ----- Reply state ------------------------------------------------------
     let reasoningText = "";

package/dist/src/tools-schema.js

@@ -123,6 +123,11 @@ export const ClawchatGetConversationSchema = Type.Object({
         description: "Concrete ClawChat conversation id to fetch",
     }),
 });
+export const ClawchatLeaveGroupSchema = Type.Object({
+    conversationId: Type.String({
+        description: "Concrete ClawChat group conversation id to leave",
+    }),
+});
 export const ClawchatMentionMessageSchema = Type.Object({
     chatId: Type.String({
         minLength: 1,

package/dist/src/tools.js

@@ -12,7 +12,7 @@ import { getOpenclawClawlingClient, } from "./runtime.js";
 import { markTerminalClawChatSend } from "./terminal-send.js";
 import { editClawChatMemoryBody, readClawChatMemoryFile, resolveClawChatMemoryPath, searchClawChatMemory, writeClawChatMemoryBody, } from "./clawchat-memory.js";
 import { pullGroupMetadata, pullOwnerMetadata, pullUserMetadata, pushMetadata, updateMetadata, } from "./clawchat-metadata.js";
-import { ClawchatGetAccountProfileSchema, ClawchatGetConversationSchema, ClawchatGetUserProfileSchema, ClawchatAcceptFriendRequestSchema, ClawchatMemoryEditSchema, ClawchatMemoryReadSchema, ClawchatMemorySearchSchema, ClawchatMemoryWriteSchema, ClawchatMetadataSyncSchema, ClawchatMetadataUpdateSchema, ClawchatCreateMomentCommentSchema, ClawchatCreateMomentSchema, ClawchatDeleteMomentCommentSchema, ClawchatDeleteMomentSchema, ClawchatListAccountFriendsSchema, ClawchatListFriendRequestsSchema, ClawchatListMomentsSchema, ClawchatMentionMessageSchema, ClawchatReplyMomentCommentSchema, ClawchatRejectFriendRequestSchema, ClawchatRemoveFriendSchema, ClawchatSearchUsersSchema, ClawchatSendFriendRequestSchema, ClawchatToggleMomentReactionSchema, ClawchatUpdateAccountProfileSchema, ClawchatUploadAvatarImageSchema, ClawchatRegisterAppSchema, ClawchatListAppsSchema, ClawchatUnregisterAppSchema, ClawchatLivewareLoginSchema, } from "./tools-schema.js";
+import { ClawchatGetAccountProfileSchema, ClawchatGetConversationSchema, ClawchatGetUserProfileSchema, ClawchatLeaveGroupSchema, ClawchatAcceptFriendRequestSchema, ClawchatMemoryEditSchema, ClawchatMemoryReadSchema, ClawchatMemorySearchSchema, ClawchatMemoryWriteSchema, ClawchatMetadataSyncSchema, ClawchatMetadataUpdateSchema, ClawchatCreateMomentCommentSchema, ClawchatCreateMomentSchema, ClawchatDeleteMomentCommentSchema, ClawchatDeleteMomentSchema, ClawchatListAccountFriendsSchema, ClawchatListFriendRequestsSchema, ClawchatListMomentsSchema, ClawchatMentionMessageSchema, ClawchatReplyMomentCommentSchema, ClawchatRejectFriendRequestSchema, ClawchatRemoveFriendSchema, ClawchatSearchUsersSchema, ClawchatSendFriendRequestSchema, ClawchatToggleMomentReactionSchema, ClawchatUpdateAccountProfileSchema, ClawchatUploadAvatarImageSchema, ClawchatRegisterAppSchema, ClawchatListAppsSchema, ClawchatUnregisterAppSchema, ClawchatLivewareLoginSchema, } from "./tools-schema.js";
 const MAX_UPLOAD_BYTES = 20 * 1024 * 1024;
 // Owner-approval gate business codes (must match the ClawChat backend's owner-approval codes).
 const CODE_PENDING_APPROVAL = 21001;
@@ -780,6 +780,34 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             });
         },
     }, { name: "clawchat_get_conversation" });
+    api.registerTool({
+        name: "clawchat_leave_group",
+        label: "Leave ClawChat Group",
+        description: toolDescription("Leave a ClawChat group conversation the agent is currently a member of. " +
+            "TRIGGER - invoke only when the user explicitly asks the agent to leave, exit, or quit a specific ClawChat group and provides a concrete conversationId. " +
+            "Groups only: direct conversations are rejected by the server. " +
+            "If the agent is the group owner, leaving auto-transfers ownership to the earliest human member; if no human member remains, the group is dissolved. " +
+            "After this tool succeeds, output only <clawchat:no-reply/> and do not send a normal follow-up reply."),
+        parameters: ClawchatLeaveGroupSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_leave_group", params, async () => {
+                const p = params;
+                const built = buildClient();
+                if (!built.ok)
+                    return built.error;
+                try {
+                    const data = await built.client.leaveConversation(p.conversationId);
+                    return jsonResponse(data);
+                }
+                catch (err) {
+                    if (err instanceof ClawlingApiError) {
+                        return apiError(err);
+                    }
+                    return genericError(err);
+                }
+            });
+        },
+    }, { name: "clawchat_leave_group" });
     api.registerTool({
         name: "clawchat_mention_message",
         label: "Send ClawChat Mention Message",

package/openclaw.plugin.json

@@ -45,6 +45,7 @@
       "clawchat_search_users",
       "clawchat_mention_message",
       "clawchat_get_conversation",
+      "clawchat_leave_group",
       "clawchat_list_moments",
       "clawchat_create_moment",
       "clawchat_delete_moment",

package/package.json

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

package/src/api-client.ts

@@ -133,6 +133,7 @@ export interface OpenclawClawlingApiClient {
   }): Promise<{ comment: MomentComment }>;
   deleteMomentComment(params: { momentId: number; commentId: number }): Promise<{ ok: boolean }>;
   getConversation(conversationId: string): Promise<{ conversation: ConversationDetails }>;
+  leaveConversation(conversationId: string): Promise<{ ok: boolean }>;
   patchConversation(
     conversationId: string,
     patch: ConversationMetadataPatch,
@@ -631,6 +632,13 @@ export function createOpenclawClawlingApiClient(opts: ApiClientOptions): Opencla
         `/v1/conversations/${encodeURIComponent(conversationId)}`,
       );
     },
+    async leaveConversation(conversationId): Promise<{ ok: boolean }> {
+      assertNonBlankId(conversationId, "leaveConversation: conversationId");
+      return await call<{ ok: boolean }>(
+        "POST",
+        `/v1/conversations/${encodeURIComponent(conversationId)}/leave`,
+      );
+    },
     async patchConversation(
       conversationId: string,
       patch: ConversationMetadataPatch,

package/src/reply-dispatcher.ts

@@ -418,7 +418,17 @@ export function createOpenclawClawlingReplyDispatcher(options: ReplyDispatcherOp
       );
       return [];
     }
-    return await uploadOutboundMedia(urls, { apiClient, runtime, log });
+    const fragments = await uploadOutboundMedia(urls, { apiClient, runtime, log });
+    if (fragments.length < urls.length) {
+      // uploadOutboundMedia drops a failed item with only a log line. A shortfall
+      // means an attachment never reached the media service; surfacing it (parity
+      // with the adapter path in outbound.ts and with the Hermes plugin) stops a
+      // text-only frame from going out and reading as a successful send.
+      throw new Error(
+        `clawchat-plugin-openclaw failed to upload ${urls.length - fragments.length}/${urls.length} outbound media attachment(s); message not sent`,
+      );
+    }
+    return fragments;
   }
 
   // ----- Reply state ------------------------------------------------------

package/src/tools-schema.ts

@@ -201,6 +201,13 @@ export const ClawchatGetConversationSchema = Type.Object({
 });
 export type ClawchatGetConversationParams = Static<typeof ClawchatGetConversationSchema>;
 
+export const ClawchatLeaveGroupSchema = Type.Object({
+  conversationId: Type.String({
+    description: "Concrete ClawChat group conversation id to leave",
+  }),
+});
+export type ClawchatLeaveGroupParams = Static<typeof ClawchatLeaveGroupSchema>;
+
 export const ClawchatMentionMessageSchema = Type.Object({
   chatId: Type.String({
     minLength: 1,

package/src/tools.ts

@@ -41,6 +41,7 @@ import {
   ClawchatGetAccountProfileSchema,
   ClawchatGetConversationSchema,
   ClawchatGetUserProfileSchema,
+  ClawchatLeaveGroupSchema,
   ClawchatAcceptFriendRequestSchema,
   ClawchatMemoryEditSchema,
   ClawchatMemoryReadSchema,
@@ -81,6 +82,7 @@ import {
   type ClawchatAcceptFriendRequestParams,
   type ClawchatGetConversationParams,
   type ClawchatGetUserProfileParams,
+  type ClawchatLeaveGroupParams,
   type ClawchatListFriendRequestsParams,
   type ClawchatListMomentsParams,
   type ClawchatMentionMessageParams,
@@ -1010,6 +1012,38 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_get_conversation" },
   );
 
+  api.registerTool(
+    {
+      name: "clawchat_leave_group",
+      label: "Leave ClawChat Group",
+      description: toolDescription(
+        "Leave a ClawChat group conversation the agent is currently a member of. " +
+          "TRIGGER - invoke only when the user explicitly asks the agent to leave, exit, or quit a specific ClawChat group and provides a concrete conversationId. " +
+          "Groups only: direct conversations are rejected by the server. " +
+          "If the agent is the group owner, leaving auto-transfers ownership to the earliest human member; if no human member remains, the group is dissolved. " +
+          "After this tool succeeds, output only <clawchat:no-reply/> and do not send a normal follow-up reply.",
+      ),
+      parameters: ClawchatLeaveGroupSchema,
+      async execute(_callId, params) {
+        return await recordClawchatToolCall("clawchat_leave_group", params, async () => {
+          const p = params as ClawchatLeaveGroupParams;
+          const built = buildClient();
+          if (!built.ok) return built.error;
+          try {
+            const data = await built.client.leaveConversation(p.conversationId);
+            return jsonResponse(data);
+          } catch (err) {
+            if (err instanceof ClawlingApiError) {
+              return apiError(err);
+            }
+            return genericError(err);
+          }
+        });
+      },
+    },
+    { name: "clawchat_leave_group" },
+  );
+
   api.registerTool(
     {
       name: "clawchat_mention_message",