antenna-openclaw-plugin 0.1.2 → 0.2.1

package/index.ts

@@ -88,6 +88,7 @@ function fuzzyCoords(lat: number, lng: number) {
 }
 
 // TODO: Replace with LLM-based matching for better Chinese support
+// Kept for potential future server-side pre-filtering
 function extractWords(profile: Partial<Profile>): string[] {
   const text = [profile.line1, profile.line2, profile.line3]
     .filter(Boolean)
@@ -116,7 +117,7 @@ export default function register(api: any) {
   api.registerTool({
     name: "antenna_scan",
     description:
-      "Scan for nearby people at a given location. Returns matched profiles with reasons. Use when the user shares their location or asks 'who is nearby'.",
+      "Scan for nearby people at a given location. Returns raw profile cards of nearby people — the agent should read these cards and decide who to recommend based on its understanding of the user. Use when the user shares their location or asks 'who is nearby'.",
     parameters: {
       type: "object",
       properties: {
@@ -133,10 +134,9 @@ export default function register(api: any) {
       const supabase = getSupabase(cfg);
       const deviceId = deriveDeviceId(params.sender_id, params.channel);
       const radius = params.radius_m ?? cfg.defaultRadiusM ?? 500;
-      const maxMatches = cfg.maxMatches ?? 5;
 
       if (isRateLimited(deviceId)) {
-        return ok({ matches: [], message: "刚刚才扫描过，稍等一会儿再试。", rate_limited: true });
+        return ok({ nearby: [], message: "刚刚才扫描过，稍等一会儿再试。", rate_limited: true });
       }
 
       const fuzzy = fuzzyCoords(params.lat, params.lng);
@@ -157,41 +157,22 @@ export default function register(api: any) {
       const others = (nearby ?? []).filter((p: Profile) => p.device_id !== deviceId);
 
       if (others.length === 0) {
-        return ok({ matches: [], message: `在 ${radius}m 范围内没有发现其他人。试试扩大范围？` });
-      }
-
-      const { data: myProfile } = await supabase.rpc("get_profile", { p_device_id: deviceId });
-
-      const myWords = myProfile ? extractWords(myProfile) : [];
-      const scored: MatchResult[] = others.map((p: Profile) => {
-        const theirWords = extractWords(p);
-        const overlap = myWords.filter((w: string) => theirWords.includes(w));
-        const score = myWords.length > 0 ? Math.min(overlap.length / myWords.length, 1) : 0;
-        const reason = overlap.length > 0
-          ? `你们都提到了 ${overlap.slice(0, 3).join("、")}——可能聊得来`
-          : `${p.display_name || p.emoji || "TA"} 就在附近`;
-        return { device_id: p.device_id, display_name: p.display_name, emoji: p.emoji,
-          line1: p.line1, line2: p.line2, line3: p.line3, score, reason };
-      });
-
-      scored.sort((a, b) => b.score - a.score);
-      const topMatches = scored.slice(0, maxMatches);
-
-      const expiryHours = cfg.matchExpiryHours ?? 24;
-      for (const m of topMatches) {
-        await supabase.rpc("upsert_match", {
-          p_device_id_a: deviceId, p_device_id_b: m.device_id,
-          p_reason: m.reason, p_score: m.score, p_status: "pending", p_expires_hours: expiryHours,
-        });
+        return ok({ nearby: [], message: `在 ${radius}m 范围内没有发现其他人。试试扩大范围？` });
       }
 
+      // Return raw profile cards — the agent decides who to recommend
       return ok({
-        matches: topMatches.map((m) => ({
-          emoji: m.emoji || "👤", name: m.display_name || "匿名",
-          line1: m.line1, line2: m.line2, line3: m.line3,
-          score: m.score, reason: m.reason,
+        nearby: others.map((p: Profile) => ({
+          device_id: p.device_id,
+          emoji: p.emoji || "👤",
+          name: p.display_name || "匿名",
+          line1: p.line1,
+          line2: p.line2,
+          line3: p.line3,
         })),
-        total_nearby: others.length, radius_m: radius,
+        total: others.length,
+        radius_m: radius,
+        instruction: "根据你对用户的了解（记忆、偏好、最近的状态），判断哪些人值得推荐，为每个推荐写一句个性化的匹配理由。",
       });
     },
   });

package/package.json

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

package/skills/antenna/SKILL.md

@@ -19,12 +19,19 @@ You have access to the Antenna plugin tools for location-based social discovery.
 ## Tools
 
 ### `antenna_scan`
-Scan for nearby people. Use when you receive a location.
+Scan for nearby people. Returns **raw profile cards** — no scores, no pre-matching. **You are the matching engine.**
 - `lat`, `lng`: coordinates (from `LocationLat`/`LocationLon` context, or geocoded from user input)
 - `radius_m`: search radius (default 500m)
 - `sender_id`: the user's id from message context
 - `channel`: the channel name (telegram, whatsapp, discord, etc.)
 
+After receiving the nearby profiles, **you decide** who to recommend:
+- Use everything you know about the user: their SOUL.md, memory, recent conversations, interests, current mood
+- Compare each nearby person's three-line card against your understanding of the user
+- Write a personalized match reason for each person you recommend
+- Skip people who clearly aren't a match — don't recommend everyone
+- If you're unsure, lean toward recommending (let the user decide)
+
 ### `antenna_profile`
 View or update the user's name card.
 - `action`: "get" or "set"
@@ -94,23 +101,23 @@ Check for mutual matches and contact info updates.
 - 如果用户不想回答某一项，留空也行（"那这行先空着，以后想加再说"）
 - 整个过程应该像跟朋友聊天，不像填表
 
-### Showing results
-Present matches conversationally, not as a data dump:
-- Lead with the emoji and name
-- Show their three lines
-- Include the match reason naturally
-- Ask if they want to accept any match
+### Showing results — 你来判断，不是服务器
 
-Example:
-> 📡 附近发现 3 个人：
->
-> 🎸 **小林** — 吉他手，喜欢后摇和 shoegaze，在找人一起 jam
-> → 你们都提到了音乐和后摇——可能聊得来
->
-> 🏃 **Alex** — 跑步爱好者，每周三晚朝阳公园
-> → 就在附近
->
-> 想跟谁打个招呼？
+`antenna_scan` 返回的是附近所有人的名片，**没有打分、没有预匹配**。你需要：
+
+1. 读每个人的名片（emoji、name、line1/2/3）
+2. 结合你对用户的全部了解，判断谁值得推荐
+3. 为每个推荐的人写一句**个性化的理由**——不是"你们都提到了 X"，而是真正有洞察的话
+
+比如你知道用户最近在学吉他，看到附近有人写"组乐队找吉他手"：
+> 🎸 **小林** — 在组后摇乐队，找吉他手
+> → 你不是最近在学吉他吗？这人在找吉他手诶
+
+比如你知道用户是设计师，对方也做设计：
+> 🎨 **Kira** — UI 设计师，在做 AI 产品
+> → 你们都做 AI 方向的设计，可以聊聊各自的方法论
+
+**不要推荐所有人。** 如果附近 5 个人里只有 1 个真的匹配，就只推 1 个。质量 > 数量。
 
 ### Accepting & contact exchange
 When the user wants to accept a match:
@@ -143,3 +150,13 @@ Everything is ephemeral:
 - Contact info shared through matches expires with the match
 - If neither side acts, the match disappears
 - This is by design — "用完即走"
+
+### Heartbeat — 自动查匹配
+
+如果 agent 有 heartbeat 机制（定期唤醒），每次 heartbeat 时：
+1. 检查用户是否有 Antenna profile（`antenna_profile` action="get"）
+2. 如果有，调 `antenna_check_matches` 查看是否有新的 mutual match
+3. 如果有新匹配，主动通知用户："有人想认识你！"并展示对方信息
+4. 如果没有新匹配，不用说话（静默跳过）
+
+这样用户不需要主动问，agent 会自动帮忙盯着。