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

package/dist/src/api-client.js

@@ -398,6 +398,16 @@ export function createOpenclawClawlingApiClient(opts) {
             assertNonBlankId(conversationId, "leaveConversation: conversationId");
             return await call("POST", `/v1/conversations/${encodeURIComponent(conversationId)}/leave`);
         },
+        async addConversationMember(conversationId, userId) {
+            assertNonBlankId(conversationId, "addConversationMember: conversationId");
+            assertNonBlankId(userId, "addConversationMember: userId");
+            const cid = conversationId.trim();
+            const uid = userId.trim();
+            return await call("POST", `/v1/conversations/${encodeURIComponent(cid)}/members`, {
+                body: JSON.stringify({ user_id: uid }),
+                headers: { "content-type": "application/json" },
+            });
+        },
         async patchConversation(conversationId, patch) {
             assertNonBlankId(conversationId, "patchConversation: conversationId");
             const body = pickPatch(patch, ["title", "description"], "patchConversation");

package/dist/src/skill-update.js

@@ -38,9 +38,11 @@ import { fileURLToPath } from "node:url";
  * - All network IO goes through an injected `FetchLike`; tests never touch the
  *   real network.
  *
- * Cross-language contract / spec: see
- * `ops/agent-plugin/skill-dynamic-update-plan.md` (§2, §3 phase 4,
- * §4 #5, §6.4, §6.7, §7.2).
+ * Cross-language contract / spec: see `docs/clawchat-plugin-openclaw.md`
+ * §"Conversational skill hot-update" for this adapter's end of the flow,
+ * `docs/client-integration.md` for the `clawchat.skill.update.check` signal
+ * shape, and the install-cli repo's `skills/README.md` for the canonical skill
+ * source and `manifest.json` contract.
  */
 // ---------------------------------------------------------------------------
 // Constants — fixed contract (must match the install-cli `config.ts`).

package/dist/src/tools-schema.js

@@ -128,6 +128,16 @@ export const ClawchatLeaveGroupSchema = Type.Object({
         description: "Concrete ClawChat group conversation id to leave",
     }),
 });
+export const ClawchatAddGroupMemberSchema = Type.Object({
+    conversationId: Type.String({
+        minLength: 1,
+        description: "Concrete ClawChat group conversation id to add the user to",
+    }),
+    userId: Type.String({
+        minLength: 1,
+        description: "Concrete ClawChat user id (usr_...) to add to the group",
+    }),
+});
 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, getCurrentTerminalSendScope } 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, ClawchatGetMomentSchema, ClawchatGetUserProfileSchema, ClawchatLeaveGroupSchema, ClawchatAcceptFriendRequestSchema, ClawchatMemoryEditSchema, ClawchatMemoryReadSchema, ClawchatMemorySearchSchema, ClawchatMemoryWriteSchema, ClawchatMetadataSyncSchema, ClawchatMetadataUpdateSchema, ClawchatCreateMomentCommentSchema, ClawchatCreateMomentSchema, ClawchatDeleteMomentCommentSchema, ClawchatDeleteMomentSchema, ClawchatListAccountFriendsSchema, ClawchatListFriendRequestsSchema, ClawchatListMomentsSchema, ClawchatMentionMessageSchema, ClawchatReactMessageSchema, ClawchatReplyMomentCommentSchema, ClawchatRejectFriendRequestSchema, ClawchatRemoveFriendSchema, ClawchatSearchUsersSchema, ClawchatSendFriendRequestSchema, ClawchatToggleMomentReactionSchema, ClawchatUpdateAccountProfileSchema, ClawchatUploadAvatarImageSchema, ClawchatRegisterAppSchema, ClawchatListAppsSchema, ClawchatUnregisterAppSchema, ClawchatLivewareLoginSchema, } from "./tools-schema.js";
