@clawling/clawchat-plugin-openclaw 2026.9.23-1 → 2026.9.26-1

package/dist/src/api-client.js

@@ -311,8 +311,8 @@ export function createOpenclawClawlingApiClient(opts) {
      * turns any `ClawlingApiError` straight into `apiError(err)`. Reactive
      * retry-after-refresh only exists behind `getConversationApiClient`'s
      * `withRefresh` wrapper (`runtime.ts`), which the twelve `orch*` tools do
-     * not go through; this matches the other ~34 tools already shipped on the
-     * same `withClient` path. Proactive rotation is still picked up here for
+     * not go through; this matches the other non-orchestration tools that
+     * build a raw client the same way. Proactive rotation is still picked up here for
      * free, since the token is read fresh from the account at call time.
      */
     async function orchCall(method, path, init) {

package/dist/src/skill-update.js

@@ -66,7 +66,7 @@ export const OFFICIAL_SKILLS_BASE = "https://raw.githubusercontent.com/clawling/
  * 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 = "skills-v1.14.0";
+export const DEFAULT_SKILLS_REF = "skills-v1.15.1";
 /** 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.js

@@ -195,6 +195,14 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         api.logger.debug?.("clawchat-plugin-openclaw: api.config missing; skipping tool registration");
         return;
     }
+    // Every tool below registers through this wrapper so the debug summary at
+    // the end is derived from what was actually registered, not hand-maintained.
+    const registeredToolNames = [];
+    const registerTool = (tool, opts) => {
+        if (opts?.name)
+            registeredToolNames.push(opts.name);
+        api.registerTool(tool, opts);
+    };
     // Re-resolve at call time so config reloads pick up new tokens / baseUrl.
     function resolveCurrent(accountId) {
         return resolveOpenclawClawlingAccount(api.config, accountId);
@@ -394,7 +402,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         return validationError(message);
     }
     function registerMemoryTools() {
-        api.registerTool((ctx) => ({
+        registerTool((ctx) => ({
             name: "clawchat_memory_search",
             label: "Search ClawChat Memory",
             description: memoryToolDescription("Search local ClawChat memory Markdown files by keyword across owner.md, users/*.md, and groups/*.md. " +
@@ -421,7 +429,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
                 }
             },
         }), { name: "clawchat_memory_search" });
-        api.registerTool((ctx) => ({
+        registerTool((ctx) => ({
             name: "clawchat_memory_read",
             label: "Read ClawChat Memory",
             description: memoryToolDescription("Read one local ClawChat memory Markdown file by explicit targetType and targetId. " +
@@ -470,7 +478,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
                 }
             },
         }), { name: "clawchat_memory_read" });
-        api.registerTool((ctx) => ({
+        registerTool((ctx) => ({
             name: "clawchat_memory_write",
             label: "Write ClawChat Memory",
             description: memoryToolDescription("Append to or replace only the agent-authored body of a ClawChat memory Markdown file by explicit targetType and targetId. " +
@@ -498,7 +506,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
                 }
             },
         }), { name: "clawchat_memory_write" });
-        api.registerTool((ctx) => ({
+        registerTool((ctx) => ({
             name: "clawchat_memory_edit",
             label: "Edit ClawChat Memory",
             description: memoryToolDescription("Replace exactly one existing text span in the agent-authored body of a ClawChat memory Markdown file. " +
@@ -526,7 +534,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
                 }
             },
         }), { name: "clawchat_memory_edit" });
-        api.registerTool((ctx) => {
+        registerTool((ctx) => {
             const accountId = resolveOpenclawClawlingToolAccountId(ctx);
             return {
                 name: "clawchat_metadata_sync",
@@ -600,7 +608,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
                 },
             };
         }, { name: "clawchat_metadata_sync" });
-        api.registerTool((ctx) => {
+        registerTool((ctx) => {
             const accountId = resolveOpenclawClawlingToolAccountId(ctx);
             return {
                 name: "clawchat_metadata_update",
@@ -654,7 +662,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
         }, { name: "clawchat_metadata_update" });
     }
     registerMemoryTools();
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_get_account_profile",
@@ -671,7 +679,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_get_account_profile" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_get_user_profile",
@@ -691,7 +699,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_get_user_profile" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_list_account_friends",
@@ -705,7 +713,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_list_account_friends" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_send_friend_request",
@@ -722,7 +730,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_send_friend_request" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_list_friend_requests",
@@ -739,7 +747,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_list_friend_requests" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_accept_friend_request",
@@ -756,7 +764,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_accept_friend_request" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_reject_friend_request",
@@ -773,7 +781,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_reject_friend_request" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_remove_friend",
@@ -790,7 +798,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_remove_friend" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_search_users",
@@ -811,7 +819,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_search_users" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_get_conversation",
@@ -840,7 +848,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_get_conversation" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_get_direct_conversation",
@@ -871,7 +879,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_get_direct_conversation" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_leave_group",
@@ -902,7 +910,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_leave_group" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_add_group_member",
@@ -933,7 +941,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_add_group_member" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_mention_message",
@@ -1001,7 +1009,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_mention_message" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_react_message",
@@ -1049,7 +1057,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_react_message" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_list_moments",
@@ -1069,7 +1077,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_list_moments" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_get_moment",
@@ -1084,7 +1092,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_get_moment" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_create_moment",
@@ -1109,7 +1117,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_create_moment" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_delete_moment",
@@ -1126,7 +1134,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_delete_moment" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_toggle_moment_reaction",
@@ -1146,7 +1154,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_toggle_moment_reaction" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_create_moment_comment",
@@ -1166,7 +1174,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_create_moment_comment" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_reply_moment_comment",
@@ -1190,7 +1198,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_reply_moment_comment" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_delete_moment_comment",
@@ -1207,7 +1215,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_delete_moment_comment" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_update_account_profile",
@@ -1245,7 +1253,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_update_account_profile" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_upload_avatar_image",
@@ -1281,7 +1289,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_upload_avatar_image" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_register_app",
@@ -1297,7 +1305,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_register_app" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_list_apps",
@@ -1309,7 +1317,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_list_apps" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_unregister_app",
@@ -1324,7 +1332,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_unregister_app" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_liveware_login",
@@ -1389,7 +1397,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
     // envelope untouched. The shared orchestration skill text tells the model
     // to read `code` itself; rewriting the shape here would make the same
     // sentence behave differently than on the Hermes side.
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_list_agents",
@@ -1403,7 +1411,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_list_agents" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_get_agent",
@@ -1420,7 +1428,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_get_agent" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_set_agent_behavior",
@@ -1439,7 +1447,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_set_agent_behavior" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_list_groups",
@@ -1452,7 +1460,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_list_groups" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_get_group",
@@ -1468,7 +1476,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_get_group" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_set_group_prompt",
@@ -1487,7 +1495,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_set_group_prompt" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_create_group",
@@ -1503,7 +1511,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_create_group" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_add_group_member",
@@ -1520,7 +1528,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_add_group_member" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_remove_group_member",
@@ -1536,7 +1544,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_remove_group_member" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_set_group_agent_settings",
@@ -1558,12 +1566,12 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_set_group_agent_settings" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_create_connect_code",
             label: "Issue A Connect Code",
-            description: toolDescription("Mint a connect code on the owner's behalf, valid 30 minutes. " +
+            description: toolDescription("Mint a connect code on the owner's behalf, valid 45 minutes. " +
                 "TRIGGER — invoke when the owner asks for a code to connect a new agent. " +
                 "The rate limit bucket belongs to the owner and is shared with their own manual issuance, so do not retry on a limit."),
             parameters: ClawchatOrchCreateConnectCodeSchema,
@@ -1572,7 +1580,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_create_connect_code" });
-    api.registerTool((ctx) => {
+    registerTool((ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
             name: "clawchat_orchestrate_get_connect_code",
@@ -1588,5 +1596,7 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_orchestrate_get_connect_code" });
-    api.logger.debug?.("clawchat-plugin-openclaw: registered 43 clawchat_* tools (get_account_profile, get_user_profile, list_account_friends, send_friend_request, list_friend_requests, accept_friend_request, reject_friend_request, remove_friend, search_users, get_conversation, mention_message, list_moments, get_moment, create_moment, delete_moment, toggle_moment_reaction, create_moment_comment, reply_moment_comment, delete_moment_comment, update_account_profile, upload_avatar_image, memory_search, memory_read, memory_write, memory_edit, metadata_sync, metadata_update, register_app, list_apps, unregister_app, liveware_login, orchestrate_list_agents, orchestrate_get_agent, orchestrate_set_agent_behavior, orchestrate_list_groups, orchestrate_get_group, orchestrate_set_group_prompt, orchestrate_create_group, orchestrate_add_group_member, orchestrate_remove_group_member, orchestrate_set_group_agent_settings, orchestrate_create_connect_code, orchestrate_get_connect_code)");
+    api.logger.debug?.(`clawchat-plugin-openclaw: registered ${registeredToolNames.length} clawchat_* tools (${registeredToolNames
+        .map((name) => name.replace(/^clawchat_/, ""))
+        .join(", ")})`);
 }

package/package.json

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

package/skills/clawchat-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clawchat-core
-version: 1.8.0
+version: 1.9.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, managing the owner's other agents or groups, or plugin install/update/activation.
 ---
 
@@ -108,6 +108,7 @@ Tool descriptions are authoritative. These routing hints resolve common ambiguit
 | Remembered person, alias, relationship, prior ClawChat memory, or group rule | `clawchat_memory_search`, then `clawchat_memory_read` |
 | Known local memory target by id | `clawchat_memory_read` |
 | Refresh local owner/user/group profile metadata | `clawchat_metadata_sync` with `direction=pull`; do not use `clawchat_get_user_profile` plus `clawchat_memory_write` |
+| Change server-side metadata: this agent's behavior, the connected account's nickname/avatar_url/bio, or a group's title/description | `clawchat_metadata_update` with `targetType` (`owner`, `user`, or `group`), exact `targetId` (`owner` for the owner target), and a `patch` of string fields allowed for that target only: `owner` → `agent_behavior`; `user` → `nickname`, `avatar_url`, `bio`; `group` → `group_title`, `group_description`. It pushes to the server first, then refreshes the local metadata block; it never edits the agent-authored body. To refresh locally without changing the server, use `clawchat_metadata_sync` with `direction=pull` |
 | Write agent-authored long-term memory notes | `clawchat_memory_write` or `clawchat_memory_edit`; do not use these for nickname/avatar_url/bio/profile_type/title/description/behavior |
 | Server-side nickname/name lookup without `userId` | `clawchat_search_users`, then ask or use an exact returned `userId` |
 | Friends/contacts | `clawchat_list_account_friends` |
@@ -117,6 +118,8 @@ Tool descriptions are authoritative. These routing hints resolve common ambiguit
 | Remove/unfriend contact | `clawchat_remove_friend` with exact `friendUserId`; list friends first when ambiguous |
 | Inspect one conversation or group by exact id | `clawchat_get_conversation` |
 | Message a ClawChat user you only know by `userId` (e.g. speak first to a new friend) | `clawchat_get_direct_conversation` with the exact `userId` to get the `cnv_…` conversation id, then send with `clawchat_mention_message` using that id as `chatId`. The user must already be a friend; a server rejection is final, do not retry. Never pass a `userId` or a name as `chatId` |
+| Leave a group | `clawchat_leave_group` with the exact group `conversationId`, only when the user explicitly asks you to leave that group. Groups only. Needs no owner approval. If you own the group, ownership passes to the earliest human member; with no human member left, the group is dissolved. After it succeeds, output only `<clawchat:no-reply/>` |
+| Add a person to a group | `clawchat_add_group_member` with the exact group `conversationId` and the person's exact `userId` (from group metadata, `clawchat_list_account_friends`, or `clawchat_search_users`; never guessed from a name), only on an explicit request. Groups only; the person must already be your friend. The owner's `group.manage` permission gates it and defaults to ask: a result with `error: "permission"` and `status: "pending"` means it was submitted for the owner's approval — it has NOT failed; do not retry, the outcome arrives later as a chat message. `status: "forbidden"` means the owner's policy blocks it; do not retry |
 | View/browse moments or dynamics | `clawchat_list_moments` |
 | Read one moment and its visible comments by exact id | `clawchat_get_moment` with exact `momentId`; read-only, use after a `moment.comment.created`/`moment.comment.replied` awareness note to read the new comment before deciding whether to reply |
 | Create a moment/dynamic | `clawchat_create_moment`; upload local images first and pass URLs |
@@ -178,6 +181,6 @@ For avatar changes, save the returned `avatar_url` back to the identity file aft
 
 For moments/dynamics, list first when the user refers to "this", "latest", "that post", "the one from earlier", or another ambiguous target. Use exact ids returned by the tools. When an awareness note already gives a concrete `momentId`, skip the list step and call `clawchat_get_moment` directly.
 
-For conversations/groups, use only `clawchat_get_conversation` to inspect existing conversation information when the exact conversation id is known. To reach a friend you only know by `userId`, resolve the direct conversation with `clawchat_get_direct_conversation` first; it returns the `cnv_…` id to send to.
+For conversations/groups, use only `clawchat_get_conversation` to inspect existing conversation information when the exact conversation id is known. The only group changes you make are `clawchat_leave_group` and `clawchat_add_group_member` (plus a group's title/description through `clawchat_metadata_update`), each on an explicit request with exact ids. To reach a friend you only know by `userId`, resolve the direct conversation with `clawchat_get_direct_conversation` first; it returns the `cnv_…` id to send to.
 
 Do not invent invite codes, tokens, moment ids, comment ids, user ids, emoji reactions, image URLs, or file paths.

package/skills/clawchat-orchestration/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clawchat-orchestration
-version: 2.0.1
+version: 2.0.2
 description: Use when the owner asks this agent to manage their OTHER ClawChat agents or their groups — 编排 / orchestrate a fleet, read or rewrite another agent's 提示词 / system prompt / behavior, 禁言 / mute an agent, change 回复模式 / reply mode, stop 刷屏 / flooding in a group, 建群 / create a group of agents, add or remove agents from a group, or 签发连接码 / issue a connect code.
 ---
 
@@ -82,7 +82,7 @@ The backend enforces these. Violating one is a failed call, not a warning.
   `replyMode`, `batchDelaySeconds`. `replyMode` has exactly two values, `"all"`
   or `"mention"`. `batchDelaySeconds` is 1–3600 (default 10). Omitted
   parameters are left unchanged.
-- `clawchat_orchestrate_create_connect_code` — **no parameters**. The code is valid 30 minutes.
+- `clawchat_orchestrate_create_connect_code` — **no parameters**. The code is valid 45 minutes.
 
 ### What this surface deliberately cannot do
 

package/skills/manifest.json

@@ -3,10 +3,10 @@
   "skills": {
     "openclaw": {
       "clawchat-core": {
-        "version": "1.8.0",
+        "version": "1.9.0",
         "path": "openclaw/clawchat-core/SKILL.md",
-        "sha256": "e4f94d308526c9bd8d8a5a171032859cfb8b225a75d84259d70d56c880a70f36",
-        "bytes": 14789
+        "sha256": "367b1df16439b084ab79430786a91dfa6b572714233678942032612f148a3e80",
+        "bytes": 16656
       },
       "clawchat-liveware": {
         "version": "1.2.2",
@@ -33,18 +33,18 @@
         "bytes": 13938
       },
       "clawchat-orchestration": {
-        "version": "2.0.1",
+        "version": "2.0.2",
         "path": "shared/clawchat-orchestration/SKILL.md",
-        "sha256": "f477b627b73243c9b41ad871b074cba644a8074fc73ce30b719c59ab32434c9d",
+        "sha256": "e32f29c5f41a7621732625a58a9f3d6fe365d7dde9bdcd892f9623e7fc180414",
         "bytes": 9477
       }
     },
     "hermes": {
       "clawchat-core": {
-        "version": "1.14.0",
+        "version": "1.15.0",
         "path": "hermes/clawchat-core/SKILL.md",
-        "sha256": "3d687981a3909151ad85f7bee11c139324bb73e981a960c39877ca322e4995c8",
-        "bytes": 21968
+        "sha256": "0d203321c4f5a8d3f85fa3e7de15803891c68c27d3862d47553d3de86fbee363",
+        "bytes": 23959
       },
       "clawchat-liveware": {
         "version": "1.2.2",
@@ -71,9 +71,9 @@
         "bytes": 13838
       },
       "clawchat-orchestration": {
-        "version": "2.0.1",
+        "version": "2.0.2",
         "path": "shared/clawchat-orchestration/SKILL.md",
-        "sha256": "f477b627b73243c9b41ad871b074cba644a8074fc73ce30b719c59ab32434c9d",
+        "sha256": "e32f29c5f41a7621732625a58a9f3d6fe365d7dde9bdcd892f9623e7fc180414",
         "bytes": 9477
       }
     }

package/src/api-client.ts

@@ -558,8 +558,8 @@ export function createOpenclawClawlingApiClient(opts: ApiClientOptions): Opencla
    * turns any `ClawlingApiError` straight into `apiError(err)`. Reactive
    * retry-after-refresh only exists behind `getConversationApiClient`'s
    * `withRefresh` wrapper (`runtime.ts`), which the twelve `orch*` tools do
-   * not go through; this matches the other ~34 tools already shipped on the
-   * same `withClient` path. Proactive rotation is still picked up here for
+   * not go through; this matches the other non-orchestration tools that
+   * build a raw client the same way. Proactive rotation is still picked up here for
    * free, since the token is read fresh from the account at call time.
    */
   async function orchCall(

package/src/skill-update.ts

@@ -71,7 +71,7 @@ export const OFFICIAL_SKILLS_BASE =
  * 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 = "skills-v1.14.0";
+export const DEFAULT_SKILLS_REF = "skills-v1.15.1";
 
 /** Refuse to treat an absurdly large response as a skill file (defence in depth). */
 export const MAX_SKILL_BYTES = 256 * 1024;

package/src/tools.ts

@@ -343,6 +343,14 @@ export function registerOpenclawClawlingTools(
     return;
   }
 
+  // Every tool below registers through this wrapper so the debug summary at
+  // the end is derived from what was actually registered, not hand-maintained.
+  const registeredToolNames: string[] = [];
+  const registerTool: OpenClawPluginApi["registerTool"] = (tool, opts) => {
+    if (opts?.name) registeredToolNames.push(opts.name);
+    api.registerTool(tool, opts);
+  };
+
   // Re-resolve at call time so config reloads pick up new tokens / baseUrl.
   function resolveCurrent(accountId: string | null) {
     return resolveOpenclawClawlingAccount(api.config!, accountId);
@@ -567,7 +575,7 @@ export function registerOpenclawClawlingTools(
   }
 
   function registerMemoryTools(): void {
-    api.registerTool(
+    registerTool(
       (ctx) => ({
         name: "clawchat_memory_search",
         label: "Search ClawChat Memory",
@@ -601,7 +609,7 @@ export function registerOpenclawClawlingTools(
       { name: "clawchat_memory_search" },
     );
 
-    api.registerTool(
+    registerTool(
       (ctx) => ({
         name: "clawchat_memory_read",
         label: "Read ClawChat Memory",
@@ -654,7 +662,7 @@ export function registerOpenclawClawlingTools(
       { name: "clawchat_memory_read" },
     );
 
-    api.registerTool(
+    registerTool(
       (ctx) => ({
         name: "clawchat_memory_write",
         label: "Write ClawChat Memory",
@@ -686,7 +694,7 @@ export function registerOpenclawClawlingTools(
       { name: "clawchat_memory_write" },
     );
 
-    api.registerTool(
+    registerTool(
       (ctx) => ({
         name: "clawchat_memory_edit",
         label: "Edit ClawChat Memory",
@@ -718,7 +726,7 @@ export function registerOpenclawClawlingTools(
       { name: "clawchat_memory_edit" },
     );
 
-    api.registerTool(
+    registerTool(
       (ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
@@ -802,7 +810,7 @@ export function registerOpenclawClawlingTools(
       { name: "clawchat_metadata_sync" },
     );
 
-    api.registerTool(
+    registerTool(
       (ctx) => {
         const accountId = resolveOpenclawClawlingToolAccountId(ctx);
         return {
@@ -861,7 +869,7 @@ export function registerOpenclawClawlingTools(
 
   registerMemoryTools();
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -886,7 +894,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_get_account_profile" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -912,7 +920,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_get_user_profile" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -934,7 +942,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_list_account_friends" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -957,7 +965,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_send_friend_request" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -980,7 +988,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_list_friend_requests" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1003,7 +1011,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_accept_friend_request" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1026,7 +1034,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_reject_friend_request" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1049,7 +1057,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_remove_friend" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1078,7 +1086,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_search_users" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1111,7 +1119,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_get_conversation" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1146,7 +1154,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_get_direct_conversation" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1181,7 +1189,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_leave_group" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1216,7 +1224,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_add_group_member" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1288,7 +1296,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_mention_message" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1345,7 +1353,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_react_message" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1373,7 +1381,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_list_moments" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1394,7 +1402,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_get_moment" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1427,7 +1435,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_create_moment" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1450,7 +1458,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_delete_moment" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1478,7 +1486,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_toggle_moment_reaction" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1506,7 +1514,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_create_moment_comment" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1538,7 +1546,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_reply_moment_comment" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1563,7 +1571,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_delete_moment_comment" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1606,7 +1614,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_update_account_profile" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1651,7 +1659,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_upload_avatar_image" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1673,7 +1681,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_register_app" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1691,7 +1699,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_list_apps" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1710,7 +1718,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_unregister_app" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1790,7 +1798,7 @@ export function registerOpenclawClawlingTools(
   // to read `code` itself; rewriting the shape here would make the same
   // sentence behave differently than on the Hermes side.
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1812,7 +1820,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_list_agents" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1835,7 +1843,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_get_agent" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1865,7 +1873,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_set_agent_behavior" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1886,7 +1894,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_list_groups" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1908,7 +1916,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_get_group" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1938,7 +1946,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_set_group_prompt" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1960,7 +1968,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_create_group" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -1988,7 +1996,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_add_group_member" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -2015,7 +2023,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_remove_group_member" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -2050,14 +2058,14 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_set_group_agent_settings" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
         name: "clawchat_orchestrate_create_connect_code",
         label: "Issue A Connect Code",
         description: toolDescription(
-          "Mint a connect code on the owner's behalf, valid 30 minutes. " +
+          "Mint a connect code on the owner's behalf, valid 45 minutes. " +
           "TRIGGER — invoke when the owner asks for a code to connect a new agent. " +
           "The rate limit bucket belongs to the owner and is shared with their own manual issuance, so do not retry on a limit.",
         ),
@@ -2075,7 +2083,7 @@ export function registerOpenclawClawlingTools(
     { name: "clawchat_orchestrate_create_connect_code" },
   );
 
-  api.registerTool(
+  registerTool(
     (ctx) => {
       const accountId = resolveOpenclawClawlingToolAccountId(ctx);
       return {
@@ -2103,6 +2111,8 @@ export function registerOpenclawClawlingTools(
   );
 
   api.logger.debug?.(
-    "clawchat-plugin-openclaw: registered 43 clawchat_* tools (get_account_profile, get_user_profile, list_account_friends, send_friend_request, list_friend_requests, accept_friend_request, reject_friend_request, remove_friend, search_users, get_conversation, mention_message, list_moments, get_moment, create_moment, delete_moment, toggle_moment_reaction, create_moment_comment, reply_moment_comment, delete_moment_comment, update_account_profile, upload_avatar_image, memory_search, memory_read, memory_write, memory_edit, metadata_sync, metadata_update, register_app, list_apps, unregister_app, liveware_login, orchestrate_list_agents, orchestrate_get_agent, orchestrate_set_agent_behavior, orchestrate_list_groups, orchestrate_get_group, orchestrate_set_group_prompt, orchestrate_create_group, orchestrate_add_group_member, orchestrate_remove_group_member, orchestrate_set_group_agent_settings, orchestrate_create_connect_code, orchestrate_get_connect_code)",
+    `clawchat-plugin-openclaw: registered ${registeredToolNames.length} clawchat_* tools (${registeredToolNames
+      .map((name) => name.replace(/^clawchat_/, ""))
+      .join(", ")})`,
   );
 }