openclaw-pincer 0.2.5 → 0.2.7

package/dist/src/channel.d.ts

@@ -7,8 +7,11 @@ export interface PincerConfig {
     baseUrl: string;
     apiKey: string;
     agentId: string;
+    agentName?: string;
     rooms?: string[];
     pollMs?: number;
+    requireMention?: boolean;
+    historyLimit?: number;
 }
 export declare const pincerChannel: {
     id: string;
@@ -27,6 +30,12 @@ export declare const pincerChannel: {
         reactions: boolean;
         threads: boolean;
     };
+    agentPrompt: {
+        messageToolHints: () => string[];
+    };
+    groups: {
+        resolveRequireMention: (params: any) => boolean;
+    };
     config: {
         listAccountIds: (cfg: any) => string[];
         resolveAccount: (_cfg: any, accountId: string) => {

package/dist/src/channel.js

@@ -28,13 +28,41 @@ async function sendToPincerRoom(config, roomId, agentId, text) {
     });
 }
 async function sendToPincerDm(config, peerId, text) {
-    await pincerFetch(config.baseUrl, config.apiKey, `/agents/${config.agentId}/messages`, {
+    await pincerFetch(config.baseUrl, config.apiKey, "/messages/send", {
         method: "POST",
-        body: JSON.stringify({ to_agent_id: peerId, payload: { text } }),
+        body: JSON.stringify({
+            from_agent_id: config.agentId,
+            to_agent_id: peerId,
+            payload: { text },
+        }),
     });
 }
+/** Check if a room message mentions this agent (by agentId or agentName). */
+function isMentioned(text, config) {
+    if (text.includes(config.agentId))
+        return true;
+    if (config.agentName && text.includes(config.agentName))
+        return true;
+    return false;
+}
+/** Fetch recent room messages to use as conversation history. */
+async function fetchRoomHistory(config, roomId, limit) {
+    try {
+        const msgs = await pincerFetch(config.baseUrl, config.apiKey, `/rooms/${roomId}/messages?limit=${limit}`);
+        return msgs.map((m) => ({
+            sender: m.sender_agent_id ?? "unknown",
+            body: m.content ?? "",
+            timestamp: m.created_at ? new Date(m.created_at).getTime() : undefined,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
 function startRoomPoller(params) {
     const { config, roomId, ctx, signal, pollMs } = params;
+    const requireMention = config.requireMention !== false; // default true
+    const historyLimit = config.historyLimit ?? 10;
     let lastId = null;
     const poll = async () => {
         if (signal.aborted)
@@ -50,6 +78,7 @@ function startRoomPoller(params) {
             }
             const channelRuntime = ctx.channelRuntime;
             for (const msg of msgs) {
+                // Skip own messages
                 if (msg.sender_agent_id === config.agentId) {
                     lastId = msg.id;
                     continue;
@@ -60,7 +89,14 @@ function startRoomPoller(params) {
                     continue;
                 }
                 const messageText = msg.content ?? "";
+                // Require mention in group rooms (default: on)
+                if (requireMention && !isMentioned(messageText, config)) {
+                    lastId = msg.id;
+                    continue;
+                }
                 const senderId = msg.sender_agent_id ?? "unknown";
+                // Fetch recent history for context
+                const history = await fetchRoomHistory(config, roomId, historyLimit);
                 const route = channelRuntime.routing.resolveAgentRoute({
                     cfg: ctx.cfg,
                     channel: "pincer",
@@ -75,6 +111,7 @@ function startRoomPoller(params) {
                         SessionKey: route.sessionKey,
                         Channel: "pincer",
                         AccountId: ctx.accountId,
+                        InboundHistory: history,
                     },
                     cfg: ctx.cfg,
                     dispatcherOptions: {
@@ -82,6 +119,15 @@ function startRoomPoller(params) {
                             await sendToPincerRoom(config, roomId, config.agentId, payload.text);
                         },
                     },
+                    replyOptions: {
+                        extraSystemPrompt: [
+                            "You are in a Pincer agent room (group chat). Rules:",
+                            "- Only respond when directly mentioned or asked a question.",
+                            "- Keep responses concise and on-topic.",
+                            "- Do NOT engage in idle chit-chat or filler responses.",
+                            "- Do NOT respond to every message — quality over quantity.",
+                        ].join("\n"),
+                    },
                 });
                 lastId = msg.id;
             }
@@ -177,6 +223,18 @@ export const pincerChannel = {
         reactions: false,
         threads: false,
     },
+    agentPrompt: {
+        messageToolHints: () => [
+            "- In Pincer rooms, only respond when @mentioned or directly asked. No idle chit-chat.",
+            "- In Pincer DMs, respond normally.",
+        ],
+    },
+    groups: {
+        resolveRequireMention: (params) => {
+            const config = resolveConfig(params.cfg);
+            return config.requireMention !== false; // default true
+        },
+    },
     config: {
         listAccountIds: (cfg) => {
             const config = resolveConfig(cfg);
@@ -196,14 +254,12 @@ export const pincerChannel = {
                 return;
             }
             const signal = ctx.abortSignal;
-            const pollMs = config.pollMs ?? 2000;
+            const pollMs = config.pollMs ?? 15000;
             for (const roomId of config.rooms ?? []) {
                 startRoomPoller({ config, roomId, ctx, signal, pollMs });
             }
             startDmPoller({ config, ctx, signal, pollMs });
-            console.log(`[pincer] Started. Monitoring ${(config.rooms ?? []).length} room(s) + DMs as agent ${config.agentId}`);
-            // Keep startAccount alive until the signal fires — OpenClaw treats immediate
-            // return as a crash and schedules auto-restart.
+            console.log(`[pincer] Started. requireMention=${config.requireMention !== false}. Monitoring ${(config.rooms ?? []).length} room(s) + DMs as agent ${config.agentId}`);
             await new Promise((resolve) => {
                 if (signal.aborted) {
                     resolve();

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "pincer",
   "name": "Pincer",
   "description": "Pincer channel plugin for OpenClaw — connects agents to Pincer rooms and DMs",
-  "version": "0.2.1",
+  "version": "0.2.7",
   "channels": ["pincer"],
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-pincer",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Pincer channel plugin for OpenClaw",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,4 +38,4 @@
     "index.ts",
     "openclaw.plugin.json"
   ]
-}
+}

package/src/channel.ts

@@ -8,8 +8,11 @@ export interface PincerConfig {
   baseUrl: string;
   apiKey: string;
   agentId: string;
+  agentName?: string;       // display name for mention detection (e.g. "蔻儿")
   rooms?: string[];
   pollMs?: number;
+  requireMention?: boolean; // default: true — only respond in rooms when @mentioned
+  historyLimit?: number;    // how many messages to include as context (default: 10)
 }
 
 interface PincerMessage {
@@ -65,12 +68,45 @@ async function sendToPincerDm(
   peerId: string,
   text: string
 ): Promise<void> {
-  await pincerFetch(config.baseUrl, config.apiKey, `/agents/${config.agentId}/messages`, {
+  await pincerFetch(config.baseUrl, config.apiKey, "/messages/send", {
     method: "POST",
-    body: JSON.stringify({ to_agent_id: peerId, payload: { text } }),
+    body: JSON.stringify({
+      from_agent_id: config.agentId,
+      to_agent_id: peerId,
+      payload: { text },
+    }),
   });
 }
 
+/** Check if a room message mentions this agent (by agentId or agentName). */
+function isMentioned(text: string, config: PincerConfig): boolean {
+  if (text.includes(config.agentId)) return true;
+  if (config.agentName && text.includes(config.agentName)) return true;
+  return false;
+}
+
+/** Fetch recent room messages to use as conversation history. */
+async function fetchRoomHistory(
+  config: PincerConfig,
+  roomId: string,
+  limit: number
+): Promise<Array<{ sender: string; body: string; timestamp?: number }>> {
+  try {
+    const msgs: PincerMessage[] = await pincerFetch(
+      config.baseUrl,
+      config.apiKey,
+      `/rooms/${roomId}/messages?limit=${limit}`
+    );
+    return msgs.map((m) => ({
+      sender: m.sender_agent_id ?? "unknown",
+      body: m.content ?? "",
+      timestamp: m.created_at ? new Date(m.created_at).getTime() : undefined,
+    }));
+  } catch {
+    return [];
+  }
+}
+
 function startRoomPoller(params: {
   config: PincerConfig;
   roomId: string;
@@ -79,6 +115,8 @@ function startRoomPoller(params: {
   pollMs: number;
 }) {
   const { config, roomId, ctx, signal, pollMs } = params;
+  const requireMention = config.requireMention !== false; // default true
+  const historyLimit = config.historyLimit ?? 10;
   let lastId: string | null = null;
 
   const poll = async () => {
@@ -99,6 +137,7 @@ function startRoomPoller(params: {
 
       const channelRuntime = ctx.channelRuntime;
       for (const msg of msgs) {
+        // Skip own messages
         if (msg.sender_agent_id === config.agentId) {
           lastId = msg.id;
           continue;
@@ -111,8 +150,18 @@ function startRoomPoller(params: {
         }
 
         const messageText = msg.content ?? "";
+
+        // Require mention in group rooms (default: on)
+        if (requireMention && !isMentioned(messageText, config)) {
+          lastId = msg.id;
+          continue;
+        }
+
         const senderId = msg.sender_agent_id ?? "unknown";
 
+        // Fetch recent history for context
+        const history = await fetchRoomHistory(config, roomId, historyLimit);
+
         const route = channelRuntime.routing.resolveAgentRoute({
           cfg: ctx.cfg,
           channel: "pincer",
@@ -128,6 +177,7 @@ function startRoomPoller(params: {
             SessionKey: route.sessionKey,
             Channel: "pincer",
             AccountId: ctx.accountId,
+            InboundHistory: history,
           },
           cfg: ctx.cfg,
           dispatcherOptions: {
@@ -135,6 +185,15 @@ function startRoomPoller(params: {
               await sendToPincerRoom(config, roomId, config.agentId, payload.text);
             },
           },
+          replyOptions: {
+            extraSystemPrompt: [
+              "You are in a Pincer agent room (group chat). Rules:",
+              "- Only respond when directly mentioned or asked a question.",
+              "- Keep responses concise and on-topic.",
+              "- Do NOT engage in idle chit-chat or filler responses.",
+              "- Do NOT respond to every message — quality over quantity.",
+            ].join("\n"),
+          } as any,
         });
 
         lastId = msg.id;
@@ -248,6 +307,18 @@ export const pincerChannel = {
     reactions: false,
     threads: false,
   },
+  agentPrompt: {
+    messageToolHints: () => [
+      "- In Pincer rooms, only respond when @mentioned or directly asked. No idle chit-chat.",
+      "- In Pincer DMs, respond normally.",
+    ],
+  },
+  groups: {
+    resolveRequireMention: (params: any) => {
+      const config = resolveConfig(params.cfg);
+      return config.requireMention !== false; // default true
+    },
+  },
   config: {
     listAccountIds: (cfg: any) => {
       const config = resolveConfig(cfg);
@@ -267,7 +338,7 @@ export const pincerChannel = {
       }
 
       const signal: AbortSignal = ctx.abortSignal;
-      const pollMs = config.pollMs ?? 2000;
+      const pollMs = config.pollMs ?? 15000;
 
       for (const roomId of config.rooms ?? []) {
         startRoomPoller({ config, roomId, ctx, signal, pollMs });
@@ -276,11 +347,9 @@ export const pincerChannel = {
       startDmPoller({ config, ctx, signal, pollMs });
 
       console.log(
-        `[pincer] Started. Monitoring ${(config.rooms ?? []).length} room(s) + DMs as agent ${config.agentId}`
+        `[pincer] Started. requireMention=${config.requireMention !== false}. Monitoring ${(config.rooms ?? []).length} room(s) + DMs as agent ${config.agentId}`
       );
 
-      // Keep startAccount alive until the signal fires — OpenClaw treats immediate
-      // return as a crash and schedules auto-restart.
       await new Promise<void>((resolve) => {
         if (signal.aborted) { resolve(); return; }
         signal.addEventListener("abort", () => resolve(), { once: true });