+import { ClawchatGetAccountProfileSchema, ClawchatGetConversationSchema, ClawchatGetMomentSchema, ClawchatGetUserProfileSchema, ClawchatLeaveGroupSchema, ClawchatAddGroupMemberSchema, ClawchatAcceptFriendRequestSchema, ClawchatMemoryEditSchema, ClawchatMemoryReadSchema, ClawchatMemorySearchSchema, ClawchatMemoryWriteSchema, ClawchatMetadataSyncSchema, ClawchatMetadataUpdateSchema, ClawchatCreateMomentCommentSchema, ClawchatCreateMomentSchema, ClawchatDeleteMomentCommentSchema, ClawchatDeleteMomentSchema, ClawchatListAccountFriendsSchema, ClawchatListFriendRequestsSchema, ClawchatListMomentsSchema, ClawchatMentionMessageSchema, ClawchatReactMessageSchema, 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;
@@ -808,6 +808,34 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             });
         },
     }, { name: "clawchat_leave_group" });
+    api.registerTool({
+        name: "clawchat_add_group_member",
+        label: "Add ClawChat Group Member",
+        description: toolDescription("Add a specified ClawChat user to a group conversation the agent is a member of. " +
+            "TRIGGER - invoke only when the user explicitly asks the agent to add, invite, or pull a specific person into a specific ClawChat group, and both a concrete conversationId and a concrete userId are available. " +
+            "Never guess a userId from a name or nickname — use ids from ClawChat Group Message Metadata, clawchat_list_account_friends, or clawchat_search_users. " +
+            "Groups only: direct conversations are rejected by the server. " +
+            "The target must already be the agent's ClawChat friend, and the agent needs the group-management permission granted by its owner; if the call fails for either reason, explain that to the user and do not retry."),
+        parameters: ClawchatAddGroupMemberSchema,
+        async execute(_callId, params) {
+            return await recordClawchatToolCall("clawchat_add_group_member", params, async () => {
+                const p = params;
+                const built = buildClient();
+                if (!built.ok)
+                    return built.error;
+                try {
+                    const data = await built.client.addConversationMember(p.conversationId, p.userId);
+                    return jsonResponse(data);
+                }
+                catch (err) {
+                    if (err instanceof ClawlingApiError) {
+                        return apiError(err);
+                    }
+                    return genericError(err);
+                }
+            });
+        },
+    }, { name: "clawchat_add_group_member" });
     api.registerTool({
         name: "clawchat_mention_message",
         label: "Send ClawChat Mention Message",

package/openclaw.plugin.json

@@ -47,6 +47,7 @@
       "clawchat_react_message",
       "clawchat_get_conversation",
       "clawchat_leave_group",
+      "clawchat_add_group_member",
       "clawchat_list_moments",
       "clawchat_get_moment",
       "clawchat_create_moment",

package/package.json

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

package/src/api-client.ts

@@ -135,6 +135,10 @@ export interface OpenclawClawlingApiClient {
   deleteMomentComment(params: { momentId: number; commentId: number }): Promise<{ ok: boolean }>;
   getConversation(conversationId: string): Promise<{ conversation: ConversationDetails }>;
   leaveConversation(conversationId: string): Promise<{ ok: boolean }>;
+  addConversationMember(
+    conversationId: string,
+    userId: string,
+  ): Promise<{ conversation: ConversationDetails }>;
   patchConversation(
     conversationId: string,
     patch: ConversationMetadataPatch,
@@ -643,6 +647,23 @@ export function createOpenclawClawlingApiClient(opts: ApiClientOptions): Opencla
         `/v1/conversations/${encodeURIComponent(conversationId)}/leave`,
       );
     },
+    async addConversationMember(
+      conversationId,
+      userId,
+    ): Promise<{ conversation: ConversationDetails }> {
+      assertNonBlankId(conversationId, "addConversationMember: conversationId");
+      assertNonBlankId(userId, "addConversationMember: userId");
+      const cid = conversationId.trim();
+      const uid = userId.trim();
+      return await call<{ conversation: ConversationDetails }>(
+        "POST",
+        `/v1/conversations/${encodeURIComponent(cid)}/members`,
+        {
+          body: JSON.stringify({ user_id: uid }),
+          headers: { "content-type": "application/json" },
+        },
+      );
+    },
     async patchConversation(
       conversationId: string,
       patch: ConversationMetadataPatch,

package/src/skill-update.ts

@@ -39,9 +39,11 @@ import { fileURLToPath } from "node:url";
  * - All network IO goes through an injected `FetchLike`; tests never touch the
  *   real network.
  *
- * Cross-language contract / spec: see
- * `ops/agent-plugin/skill-dynamic-update-plan.md` (§2, §3 phase 4,
- * §4 #5, §6.4, §6.7, §7.2).
+ * Cross-language contract / spec: see `docs/clawchat-plugin-openclaw.md`
+ * §"Conversational skill hot-update" for this adapter's end of the flow,
+ * `docs/client-integration.md` for the `clawchat.skill.update.check` signal
+ * shape, and the install-cli repo's `skills/README.md` for the canonical skill
+ * source and `manifest.json` contract.
  */
 
 // ---------------------------------------------------------------------------

package/src/tools-schema.ts

@@ -208,6 +208,18 @@ export const ClawchatLeaveGroupSchema = Type.Object({
 });
 export type ClawchatLeaveGroupParams = Static<typeof ClawchatLeaveGroupSchema>;
 
+export const ClawchatAddGroupMemberSchema = Type.Object({
+  conversationId: Type.String({
+    minLength: 1,
+    description: "Concrete ClawChat group conversation id to add the user to",
+  }),
+  userId: Type.String({
+    minLength: 1,
+    description: "Concrete ClawChat user id (usr_...) to add to the group",
+  }),
+});
+export type ClawchatAddGroupMemberParams = Static<typeof ClawchatAddGroupMemberSchema>;
+
 export const ClawchatMentionMessageSchema = Type.Object({
   chatId: Type.String({
     minLength: 1,

package/src/tools.ts

@@ -43,6 +43,7 @@ import {
   ClawchatGetMomentSchema,
   ClawchatGetUserProfileSchema,
   ClawchatLeaveGroupSchema,
+  ClawchatAddGroupMemberSchema,
   ClawchatAcceptFriendRequestSchema,
   ClawchatMemoryEditSchema,
   ClawchatMemoryReadSchema,
@@ -86,6 +87,7 @@ import {
   type ClawchatGetMomentParams,
   type ClawchatGetUserProfileParams,
   type ClawchatLeaveGroupParams,
+  type ClawchatAddGroupMemberParams,
   type ClawchatListFriendRequestsParams,
   type ClawchatListMomentsParams,
   type ClawchatMentionMessageParams,
@@ -1048,6 +1050,38 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_leave_group" },
   );
 
+  api.registerTool(
+    {
+      name: "clawchat_add_group_member",
+      label: "Add ClawChat Group Member",
+      description: toolDescription(
+        "Add a specified ClawChat user to a group conversation the agent is a member of. " +
+          "TRIGGER - invoke only when the user explicitly asks the agent to add, invite, or pull a specific person into a specific ClawChat group, and both a concrete conversationId and a concrete userId are available. " +
+          "Never guess a userId from a name or nickname — use ids from ClawChat Group Message Metadata, clawchat_list_account_friends, or clawchat_search_users. " +
+          "Groups only: direct conversations are rejected by the server. " +
+          "The target must already be the agent's ClawChat friend, and the agent needs the group-management permission granted by its owner; if the call fails for either reason, explain that to the user and do not retry.",
+      ),
+      parameters: ClawchatAddGroupMemberSchema,
+      async execute(_callId, params) {
+        return await recordClawchatToolCall("clawchat_add_group_member", params, async () => {
+          const p = params as ClawchatAddGroupMemberParams;
+          const built = buildClient();
+          if (!built.ok) return built.error;
+          try {
+            const data = await built.client.addConversationMember(p.conversationId, p.userId);
+            return jsonResponse(data);
+          } catch (err) {
+            if (err instanceof ClawlingApiError) {
+              return apiError(err);
+            }
+            return genericError(err);
+          }
+        });
+      },
+    },
+    { name: "clawchat_add_group_member" },
+  );
+
   api.registerTool(
     {
       name: "clawchat_mention_message",