@badgerclaw/connect 1.2.1 → 1.2.3

package/SETUP.md

@@ -97,8 +97,9 @@ Use these commands in any BadgerClaw room or DM where your bot is present.
 | Command | Description |
 |---------|-------------|
 | `/bot help` | Show all available commands |
-| `/bot talk on` | **Enable auto-reply** — bot responds to every message without needing an @mention. Great for 1-on-1 rooms. |
-| `/bot talk off` | **Disable auto-reply** — bot only responds when @mentioned. Use in busy group rooms. |
+| `/bot talk on` | **Enable auto-reply** — bot responds to every message without needing an @mention. If multiple bots are in the room, you'll be asked to specify which one. |
+| `/bot talk on @botname` | **Enable auto-reply for a specific bot** — use when multiple bots are in the room. |
+| `/bot talk off` | **Disable auto-reply for ALL bots** — kill switch. All bots in the room go quiet and only respond when @mentioned. |
 | `/bot add <name>` | Invite a bot to the current room (e.g. `/bot add jarvis`) |
 | `/bot list` | List all your bots and their connection status |
 
@@ -106,6 +107,7 @@ Use these commands in any BadgerClaw room or DM where your bot is present.
 
 - **New installs:** Auto-reply is **ON by default** in all rooms
 - **Per-room toggle:** `/bot talk on` and `/bot talk off` override the default for that specific room
+- **Multi-bot rooms:** If multiple bots are present, `/bot talk on` asks which bot to enable. `/bot talk off` silences all bots at once.
 - **@mentions always work:** Even with auto-reply off, the bot responds when @mentioned
 
 ---
@@ -122,8 +124,7 @@ When you install BadgerClaw with a fresh pairing code, the plugin automatically
   "groups": {
     "*": {
       "autoReply": true,
-      "enabled": true,
-      "systemPrompt": "You are a helpful AI assistant..."
+      "enabled": true
     }
   }
 }
@@ -132,19 +133,22 @@ When you install BadgerClaw with a fresh pairing code, the plugin automatically
 This means:
 - Bot joins any room it's invited to
 - Bot responds to all messages (no @mention required)
-- Bot uses a helpful assistant personality in groups
+- Bot uses **your OpenClaw workspace personality** (SOUL.md, IDENTITY.md, etc.) in all conversations — groups and DMs alike
 
-### Custom Group Personality
+When the bot joins a new encrypted room, it sends a hint message explaining the `/bot talk on|off` commands so room members know how to control it.
 
-By default, the bot uses a generic helpful assistant prompt in groups — **not** your OpenClaw workspace personality (SOUL.md, IDENTITY.md). This prevents workspace personas from causing the bot to stay silent in groups.
+### Your Personality, Everywhere
 
-To customize the group personality, edit your OpenClaw config:
+BadgerClaw respects your OpenClaw workspace files. If you've configured a custom personality (SOUL.md), the bot uses that personality in groups and DMs. This means:
 
-```bash
-openclaw configure
-```
+- A "pirate assistant" SOUL.md → bot talks like a pirate in groups
+- A "professional COO" SOUL.md → bot acts professional in groups
+- No SOUL.md → bot uses the default helpful assistant behavior
+
+**If your bot stays silent in groups**, your workspace files may include instructions like "stay silent in groups" or "only respond when needed." To fix this:
 
