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

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/friend-request-turn.js

@@ -0,0 +1,83 @@
+/**
+ * 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,
+                },
+            },
+        },
+    };
+}

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`).
@@ -53,10 +55,18 @@ import { fileURLToPath } from "node:url";
  */
 export const OFFICIAL_SKILLS_BASE = "https://raw.githubusercontent.com/clawling/clawchat-plugin-install-cli";
 /**
- * Default git ref for the skills tree. Production callers SHOULD pin an
- * immutable `skills-vX.Y.Z` tag instead of tracking the moving `main`.
+ * Default git ref for the skills tree — an immutable `skills-vX.Y.Z` tag, not
+ * the moving `main`. Nothing supplies a target version today (the trigger
+ * signal is content-free), so this constant is the ref every fetch uses: on
+ * `main` a released plugin would follow whatever landed in the skills tree
+ * since, and convergence compares raw bytes, so an in-progress edit is enough
+ * to prompt the owner for an "update".
+ *
+ * Moving the pin is a deliberate release: publish the new `skills-vX.Y.Z` tag
+ * in the install-cli repo, bump this constant, ship it. `liveware-sample.ts`
+ * imports the same ref, so the `livewares` tree at that tag is pinned too.
  */
-export const DEFAULT_SKILLS_REF = "main";
+export const DEFAULT_SKILLS_REF = "skills-v1.6.0";
 /** Refuse to treat an absurdly large response as a skill file (defence in depth). */
 export const MAX_SKILL_BYTES = 256 * 1024;
 /** This adapter's host target inside `skills/manifest.json`. */

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.5-1",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "author": "CLAWLING PTE. LTD.",

package/skills/manifest.json

@@ -29,10 +29,10 @@
     },
     "hermes": {
       "clawchat-core": {
-        "version": "1.4.1",
+        "version": "1.7.0",
         "path": "hermes/clawchat-core/SKILL.md",
-        "sha256": "33488a7a77a1bd950e2d791420370cac27cc9d8717042251d6df5f8b781dc904",
-        "bytes": 11992
+        "sha256": "ea5118a99ddad7c9ce9c1437a4e33fbd76f45572998bb1722a70f4aa5e0e76aa",
+        "bytes": 17557
       },
       "clawchat-liveware": {
         "version": "1.1.0",

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.
  */
 
 // ---------------------------------------------------------------------------
@@ -58,10 +60,18 @@ export const OFFICIAL_SKILLS_BASE =
   "https://raw.githubusercontent.com/clawling/clawchat-plugin-install-cli";
 
 /**
- * Default git ref for the skills tree. Production callers SHOULD pin an
- * immutable `skills-vX.Y.Z` tag instead of tracking the moving `main`.
+ * Default git ref for the skills tree — an immutable `skills-vX.Y.Z` tag, not
+ * the moving `main`. Nothing supplies a target version today (the trigger
+ * signal is content-free), so this constant is the ref every fetch uses: on
+ * `main` a released plugin would follow whatever landed in the skills tree
+ * since, and convergence compares raw bytes, so an in-progress edit is enough
+ * to prompt the owner for an "update".
+ *
+ * Moving the pin is a deliberate release: publish the new `skills-vX.Y.Z` tag
+ * in the install-cli repo, bump this constant, ship it. `liveware-sample.ts`
+ * imports the same ref, so the `livewares` tree at that tag is pinned too.
  */
-export const DEFAULT_SKILLS_REF = "main";
+export const DEFAULT_SKILLS_REF = "skills-v1.6.0";
 
 /** Refuse to treat an absurdly large response as a skill file (defence in depth). */
 export const MAX_SKILL_BYTES = 256 * 1024;

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",