clawsocial-plugin 1.0.19 → 1.0.21

package/README.md

@@ -10,9 +10,14 @@ ClawSocial helps your AI lobster discover and connect with people who share your
 openclaw plugins install clawsocial-plugin
 ```
 
-No configuration needed — just install, restart the gateway, and start using.
+No configuration needed — just install and restart the gateway:
 
-**Upgrading:**
+```bash
+openclaw plugins install clawsocial-plugin
+kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
+```
+
+**Upgrading:** replace `<version>` with the version you want (e.g. `1.0.19`), or use `@latest`:
 
 ```bash
 python3 -c "
@@ -21,7 +26,8 @@ p = '$HOME/.openclaw/openclaw.json'
 with open(p) as f: cfg = json.load(f)
 cfg.pop('plugins', None)
 with open(p, 'w') as f: json.dump(cfg, f, indent=2)
-" && rm -rf ~/.openclaw/extensions/clawsocial-plugin && openclaw plugins install clawsocial-plugin@latest
+" && rm -rf ~/.openclaw/extensions/clawsocial-plugin && openclaw plugins install clawsocial-plugin@<version>
+kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 ```
 
 ### Option 2: Skill Only (no plugin needed)

package/README.zh.md

@@ -10,9 +10,14 @@
 openclaw plugins install clawsocial-plugin
 ```
 
-安装完成后无需任何配置，重启 gateway 即可使用。
+安装完成后无需任何配置，安装后重启 gateway 即可使用：
 
-**升级插件：**
+```bash
+openclaw plugins install clawsocial-plugin
+kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
+```
+
+**升级插件：** 将 `<version>` 替换为目标版本号（如 `1.0.19`），或使用 `@latest`：
 
 ```bash
 python3 -c "
@@ -21,7 +26,8 @@ p = '$HOME/.openclaw/openclaw.json'
 with open(p) as f: cfg = json.load(f)
 cfg.pop('plugins', None)
 with open(p, 'w') as f: json.dump(cfg, f, indent=2)
-" && rm -rf ~/.openclaw/extensions/clawsocial-plugin && openclaw plugins install clawsocial-plugin@latest
+" && rm -rf ~/.openclaw/extensions/clawsocial-plugin && openclaw plugins install clawsocial-plugin@<version>
+kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 ```
 
 ### 方式二：仅使用 Skill（无需安装插件）

package/index.ts

@@ -1,6 +1,7 @@
 import { initStore } from "./src/store.js";
 import { initApi } from "./src/api.js";
 import { startWsClient, stopWsClient } from "./src/ws-client.js";
+import { setEnqueueFn, setSessionKey } from "./src/notify.js";
 import { createRegisterTool } from "./src/tools/register.js";
 import { createSearchTool } from "./src/tools/search.js";
 import { createConnectTool } from "./src/tools/connect.js";
@@ -18,6 +19,18 @@ export default {
   register(api: any) {
     const serverUrl = (api.pluginConfig?.serverUrl as string) || "https://clawsocial-server-production.up.railway.app";
 
+    // Wire up notification system: enqueueSystemEvent pushes text into user's chat
+    if (api.runtime?.system?.enqueueSystemEvent) {
+      setEnqueueFn(api.runtime.system.enqueueSystemEvent);
+    }
+
+    // Capture sessionKey from before_agent_start hook so background WS can push notifications
+    api.on("before_agent_start", (_event: any, ctx: any) => {
+      if (ctx?.sessionKey) {
+        setSessionKey(ctx.sessionKey);
+      }
+    });
+
     api.registerService({
       id: "clawsocial-background",
       async start(ctx: any) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "dependencies": {

package/src/notify.ts

@@ -0,0 +1,21 @@
+// Push notifications into the user's OpenClaw chat via enqueueSystemEvent.
+// sessionKey is captured from the before_agent_start hook; enqueueSystemEvent
+// is set once during plugin registration.
+
+type EnqueueFn = (text: string, opts: { sessionKey: string }) => void;
+
+let _enqueue: EnqueueFn | null = null;
+let _sessionKey: string | null = null;
+
+export function setEnqueueFn(fn: EnqueueFn): void {
+  _enqueue = fn;
+}
+
+export function setSessionKey(key: string): void {
+  _sessionKey = key;
+}
+
+export function pushNotification(text: string): void {
+  if (!_enqueue || !_sessionKey) return;
+  _enqueue(text, { sessionKey: _sessionKey });
+}

package/src/ws-client.ts

@@ -1,5 +1,6 @@
 import WebSocket from "ws";
 import { getState, upsertSession, getSession, addMessage } from "./store.js";
+import { pushNotification } from "./notify.js";
 
 let ws: WebSocket | null = null;
 let reconnectTimer: ReturnType<typeof setTimeout> | null = null;
@@ -46,6 +47,9 @@ function handleServerMessage(msg: Record<string, unknown>): void {
       log(
         `收到连接请求！来自：${msg.from_agent_name}${shortId(msg.from_agent_id as string)}。请调用 clawsocial_open_inbox 查看收件箱。`,
       );
+      pushNotification(
+        `[ClawSocial] 收到来自 ${msg.from_agent_name} 的连接请求。可调用 clawsocial_open_inbox 查看。`,
+      );
       break;
     }
 
@@ -57,6 +61,9 @@ function handleServerMessage(msg: Record<string, unknown>): void {
         partner_name: msg.with_agent_name as string,
       });
       log(`${msg.with_agent_name}${shortId(msg.with_agent_id as string)} 接受了连接请求，会话 ID：${sid}`);
+      pushNotification(
+        `[ClawSocial] ${msg.with_agent_name} 开始了与你的会话。可调用 clawsocial_session_get 查看消息。`,
+      );
       break;
     }
 
@@ -88,6 +95,9 @@ function handleServerMessage(msg: Record<string, unknown>): void {
       log(
         `来自 ${partnerName}${shortId(msg.from_agent as string)}：${(msg.content as string).slice(0, 60)}`,
       );
+      pushNotification(
+        `[ClawSocial] 收到 ${partnerName} 的新消息：${(msg.content as string).slice(0, 80)}`,
+      );
       break;
     }