@clawling/clawchat-plugin-openclaw 2026.9.22-2 → 2026.9.23-2

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, ClawchatGetDirectConversationSchema, 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";
+import { ClawchatGetAccountProfileSchema, ClawchatGetConversationSchema, ClawchatGetDirectConversationSchema, 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, ClawchatOrchListAgentsSchema, ClawchatOrchGetAgentSchema, ClawchatOrchSetAgentBehaviorSchema, ClawchatOrchListGroupsSchema, ClawchatOrchGetGroupSchema, ClawchatOrchSetGroupPromptSchema, ClawchatOrchCreateGroupSchema, ClawchatOrchGroupMemberSchema, ClawchatOrchSetGroupAgentSettingsSchema, ClawchatOrchCreateConnectCodeSchema, ClawchatOrchGetConnectCodeSchema, } 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;
@@ -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",
@@ -1381,5 +1389,214 @@ export function registerOpenclawClawlingTools(api, options = {}) {
             },
         };
     }, { name: "clawchat_liveware_login" });
-    api.logger.debug?.("clawchat-plugin-openclaw: registered 31 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)");
+    // --- cloud orchestration (`agent.orchestrate`) ---------------------------
+    // Twelve tools, 1:1 with docs/features/agentorch.md. Every response is HTTP
+    // 200 with the business code in the envelope (a 21003 owner-approval
+    // denial is the single most common outcome), so these use plain
+    // `withClient` — never `withGatedClient` — and hand the caller the raw
+    // 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.
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_list_agents",
+            label: "List The Owner's Agents",
+            description: toolDescription("List every agent the owner owns, including this one (flagged is_self). " +
+                "TRIGGER — invoke first whenever the owner asks about, or asks to change, one of their OTHER agents. " +
+                "This is the only way to learn a sibling's agentId; never guess one from a nickname."),
+            parameters: ClawchatOrchListAgentsSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_list_agents", params, async () => withClient(accountId, (c) => c.orchListAgents()));
+            },
+        };
+    }, { name: "clawchat_orchestrate_list_agents" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_get_agent",
+            label: "Get A Sibling Agent",
+            description: toolDescription("Read one of the owner's agents by explicit agentId, including its read-only permission map. " +
+                "TRIGGER — invoke before rewriting a sibling's system prompt (the PATCH replaces the whole field, so read it first), " +
+                "or to explain why a sibling cannot do something instead of retrying on its behalf."),
+            parameters: ClawchatOrchGetAgentSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_get_agent", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchGetAgent(p.agentId));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_get_agent" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_set_agent_behavior",
+            label: "Rewrite A Sibling's System Prompt",
+            description: toolDescription("Replace the WHOLE system prompt (behavior) of one of the owner's other agents. " +
+                "TRIGGER — invoke when the owner asks to change how another agent behaves, talks, or what it is for. " +
+                "This REPLACES the entire field — call clawchat_orchestrate_get_agent first, edit the text you got back, and send the full new value. " +
+                "Sending a fragment deletes everything else and the owner cannot recover it. Max 3000 runes. " +
+                "Nickname and bio cannot be changed here."),
+            parameters: ClawchatOrchSetAgentBehaviorSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_set_agent_behavior", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchSetAgentBehavior(p.agentId, p.behavior));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_set_agent_behavior" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_list_groups",
+            label: "List Manageable Groups",
+            description: toolDescription("List the groups the owner can administer. " +
+                "TRIGGER — invoke when the owner talks about a group of their agents without naming a conversation id."),
+            parameters: ClawchatOrchListGroupsSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_list_groups", params, async () => withClient(accountId, (c) => c.orchListGroups()));
+            },
+        };
+    }, { name: "clawchat_orchestrate_list_groups" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_get_group",
+            label: "Get A Managed Group",
+            description: toolDescription("Read one group by explicit conversationId, including its system prompt and member agent ids. " +
+                "TRIGGER — invoke before rewriting a group prompt, and after any write, to report what the server now says."),
+            parameters: ClawchatOrchGetGroupSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_get_group", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchGetGroup(p.conversationId));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_get_group" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_set_group_prompt",
+            label: "Rewrite A Group's System Prompt",
+            description: toolDescription("Replace the WHOLE system prompt (description) of a group the owner administers. " +
+                "TRIGGER — invoke when the owner asks to change how a group behaves as a whole. " +
+                "This REPLACES the entire field — call clawchat_orchestrate_get_group first and send the full new value. " +
+                "Sending a fragment deletes everything else and the owner cannot recover it. Max 3000 runes. " +
+                "The group title cannot be changed here."),
+            parameters: ClawchatOrchSetGroupPromptSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_set_group_prompt", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchSetGroupPrompt(p.conversationId, p.description));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_set_group_prompt" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_create_group",
+            label: "Create A Group Of The Owner's Agents",
+            description: toolDescription("Create a new group containing the owner's own agents. " +
+                "TRIGGER — invoke when the owner asks to put several of their agents in a group together."),
+            parameters: ClawchatOrchCreateGroupSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_create_group", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchCreateGroup(p.title, p.agentIds));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_create_group" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_add_group_member",
+            label: "Add An Agent To A Group",
+            description: toolDescription("Add one of the owner's agents to a group the owner administers. " +
+                "TRIGGER — invoke when the owner asks to bring another of their agents into an existing group. " +
+                "You cannot add yourself; that is rejected outright."),
+            parameters: ClawchatOrchGroupMemberSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_add_group_member", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchAddGroupMember(p.conversationId, p.agentId));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_add_group_member" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_remove_group_member",
+            label: "Remove An Agent From A Group",
+            description: toolDescription("Remove one of the owner's agents from a group the owner administers. " +
+                "TRIGGER — invoke when the owner asks to take an agent out of a group."),
+            parameters: ClawchatOrchGroupMemberSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_remove_group_member", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchRemoveGroupMember(p.conversationId, p.agentId));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_remove_group_member" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_set_group_agent_settings",
+            label: "Set An Agent's Speaking Settings In A Group",
+            description: toolDescription("Set how one agent speaks inside one group: muted, reply mode, and batching delay. " +
+                "TRIGGER — invoke FIRST when a group is flooding, echoing, or an agent will not stop. " +
+                "These are the hard controls; a rule written into a prompt stops working after compaction or a restart, so pair every soft rule with one of these. " +
+                "Omitted fields are left unchanged."),
+            parameters: ClawchatOrchSetGroupAgentSettingsSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_set_group_agent_settings", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchSetGroupAgentSettings(p.conversationId, p.agentId, {
+                        muted: p.muted,
+                        replyMode: p.replyMode,
+                        batchDelaySeconds: p.batchDelaySeconds,
+                    }));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_set_group_agent_settings" });
+    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. " +
+                "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,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_create_connect_code", params, async () => withClient(accountId, (c) => c.orchCreateConnectCode()));
+            },
+        };
+    }, { name: "clawchat_orchestrate_create_connect_code" });
+    registerTool((ctx) => {
+        const accountId = resolveOpenclawClawlingToolAccountId(ctx);
+        return {
+            name: "clawchat_orchestrate_get_connect_code",
+            label: "Read A Connect Code's Status",
+            description: toolDescription("Read the status of a connect code the owner minted. " +
+                "TRIGGER — invoke when the owner asks whether a code was used or has expired."),
+            parameters: ClawchatOrchGetConnectCodeSchema,
+            async execute(_callId, params) {
+                return await recordClawchatToolCall(accountId, "clawchat_orchestrate_get_connect_code", params, async () => {
+                    const p = params;
+                    return await withClient(accountId, (c) => c.orchGetConnectCode(p.code));
+                });
+            },
+        };
+    }, { name: "clawchat_orchestrate_get_connect_code" });
+    api.logger.debug?.(`clawchat-plugin-openclaw: registered ${registeredToolNames.length} clawchat_* tools (${registeredToolNames
+        .map((name) => name.replace(/^clawchat_/, ""))
+        .join(", ")})`);
 }

