@clawling/clawchat-plugin-openclaw 2026.7.20-1 → 2026.7.23-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/liveware-cli.js

@@ -10,12 +10,22 @@ export function livewareDir(stateDir) {
     const root = stateDir ?? resolveStateDir();
     return path.join(root, "clawchat", "liveware");
 }
+/** Local filename for the downloaded binary; Windows needs a .exe suffix. */
+export function livewareBinaryName(plat = process.platform) {
+    return plat === "win32" ? "liveware.exe" : "liveware";
+}
 /** Map host platform/arch to the liveware asset filename, or null if unsupported. */
 export function platformAssets(plat = process.platform, arch = process.arch) {
-    const os = plat === "darwin" ? "darwin" : plat === "linux" ? "linux" : null;
+    const os = plat === "darwin" ? "darwin" : plat === "linux" ? "linux" : plat === "win32" ? "windows" : null;
     const cpu = arch === "x64" ? "amd64" : arch === "arm64" ? "arm64" : null;
     if (!os || !cpu)
         return null;
+    // Windows only ships an amd64 build, published with a .exe suffix.
+    if (os === "windows") {
+        if (cpu !== "amd64")
+            return null;
+        return { liveware: "liveware-windows-amd64.exe" };
+    }
     return { liveware: `liveware-${os}-${cpu}` };
 }
 function findOnPath(name) {
@@ -41,9 +51,10 @@ function findOnPath(name) {
  *  3. otherwise      → null
  */
 export function resolveLivewarePath(stateDir) {
-    if (findOnPath("liveware"))
-        return "liveware";
-    const local = path.join(livewareDir(stateDir), "liveware");
+    const name = livewareBinaryName();
+    if (findOnPath(name))
+        return name;
+    const local = path.join(livewareDir(stateDir), name);
     try {
         fs.accessSync(local, fs.constants.X_OK);
         return local;
@@ -71,10 +82,11 @@ async function downloadTo(url, dest) {
 export async function ensureLivewareCli(opts = {}) {
     const { stateDir, log } = opts;
     try {
-        if (findOnPath("liveware"))
+        const name = livewareBinaryName();
+        if (findOnPath(name))
             return; // PATH wins
         const dir = livewareDir(stateDir);
-        const target = path.join(dir, "liveware");
+        const target = path.join(dir, name);
         if (fs.existsSync(target))
             return;
         const assets = platformAssets();
@@ -83,7 +95,7 @@ export async function ensureLivewareCli(opts = {}) {
             return;
         }
         await fs.promises.mkdir(dir, { recursive: true });
-        await downloadTo(LIVEWARE_BASE_URL + assets.liveware, path.join(dir, "liveware"));
+        await downloadTo(LIVEWARE_BASE_URL + assets.liveware, path.join(dir, name));
         log?.debug?.(`clawchat-plugin-openclaw: liveware CLI downloaded to ${dir}`);
     }
     catch (err) {

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

package/skills/clawchat-core/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: clawchat-core
-version: 1.0.0
-description: Use when a request involves ClawChat profile, friends, user search, moments/dynamics, comments, reactions, avatar, media, memory, output visibility, read-only conversation lookup, or plugin install/update/activation.
+version: 1.1.0
+description: Use when a request involves ClawChat profile, friends, user search, moments/dynamics, comments, reactions, avatar, media, memory, output visibility, read-only conversation lookup, sending an image, file, or voice/audio clip into a conversation, or plugin install/update/activation.
 ---
 
 # ClawChat
@@ -16,6 +16,16 @@ This skill guides agent behavior for ClawChat-aware tasks. Use the registered Cl
 - If a requested ClawChat tool is unavailable or returns a config error, report that result and stop instead of bypassing the plugin.
 - Use the `/clawchat-output` slash command when the user asks to change how much ClawChat runtime output is shown in the current conversation.
 
+## Sending an Image, File, or Voice Message
+
+To deliver an image, file, or voice/audio clip into the current ClawChat conversation, use the OpenClaw **message tool** with `action='send'` and `media` set to a local file path or an HTTPS URL. This is a host message-tool capability, not a `clawchat_*` tool — the `clawchat_upload_avatar_image` / moment-image tools are a separate avatar/moments surface and do not post into a conversation.
+
+- ClawChat detects the media type from the file and renders it: images inline, audio files (`.mp3`, `.m4a`, `.wav`, `.ogg`, `.aac`, …) as **playable voice messages**, everything else as a downloadable file. There is no separate voice tool or `voice` kind — a voice message is just audio media, so sending a genuine audio file is how you "send a voice message".
+- Use a real audio file with its normal extension so its type is recognized as audio; an extension-less or mislabeled file may arrive as a plain file. The clip length is shown on the recipient side automatically — you do not set a duration.
+- Send several assets by passing multiple URLs; any accompanying reply text becomes the caption. For web images, pass a suitable HTTPS URL directly as `media` — do not download it first.
+- Omit `target` to reply to the current chat. For another chat use `target="cc:{chat_id}"` (direct) or `target="cc:group:{chat_id}"` (group).
+- Do not paste a file's contents into the message or claim you cannot send attachments as a substitute; attach it this way and report any delivery failure.
+
 ## OpenClaw CLI
 
 Use CLI commands only for installing, updating, activating, or refreshing the OpenClaw ClawChat plugin. Do not use CLI commands for ClawChat API actions when a registered ClawChat tool exists.

package/skills/clawchat-liveware/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clawchat-liveware
-version: 1.0.0
+version: 1.1.0
 description: Use when the user wants to expose this agent's local web service to the public internet via the liveware CLI and make it appear as an app in their ClawChat chat with this agent. Covers logging in to liveware with the ClawChat account, creating a liveware app, binding a tunnel to a local port, and registering the public URL to ClawChat.
 ---
 
@@ -55,9 +55,30 @@ ClawChat so it shows as an app tile in the owner's chat with this agent.
 - To remove one: `clawchat_unregister_app(appId="<app id>")` (this only removes it from
   ClawChat; tear down the liveware tunnel/app with liveware's own commands separately).
 
+## Identifying the viewing user (server-side)
+
+When a ClawChat user opens the liveware, the ClawChat liveware tunnel authenticates the
+request and forwards the viewer's ClawChat `user_id` to your web service as a request header.
+On the **server side** of your web service, read the `user_id` from either header (both carry
+the same value):
+
+- `X-User-Id`
+- `X-Clawchat-User-Id`
+
+Caveats:
+
+- This is **server-side only** — read the incoming request headers in your web service. Do
+  NOT try to obtain the viewer's identity from client-side page JavaScript.
+- The headers are injected by the ClawChat liveware tunnel, so they are present only for
+  requests that arrive through it. A page opened directly in an ordinary browser (outside
+  ClawChat) carries neither header — treat the user as anonymous when both are absent, and
+  never trust a client-supplied value for these header names.
+
 ## Notes
 
 - Apps can be created up to liveware's account limit; surface its error rather than working
   around it.
-- The registered web app opens in a sandboxed in-app browser on mobile with no ClawChat
-  login injected — do not assume the page can read the user's ClawChat identity.
+- The registered web app runs inside a sandboxed container (mobile in-app webview / desktop
+  container window). Page JavaScript cannot read the viewer's ClawChat identity — the
+  viewer's `user_id` arrives as the `X-User-Id` / `X-Clawchat-User-Id` request header,
+  readable server-side only (see "Identifying the viewing user").

package/skills/manifest.json

@@ -3,16 +3,16 @@
   "skills": {
     "openclaw": {
       "clawchat-core": {
-        "version": "1.0.0",
+        "version": "1.1.0",
         "path": "openclaw/clawchat-core/SKILL.md",
-        "sha256": "9b911a33640a6ba79f6323755a8541a366fddb9a74282d3d21512e0defda3fbc",
-        "bytes": 7307
+        "sha256": "f5a25e584ddf62c2a6880a85a7bd93765d05809f7612791b73600ca830445116",
+        "bytes": 8909
       },
       "clawchat-liveware": {
-        "version": "1.0.0",
+        "version": "1.1.0",
         "path": "shared/clawchat-liveware/SKILL.md",
-        "sha256": "d88ae5520590b46d1827b261bcc37d3621e252f419cc4f28e7f47ae79b237780",
-        "bytes": 3579
+        "sha256": "c59a8156f8283f9f2a71231813322ce2162a50c5f0c9ad3d828be43eb9ae967a",
+        "bytes": 4634
       },
       "clawchat-set-greeting": {
         "version": "1.0.0",
@@ -29,16 +29,16 @@
     },
     "hermes": {
       "clawchat-core": {
-        "version": "1.0.0",
+        "version": "1.2.0",
         "path": "hermes/clawchat-core/SKILL.md",
-        "sha256": "9c286e63f52f0d2436b95a13cda12b154e180f7127cd70b31cc3d1c56b331649",
-        "bytes": 8671
+        "sha256": "4a73379ff38f089b3120160f09a7eb1b7c617ec0bd23b9c905fb4b2184d6e239",
+        "bytes": 11106
       },
       "clawchat-liveware": {
-        "version": "1.0.0",
+        "version": "1.1.0",
         "path": "shared/clawchat-liveware/SKILL.md",
-        "sha256": "d88ae5520590b46d1827b261bcc37d3621e252f419cc4f28e7f47ae79b237780",
-        "bytes": 3579
+        "sha256": "c59a8156f8283f9f2a71231813322ce2162a50c5f0c9ad3d828be43eb9ae967a",
+        "bytes": 4634
       },
       "clawchat-set-greeting": {
         "version": "1.0.0",

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/liveware-cli.ts

@@ -20,14 +20,25 @@ export function livewareDir(stateDir?: string): string {
   return path.join(root, "clawchat", "liveware");
 }
 
+/** Local filename for the downloaded binary; Windows needs a .exe suffix. */
+export function livewareBinaryName(plat: string = process.platform): string {
+  return plat === "win32" ? "liveware.exe" : "liveware";
+}
+
 /** Map host platform/arch to the liveware asset filename, or null if unsupported. */
 export function platformAssets(
   plat: string = process.platform,
   arch: string = process.arch,
 ): { liveware: string } | null {
-  const os = plat === "darwin" ? "darwin" : plat === "linux" ? "linux" : null;
+  const os =
+    plat === "darwin" ? "darwin" : plat === "linux" ? "linux" : plat === "win32" ? "windows" : null;
   const cpu = arch === "x64" ? "amd64" : arch === "arm64" ? "arm64" : null;
   if (!os || !cpu) return null;
+  // Windows only ships an amd64 build, published with a .exe suffix.
+  if (os === "windows") {
+    if (cpu !== "amd64") return null;
+    return { liveware: "liveware-windows-amd64.exe" };
+  }
   return { liveware: `liveware-${os}-${cpu}` };
 }
 
@@ -53,8 +64,9 @@ function findOnPath(name: string): string | null {
  *  3. otherwise      → null
  */
 export function resolveLivewarePath(stateDir?: string): string | null {
-  if (findOnPath("liveware")) return "liveware";
-  const local = path.join(livewareDir(stateDir), "liveware");
+  const name = livewareBinaryName();
+  if (findOnPath(name)) return name;
+  const local = path.join(livewareDir(stateDir), name);
   try {
     fs.accessSync(local, fs.constants.X_OK);
     return local;
@@ -83,9 +95,10 @@ export async function ensureLivewareCli(
 ): Promise<void> {
   const { stateDir, log } = opts;
   try {
-    if (findOnPath("liveware")) return; // PATH wins
+    const name = livewareBinaryName();
+    if (findOnPath(name)) return; // PATH wins
     const dir = livewareDir(stateDir);
-    const target = path.join(dir, "liveware");
+    const target = path.join(dir, name);
     if (fs.existsSync(target)) return;
 
     const assets = platformAssets();
@@ -97,7 +110,7 @@ export async function ensureLivewareCli(
     }
 
     await fs.promises.mkdir(dir, { recursive: true });
-    await downloadTo(LIVEWARE_BASE_URL + assets.liveware, path.join(dir, "liveware"));
+    await downloadTo(LIVEWARE_BASE_URL + assets.liveware, path.join(dir, name));
     log?.debug?.(`clawchat-plugin-openclaw: liveware CLI downloaded to ${dir}`);
   } catch (err) {
     log?.warn?.(`clawchat-plugin-openclaw: liveware CLI download skipped: ${String(err)}`);

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