openclaw-pincer 0.3.3 → 0.3.5

package/dist/src/channel.js

@@ -247,6 +247,12 @@ function handleMessage(config, ctx, msg) {
         const roomId = data.room_id ?? msg.room_id ?? "";
         if (sender === config.agentId || !content)
             return;
+        // Mention-only: only respond when @agentName or @all (prevents echo loops)
+        const agentName = config.agentName ?? "";
+        const isMentioned = agentName && content.includes(`@${agentName}`);
+        const isBroadcast = content.includes("@all") || content.includes("@所有人");
+        if (!isMentioned && !isBroadcast)
+            return;
         console.log(`[openclaw-pincer] 💬 Room msg from ${sender.slice(0, 8)}: ${content.slice(0, 60)}`);
         dispatchToAgent(config, ctx, runtime, sender, content, roomId);
         return;
@@ -281,10 +287,46 @@ function dispatchToAgent(config, ctx, runtime, senderId, text, roomId) {
         accountId: ctx.accountId,
         peer,
     });
+    // Build structured route header so the agent knows exactly how to respond
+    // and which API endpoints to call for opincer operations.
+    const baseUrl = config.baseUrl.replace(/\/$/, "");
+    const routeHeader = roomId
+        ? [
+            `[Pincer Route]`,
+            `type: room`,
+            `room_id: ${roomId}`,
+            `from_agent_id: ${senderId}`,
+            `my_agent_id: ${config.agentId}`,
+            ``,
+            `[Pincer Room msg from ${senderId}]`,
+        ].join("\n")
+        : [
+            `[Pincer Route]`,
+            `type: dm`,
+            `from_agent_id: ${senderId}`,
+            `my_agent_id: ${config.agentId}`,
+            ``,
+            `[Pincer DM from ${senderId}]`,
+        ].join("\n");
+    const replyHint = roomId
+        ? [
+            ``,
+            `To reply in this room, POST to ${baseUrl}/api/v1/rooms/${roomId}/messages:`,
+            `  {"sender_agent_id": "${config.agentId}", "content": "<reply>"}`,
+            `  Header: X-API-Key: ${config.token}`,
+            `Do NOT reply via Feishu or other messaging channels.`,
+        ].join("\n")
+        : [
+            ``,
+            `To reply via DM, POST to ${baseUrl}/api/v1/messages/send:`,
+            `  {"from_agent_id": "${config.agentId}", "to_agent_id": "${senderId}", "payload": {"text": "<reply>"}}`,
+            `  Header: X-API-Key: ${config.token}`,
+        ].join("\n");
+    const agentText = `${routeHeader}\n${text}${replyHint}`;
     runtime.reply.dispatchReplyWithBufferedBlockDispatcher({
         ctx: {
-            Body: text,
-            BodyForAgent: text,
+            Body: agentText,
+            BodyForAgent: agentText,
             From: senderId,
             SessionKey: route.sessionKey,
             Channel: "openclaw-pincer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-pincer",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Pincer channel plugin for OpenClaw",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/channel.ts

@@ -277,6 +277,11 @@ function handleMessage(config: PincerConfig, ctx: any, msg: any) {
     const content = data.content ?? "";
     const roomId = data.room_id ?? msg.room_id ?? "";
     if (sender === config.agentId || !content) return;
+    // Mention-only: only respond when @agentName or @all (prevents echo loops)
+    const agentName = config.agentName ?? "";
+    const isMentioned = agentName && content.includes(`@${agentName}`);
+    const isBroadcast = content.includes("@all") || content.includes("@所有人");
+    if (!isMentioned && !isBroadcast) return;
     console.log(`[openclaw-pincer] 💬 Room msg from ${sender.slice(0, 8)}: ${content.slice(0, 60)}`);
     dispatchToAgent(config, ctx, runtime, sender, content, roomId);
     return;
@@ -320,10 +325,49 @@ function dispatchToAgent(
     peer,
   });
 
+  // Build structured route header so the agent knows exactly how to respond
+  // and which API endpoints to call for opincer operations.
+  const baseUrl = config.baseUrl.replace(/\/$/, "");
+  const routeHeader = roomId
+    ? [
+        `[Pincer Route]`,
+        `type: room`,
+        `room_id: ${roomId}`,
+        `from_agent_id: ${senderId}`,
+        `my_agent_id: ${config.agentId}`,
+        ``,
+        `[Pincer Room msg from ${senderId}]`,
+      ].join("\n")
+    : [
+        `[Pincer Route]`,
+        `type: dm`,
+        `from_agent_id: ${senderId}`,
+        `my_agent_id: ${config.agentId}`,
+        ``,
+        `[Pincer DM from ${senderId}]`,
+      ].join("\n");
+
+  const replyHint = roomId
+    ? [
+        ``,
+        `To reply in this room, POST to ${baseUrl}/api/v1/rooms/${roomId}/messages:`,
+        `  {"sender_agent_id": "${config.agentId}", "content": "<reply>"}`,
+        `  Header: X-API-Key: ${config.token}`,
+        `Do NOT reply via Feishu or other messaging channels.`,
+      ].join("\n")
+    : [
+        ``,
+        `To reply via DM, POST to ${baseUrl}/api/v1/messages/send:`,
+        `  {"from_agent_id": "${config.agentId}", "to_agent_id": "${senderId}", "payload": {"text": "<reply>"}}`,
+        `  Header: X-API-Key: ${config.token}`,
+      ].join("\n");
+
+  const agentText = `${routeHeader}\n${text}${replyHint}`;
+
   runtime.reply.dispatchReplyWithBufferedBlockDispatcher({
     ctx: {
-      Body: text,
-      BodyForAgent: text,
+      Body: agentText,
+      BodyForAgent: agentText,
       From: senderId,
       SessionKey: route.sessionKey,
       Channel: "openclaw-pincer",