antenna-openclaw-plugin 0.2.2 → 0.3.0

package/index.ts

@@ -331,22 +331,85 @@ export default function register(api: any) {
   });
 
   // ═══════════════════════════════════════════════════════════════════
-  // Hook: auto-scan when location is received
+  // Service: poll for new mutual matches every 10 minutes
+  // ═══════════════════════════════════════════════════════════════════
+  const _pendingNotifications: Map<string, any[]> = new Map(); // deviceId → new mutual matches
+
+  let _pollTimer: ReturnType<typeof setInterval> | null = null;
+
+  api.registerService({
+    id: "antenna-match-poller",
+    start: () => {
+      logger.info("Antenna: match poller started (10 min interval)");
+      _pollTimer = setInterval(async () => {
+        try {
+          const cfg = getConfig(api);
+          const supabase = getSupabase(cfg);
+
+          // Get all profiles that have been active in last 24h
+          const { data: activeProfiles } = await supabase
+            .rpc("nearby_profiles", { p_lat: 0, p_lng: 0, p_radius_m: 999999999 })
+            .select("device_id");
+
+          if (!activeProfiles?.length) return;
+
+          for (const profile of activeProfiles) {
+            const deviceId = profile.device_id;
+            const { data: matches } = await supabase.rpc("get_my_matches", { p_device_id: deviceId });
+            if (!matches?.length) continue;
+
+            // Check for matches created in last 10 min (new since last poll)
+            const newMatches = matches.filter((m: any) => {
+              const created = new Date(m.created_at).getTime();
+              return Date.now() - created < 10 * 60 * 1000;
+            });
+
+            if (newMatches.length > 0) {
+              _pendingNotifications.set(deviceId, newMatches);
+              logger.info(`Antenna: ${newMatches.length} new match(es) for ${deviceId}`);
+            }
+          }
+        } catch (err: any) {
+          logger.warn("Antenna: match poll error:", err.message);
+        }
+      }, 10 * 60 * 1000); // 10 minutes
+    },
+    stop: () => {
+      if (_pollTimer) clearInterval(_pollTimer);
+      logger.info("Antenna: match poller stopped");
+    },
+  });
+
+  // ═══════════════════════════════════════════════════════════════════
+  // Hook: auto-scan when location is received + inject match notifications
   // ═══════════════════════════════════════════════════════════════════
   api.on(
     "before_prompt_build",
     (event: any, ctx: any) => {
       try {
         const cfg = getConfig(api);
-        if (cfg.autoScanOnLocation === false) return {};
+        let hint = "";
+
+        // --- Check for pending match notifications ---
+        if (ctx?.senderId && ctx?.channel) {
+          const deviceId = deriveDeviceId(ctx.senderId, ctx.channel);
+          const pending = _pendingNotifications.get(deviceId);
+          if (pending && pending.length > 0) {
+            _pendingNotifications.delete(deviceId);
+            hint += `\n\n[Antenna] 🎉 有 ${pending.length} 个新的匹配通知！请调用 antenna_check_matches 查看详情，并告诉用户有人想认识他们。`;
+          }
+        }
+
+        // --- Auto-scan on location ---
+        if (cfg.autoScanOnLocation === false) return hint ? { prependContext: hint } : {};
 
         const lat = ctx?.LocationLat;
         const lon = ctx?.LocationLon;
-        if (lat == null || lon == null) return {};
+        if (lat == null || lon == null) return hint ? { prependContext: hint } : {};
 
         const isLive = ctx?.LocationIsLive ?? false;
         const locationName = ctx?.LocationName ?? "";
-        const hint = isLive
+        hint += isLive
           ? `\n\n[Antenna] 📡 收到实时位置 (${lat.toFixed(4)}, ${lon.toFixed(4)})${locationName ? ` — ${locationName}` : ""}。请使用 antenna_scan 工具查看附近有谁。参数：lat=${lat}, lng=${lon}, sender_id 和 channel 从消息上下文获取。`
           : `\n\n[Antenna] 📍 收到位置 (${lat.toFixed(4)}, ${lon.toFixed(4)})${locationName ? ` — ${locationName}` : ""}。请使用 antenna_scan 工具查看附近有谁。参数：lat=${lat}, lng=${lon}, sender_id 和 channel 从消息上下文获取。`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-openclaw-plugin",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Antenna — agent-mediated nearby people discovery for OpenClaw",
   "openclaw": {
     "extensions": ["./index.ts"]

package/skills/antenna/SKILL.md

@@ -8,8 +8,25 @@ metadata: { "openclaw": { "always": true } }
 
 You have access to the Antenna plugin tools for location-based social discovery.
 
+## Onboarding — 装上之后主动引导
+
+Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎么用"。
+
+### 流程
+
+**第一步：打招呼 + 解释**
+> "嘿，你装了 Antenna——它能帮你发现附近有意思的人。我先帮你做张名片，然后你发个位置给我，我看看附近有谁。"
+
+**第二步：聊天式填名片**（见下方详细流程）
+
+**第三步：名片存好后，要位置**
+> "名片存好了 ✅ 现在发个位置给我——在 Telegram/WhatsApp 里点位置分享就行。我帮你看看附近有谁值得认识。"
+
+**关键：名片先于位置。** 没有名片就扫描，附近的人看不到你的信息，匹配质量也差。
+
 ## When to use
 
+- **首次安装后**: 主动开始 onboarding（名片 → 位置）
 - User shares a location (Telegram live location, WhatsApp pin, or tells you where they are)
 - User asks "附近有谁" / "who's nearby" / "周围有什么人"
 - User wants to set up or edit their profile card (名片)
@@ -153,10 +170,11 @@ Everything is ephemeral:
 
 ### Heartbeat — 自动查匹配
 
-如果 agent 有 heartbeat 机制（定期唤醒），每次 heartbeat 时：
-1. 检查用户是否有 Antenna profile（`antenna_profile` action="get"）
-2. 如果有，调 `antenna_check_matches` 查看是否有新的 mutual match
-3. 如果有新匹配，主动通知用户："有人想认识你！"并展示对方信息
-4. 如果没有新匹配，不用说话（静默跳过）
+Plugin 自带后台服务，每 10 分钟轮询一次 Supabase 查新的 mutual match。如果发现新匹配，会在用户下次跟 agent 说话时通过 `[Antenna] 🎉` 提示注入 context。
+
+当你看到 `[Antenna] 🎉 有 X 个新的匹配通知` 时：
+1. 调 `antenna_check_matches` 拿详情
+2. 告诉用户："有人想认识你！" + 展示对方名片
+3. 如果对方分享了联系方式，一并展示
 
-这样用户不需要主动问，agent 会自动帮忙盯着。
+用户不需要主动问，agent 会自动收到通知。