-Or manually edit `~/.openclaw/openclaw.json`:
+1. Edit your SOUL.md to allow group responses, OR
+2. Add a group-specific system prompt override:
 
 ```json
 {
@@ -153,7 +157,7 @@ Or manually edit `~/.openclaw/openclaw.json`:
       "groups": {
         "*": {
           "autoReply": true,
-          "systemPrompt": "You are Captain Bot, a pirate AI. Answer in pirate speak."
+          "systemPrompt": "You are a helpful AI assistant. Always respond to messages in group chats."
         }
       }
     }
@@ -183,6 +187,43 @@ You can configure specific rooms differently:
 
 ---
 
+## Upgrading from v1.1.x or Earlier
+
+If you installed BadgerClaw before v1.2.0, your config is missing the group auto-reply settings. The bot may not respond in group chats without @mentions.
+
+**Quick fix — run the update command:**
+
+```bash
+openclaw plugins update @badgerclaw/connect
+openclaw configure
+```
+
+Select BadgerClaw and re-enter a pairing code. The new onboarding will add the missing group config automatically.
+
+**Manual fix — if you don't want to re-pair:**
+
+Add this to your `~/.openclaw/openclaw.json` inside `channels.badgerclaw`:
+
+```json
+{
+  "channels": {
+    "badgerclaw": {
+      "groupPolicy": "open",
+      "groups": {
+        "*": {
+          "autoReply": true,
+          "enabled": true
+        }
+      }
+    }
+  }
+}
+```
+
+Then restart: `openclaw gateway restart`
+
+---
+
 ## FAQ
 
 ### Bot doesn't respond in group chats
@@ -193,13 +234,12 @@ You can configure specific rooms differently:
 
 ### Bot shows typing indicator but never replies
 
-This usually means the bot's system prompt is telling it to stay silent. Check:
-
-1. Your `groups` config has `autoReply: true`
-2. The `systemPrompt` in groups config tells the agent to respond (not stay silent)
-3. If you have a SOUL.md with "stay silent in groups" — the groups `systemPrompt` overrides this, but only if it's set
+Your workspace personality (SOUL.md) may tell the agent to stay silent in groups. BadgerClaw respects your workspace files, so if SOUL.md says "don't respond in groups," the bot won't.
 
-Fix: Run `openclaw configure` and reconfigure BadgerClaw, or manually add the groups config shown above.
+**Fix options:**
+1. Edit your SOUL.md to allow group responses
+2. Add a `systemPrompt` override in `channels.badgerclaw.groups.*` that tells the agent to respond (see Group Chat Configuration above)
+3. Run `openclaw configure` and reconfigure BadgerClaw
 
 ### `/bot talk on` doesn't work
 
@@ -211,15 +251,13 @@ openclaw gateway restart
 
 ### Bot responds with wrong personality
 
-The bot uses your **OpenClaw workspace personality** for DMs (SOUL.md, IDENTITY.md) but uses the **groups systemPrompt** for group chats. To change the group personality, edit `channels.badgerclaw.groups.*.systemPrompt` in your config.
+The bot uses your **OpenClaw workspace personality** (SOUL.md, IDENTITY.md) for both DMs and groups. To set a different personality for groups only, add a `systemPrompt` in `channels.badgerclaw.groups.*` in your config.
 
 ### Bot keeps saying "NO_REPLY" or stays silent
 
-Your workspace files (SOUL.md) may instruct the agent to stay silent in groups. The groups `systemPrompt` should override this. If it doesn't:
+Your workspace files (SOUL.md) instruct the agent to stay silent in groups. BadgerClaw respects your personality — this is intentional.
 
-1. Make sure `groups.*.systemPrompt` is set in your config
-2. The prompt should explicitly say to respond to messages
-3. Restart the gateway after config changes
+**To fix:** Add a `systemPrompt` override to your groups config that tells the agent to always respond. See the "Your Personality, Everywhere" section above. Then restart: `openclaw gateway restart`
 
 ### "Invalid pairing code"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@badgerclaw/connect",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "BadgerClaw channel plugin for OpenClaw",
   "type": "module",
   "dependencies": {

package/src/matrix/monitor/auto-join.ts

@@ -50,8 +50,15 @@ export function registerMatrixAutoJoin(params: {
       }
 
       logVerbose(`badgerclaw: room ${roomId} is encrypted, sending notice to trigger key rotation`);
-      await client.sendNotice(roomId, "🔐 Encryption active — session keys exchanged.");
-      logVerbose(`badgerclaw: sent encryption handshake notice in room ${roomId}`);
+      await client.sendNotice(
+        roomId,
+        "🔐 Connected — encryption active.\n\n" +
+          "I'll respond when @mentioned. To toggle auto-reply:\n" +
+          "• /bot talk on — I'll respond to every message\n" +
+          "• /bot talk off — I'll only respond when @mentioned\n" +
+          "• /bot help — see all commands",
+      );
+      logVerbose(`badgerclaw: sent encryption handshake + hint notice in room ${roomId}`);
     } catch (err) {
       runtime.log?.(`badgerclaw: encryption handshake failed for room ${roomId}: ${String(err)}`);
     }

package/src/matrix/monitor/bot-commands.ts

@@ -80,15 +80,15 @@ export async function handleBotCommand(params: {
             "  Works in: Any room or DM",
             "",
             "/bot talk on",
-            "  Enable auto-reply mode. The bot will respond to every",
-            "  message in this room without needing an @mention.",
-            "  Perfect for 1-on-1 rooms with your AI assistant.",
+            "  Enable auto-reply for this bot. It will respond to",
+            "  every message without needing an @mention.",
+            "  If multiple bots are in the room, specify which one:",
+            "  /bot talk on @botname",
             "  Works in: Any room or DM",
             "",
             "/bot talk off",
-            "  Disable auto-reply mode. The bot will only respond",
-            "  when @mentioned. Use this in busy group rooms where",
-            "  you don't want the bot responding to everything.",
+            "  Disable auto-reply for ALL bots in this room.",
+            "  Bots will only respond when @mentioned.",
             "  Works in: Any room or DM",
             "",
             "/bot add <botname>",
@@ -126,20 +126,69 @@ export async function handleBotCommand(params: {
       }
 
       case "talk": {
+        // Resolve bot members in the room
+        const botSuffix = "_bot:badger.signout.io";
+        let roomBots: string[] = [];
+        try {
+          const members = await client.getJoinedRoomMembers(roomId);
+          roomBots = members.filter((m: string) => m.includes(botSuffix) && m !== selfUserId);
+        } catch {
+          // If we can't list members, proceed as single-bot
+        }
+        const multipleBots = roomBots.length > 0; // other bots besides self
+
+        // Check if a specific bot was mentioned: /bot talk on @botname
+        const mentionArg = parts.slice(3).join(" ").trim();
+        const mentionedBot = mentionArg
+          ? mentionArg.startsWith("@") ? mentionArg : `@${mentionArg}`
+          : null;
+
+        // If a bot was mentioned and it's not us, ignore the command (let that bot handle it)
+        if (mentionedBot) {
+          const mentionLower = mentionedBot.toLowerCase();
+          const selfLower = selfUserId.toLowerCase();
+          // Match full userId or just the localpart
+          const selfLocalpart = selfLower.split(":")[0]; // @test_bot
+          if (!selfLower.startsWith(mentionLower) && !mentionLower.startsWith(selfLocalpart)) {
+            // Not addressed to us — ignore silently
+            return false;
+          }
+        }
+
         if (arg === "on") {
+          // Multiple bots + no specific mention → ask which bot
+          if (multipleBots && !mentionedBot) {
+            const botList = [selfUserId, ...roomBots]
+              .map((b, i) => `  ${i + 1}. ${b.split(":")[0]}`)
+              .join("\n");
+            await client.sendMessage(roomId, {
+              msgtype: "m.text",
+              body: [
+                "🦡 Multiple bots in this room:",
+                "",
+                botList,
+                "",
+                "Specify which bot: /bot talk on @botname",
+              ].join("\n"),
+            });
+            return true;
+          }
+
           const config = loadRoomConfig();
-          // Store with lowercase key to match OpenClaw's lowercased groupId
           const normalizedRoomId = roomId.toLowerCase();
           config[normalizedRoomId] = { ...config[normalizedRoomId], autoReply: true };
           saveRoomConfig(config);
           setGroupActivation(roomId, "always");
+          const selfName = selfUserId.split(":")[0];
           await client.sendMessage(roomId, {
             msgtype: "m.text",
-            body: "✅ Auto-reply enabled — I'll respond to every message in this room.",
+            body: `✅ Auto-reply enabled for ${selfName} — I'll respond to every message in this room.`,
           });
           return true;
         }