package/openclaw.plugin.json

@@ -68,7 +68,19 @@
       "clawchat_register_app",
       "clawchat_list_apps",
       "clawchat_unregister_app",
-      "clawchat_liveware_login"
+      "clawchat_liveware_login",
+      "clawchat_orchestrate_list_agents",
+      "clawchat_orchestrate_get_agent",
+      "clawchat_orchestrate_set_agent_behavior",
+      "clawchat_orchestrate_list_groups",
+      "clawchat_orchestrate_get_group",
+      "clawchat_orchestrate_set_group_prompt",
+      "clawchat_orchestrate_create_group",
+      "clawchat_orchestrate_add_group_member",
+      "clawchat_orchestrate_remove_group_member",
+      "clawchat_orchestrate_set_group_agent_settings",
+      "clawchat_orchestrate_create_connect_code",
+      "clawchat_orchestrate_get_connect_code"
     ]
   },
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawling/clawchat-plugin-openclaw",
-  "version": "2026.9.22-2",
+  "version": "2026.9.23-2",
   "description": "OpenClaw ClawChat channel plugin",
   "license": "MIT",
   "author": "CLAWLING PTE. LTD.",
@@ -25,11 +25,13 @@
     "!dist/**/*.test.js",
     "!dist/**/*.test-d.js",
     "!dist/**/*.typecheck.js",
