@keychat-io/keychat-openclaw 0.1.12 → 0.1.14

package/README.md

@@ -29,17 +29,22 @@ This clones the repo, downloads the binary, registers the plugin, and restarts t
 
 ### Security Warnings
 
-During installation, OpenClaw's security scanner may show two warnings. Both are expected:
+During installation, OpenClaw's security scanner may show three warnings. All are expected:
 
 | Warning | Reason |
 |---------|--------|
 | Shell command execution (bridge-client.ts) | Keychat's Signal Protocol and MLS Protocol encryption are implemented in Rust. The plugin spawns a Rust sidecar process to bridge between Node.js and the native crypto layer. |
 | Shell command execution (keychain.ts) | Agent identity mnemonics are stored in the OS keychain (macOS Keychain / Linux libsecret) rather than plain files, which is the more secure option. |
+| Shell command execution (notify.ts) | After startup, the plugin notifies the agent so it can proactively send the Keychat ID and QR code to the user on their active channel (Telegram, webchat, etc). |
 
 Source code is fully open: [github.com/keychat-io/keychat-openclaw](https://github.com/keychat-io/keychat-openclaw)
 
 ### Upgrade
 
+**Easiest way:** Just tell your agent "upgrade keychat" in any chat. The agent will handle it and reconnect automatically.
+
+Or manually:
+
 If you installed via **Option A**:
 
 ```bash

package/openclaw.plugin.json

@@ -1,5 +1,5 @@
 {
-  "id": "keychat",
+  "id": "keychat-openclaw",
   "channels": ["keychat"],
   "name": "Keychat",
   "description": "Sovereign identity + E2E encrypted chat via Signal Protocol over Nostr relays. Lightning wallet support via LNURL-pay and NWC.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keychat-io/keychat-openclaw",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Keychat — E2E encrypted chat + Lightning wallet for OpenClaw agents",
   "license": "AGPL-3.0",
   "repository": {
@@ -17,7 +17,6 @@
     "zod": "^4.3.6"
   },
   "openclaw": {
-    "id": "keychat",
     "extensions": [
       "./index.ts"
     ],

package/src/channel.ts

@@ -826,18 +826,24 @@ export const keychatPlugin: ChannelPlugin<ResolvedKeychatAccount> = {
         `═══════════════════════════════════════════════════\n`,
       );
 
-      // Notify agent so it can relay the link to the owner on any active channel
-      try {
-        const { sendSystemEvent } = await import("./notify.js");
-        await sendSystemEvent(
-          `[Keychat Plugin] Agent "${displayName}" (account: ${account.accountId}) is online and ready.\n` +
-          `Use the keychat_identity tool to get the agent's Keychat ID, contact link, and QR code.\n` +
-          `Then send the contact info to the user on their active channel using the message tool.\n` +
-          `The user can open the link or scan the QR code in Keychat app to add this agent as a contact.`,
-        );
-      } catch {
-        // Best-effort: if openclaw CLI not available or event fails, just log
-        ctx.log?.warn?.(`[${account.accountId}] Failed to send system event notification`);
+      // Notify agent on first install only (not on every restart)
+      const { KEYCHAT_DIR } = await import("./paths.js");
+      const notifiedMarker = join(KEYCHAT_DIR, `.notified-${account.accountId}`);
+      if (!existsSync(notifiedMarker)) {
+        try {
+          const { sendSystemEvent } = await import("./notify.js");
+          await sendSystemEvent(
+            `[Keychat Plugin] Agent "${displayName}" (account: ${account.accountId}) is online and ready.\n` +
+            `Use the keychat_identity tool to get the agent's Keychat ID, contact link, and QR code.\n` +
+            `Then send the contact info to the user on their active channel using the message tool.\n` +
+            `The user can open the link or scan the QR code in Keychat app to add this agent as a contact.`,
+          );
+          // Mark as notified so we don't repeat on restart
+          const { writeFileSync } = await import("node:fs");
+          writeFileSync(notifiedMarker, new Date().toISOString());
+        } catch {
+          ctx.log?.warn?.(`[${account.accountId}] Failed to send system event notification`);
+        }
       }
 
       ctx.setStatus({