@clawling/clawchat-plugin-openclaw 2026.9.26-2 → 2026.10.7-1

package/src/runtime.ts

@@ -96,6 +96,7 @@ import {
 import { refreshGroupProfile, syncFirstSeenClawChatProfiles } from "./profile-sync.ts";
 import { pullGroupMetadata, pullOwnerMetadata } from "./clawchat-metadata.ts";
 import { deleteClawChatMemoryFile, readClawChatMemoryFile } from "./clawchat-memory.ts";
+import { registerMentionRosterResolver } from "./mention-autolink.ts";
 import {
   clearClawChatPromptInjectionForSession,
   stageClawChatPromptInjection,
@@ -3831,6 +3832,21 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
     return;
   }
   activeClients.set(accountId, client);
+  // Text "@name" autolinking on outbound group sends reads the same cached
+  // roster (participant ids + nicknames) the group prompt shows the model.
+  const unregisterMentionRoster = registerMentionRosterResolver(accountId, async (groupId) => {
+    const memoryRoot = resolveMemoryRootForPeer({ kind: "group", id: groupId });
+    if (!memoryRoot) return [];
+    let ownerMetadata: ClawChatPromptMetadata | null = null;
+    try {
+      const ownerFile = await readClawChatMemoryFile(memoryRoot, { targetType: "owner", targetId: "owner" });
+      ownerMetadata = ownerFile.exists ? ownerFile.metadata : null;
+    } catch {
+      ownerMetadata = null;
+    }
+    const participants = await loadGroupParticipantsForPrompt({ memoryRoot, groupId, ownerMetadata });
+    return participants.map((participant) => ({ userId: participant.id, name: participant.name }));
+  });
   log?.info?.(`[${accountId}] clawchat-plugin-openclaw runtime active client registered`);
   setStatus({
     ...getStatus(),
@@ -3843,6 +3859,7 @@ export async function startOpenclawClawlingGateway(params: StartGatewayParams):
   await waitUntilAbort(abortSignal, async () => {
     log?.info?.(`[${accountId}] clawchat-plugin-openclaw runtime abort received; closing client`);
     activeClients.delete(accountId);
+    unregisterMentionRoster();
     closingForAbort = true;
     clearBootstrapRetry();
     // §A.1 — stop the proactive refresh timer on shutdown.

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

package/src/tools.ts

@@ -1867,11 +1867,18 @@ export function registerOpenclawClawlingTools(
         name: "clawchat_orchestrate_set_agent_behavior",
         label: "Rewrite A Sibling's System Prompt",
         description: toolDescription(
+          "Stage/room speaking rules go in the group description, not here; for a stage, append the stage sentence below to off-desktop members (clawchat-orchestration skill). " +
           "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.",
+          "Nickname and bio cannot be changed here. " +
+          "Behavior follows an agent into every room, so one room's rules never go here — they go in that group's description (clawchat_orchestrate_set_group_prompt). " +
+          "A stage (a group whose description has its agents chime in freely) adds only one line here, the same for every room: " +
+          "give each member that the ClawChat desktop app does not run on the owner's computer — Hermes and OpenClaw plugin agents among them — this sentence, verbatim, " +
+          "appended without deleting anything and without naming the room: " +
+          "\"In a group whose description makes it a stage, you are one of the players: pick up the other characters' lines without waiting to be called.\" " +
+          "Older plugin versions rank the group description below their own reply rules; this line is what lets them speak on a stage.",
         ),
         parameters: ClawchatOrchSetAgentBehaviorSchema,
         async execute(_callId, params) {
@@ -1940,11 +1947,15 @@ export function registerOpenclawClawlingTools(
         name: "clawchat_orchestrate_set_group_prompt",
         label: "Rewrite A Group's System Prompt",
         description: toolDescription(
+          "Stage/room speaking rules go here, in the group description; for a stage, also append the stage sentence to off-desktop members' behavior (clawchat-orchestration skill). " +
           "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.",
+          "The group title cannot be changed here. " +
+          "A room where agents should chime in freely, a stage, says so in its description, and its own rules go nowhere else: behavior follows an agent into every room. " +
+          "A stage also needs one room-independent line in the behavior of each member the ClawChat desktop app does not run on the owner's computer, appended verbatim with clawchat_orchestrate_set_agent_behavior: " +
+          "\"In a group whose description makes it a stage, you are one of the players: pick up the other characters' lines without waiting to be called.\"",
         ),
         parameters: ClawchatOrchSetGroupPromptSchema,
         async execute(_callId, params) {