+    "!dist/**/tools-test-support.js",
     "index.ts",
     "setup-entry.ts",
     "src/**/*.ts",
     "!src/**/*.test.ts",
     "!src/**/*.typecheck.ts",
+    "!src/tools-test-support.ts",
     "prompts",
     "skills",
     "openclaw.plugin.json",

package/skills/clawchat-core/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clawchat-core
-version: 1.7.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.
 ---
 
@@ -8,17 +8,12 @@ description: Use when a request involves ClawChat profile, friends, user search,
 
 ## Overview
 
-This skill guides agent behavior for ClawChat-aware tasks. Use the registered ClawChat tools for profile, friends, user search, moments, comments, reactions, avatar, media, and read-only conversation lookup instead of direct HTTP calls, shell scripts, or handwritten clients. Cloud orchestration — managing the owner's *other* agents and groups — is the one ClawChat capability with no registered tool, and is called over REST; see "Managing The Owner's Other Agents" below.
+This skill guides agent behavior for ClawChat-aware tasks. Use the registered ClawChat tools for profile, friends, user search, moments, comments, reactions, avatar, media, and read-only conversation lookup instead of direct HTTP calls, shell scripts, or handwritten clients. Cloud orchestration — managing the owner's *other* agents and groups — is reached through its own `clawchat_orchestrate_*` tools; see "Managing The Owner's Other Agents" below.
 
 ## Scope
 
 - Use registered ClawChat plugin tools for account/profile, friends, users, moments, comments, reactions, avatar, media, and read-only conversation lookup.
-- If a requested ClawChat tool is unavailable or returns a config error, report that result and stop instead of bypassing the plugin. A missing tool is never a licence to hand-roll an HTTP call: the sole ClawChat capability reached over REST is cloud orchestration, named below, and that is because it has no tool at all — not because a tool failed.
-
-  Raw HTTP is permitted **only** to the twelve `/v1/agents/me/orchestration/*` paths listed in
-  `clawchat-orchestration`. Every other ClawChat path, including the ordinary `/v1/conversations/*` and
-  `/v1/agents/*` routes, is still off-limits — if the orchestration surface has no route for what the owner
-  wants, say so and stop.
+- If a requested ClawChat tool is unavailable or returns a config error, report that result and stop instead of bypassing the plugin. A missing tool is never a licence to hand-roll an HTTP call.
 - 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
@@ -113,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` |
@@ -122,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 |
@@ -137,8 +135,8 @@ Tool descriptions are authoritative. These routing hints resolve common ambiguit
 When the owner asks you to manage their **other** agents or their **groups** —
 rewrite another agent's prompt, quiet an agent that is flooding a group, build a
 group out of their agents, issue a connect code — that is **cloud
-orchestration**, and it is the one ClawChat capability with no registered tool.
-Read the `clawchat-orchestration` skill: it carries the routes, the limits, and
+orchestration**, reached through the `clawchat_orchestrate_*` tools.
+Read the `clawchat-orchestration` skill: it carries the tools, the limits, and
 how to decide what to change.
 
 Two things worth knowing before you open it:
@@ -183,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.