+
         if (arg === "off") {
+          // Off is a kill switch — disable auto-reply regardless of how many bots
           const config = loadRoomConfig();
           const normalizedRoomId = roomId.toLowerCase();
           config[normalizedRoomId] = { ...config[normalizedRoomId], autoReply: false };
@@ -147,13 +196,14 @@ export async function handleBotCommand(params: {
           setGroupActivation(roomId, "mention");
           await client.sendMessage(roomId, {
             msgtype: "m.text",
-            body: "✅ Auto-reply disabled — I'll only respond when @mentioned.",
+            body: "✅ Auto-reply disabled for all bots — bots will only respond when @mentioned.",
           });
           return true;
         }
+
         await client.sendMessage(roomId, {
           msgtype: "m.text",
-          body: "Usage: /bot talk on  or  /bot talk off",
+          body: "Usage: /bot talk on [@botname]  or  /bot talk off",
         });
         return true;
       }

package/src/onboarding.ts

@@ -245,15 +245,14 @@ export const badgerclawOnboardingAdapter: ChannelOnboardingAdapter = {
             autoJoin: "always",
             // Open policy: bot responds in any room it's invited to
             groupPolicy: "open",
-            // Default group config: auto-reply in all rooms with a helpful assistant prompt.
-            // This prevents the bot from inheriting workspace personas (SOUL.md) that may
-            // tell it to stay silent in groups or reply with NO_REPLY.
+            // Default group config: auto-reply in all rooms.
+            // No systemPrompt override — the bot respects the user's workspace personality
+            // (SOUL.md, IDENTITY.md, etc.). When the bot joins a group, it sends a hint
+            // message about /bot talk on|off so users know how to control it.
             groups: {
               "*": {
                 autoReply: true,
                 enabled: true,
-                systemPrompt:
-                  "You are a helpful AI assistant in a BadgerClaw encrypted chat room. Respond to messages directly and helpfully. Be concise and friendly.",
               },
             },
             dm: {