antenna-openclaw-plugin 0.1.1 → 0.2.0

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.1",
+  "version": "0.2.0",
   "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"
@@ -50,29 +57,67 @@ Check for mutual matches and contact info updates.
 
 ## Behavior guidelines
 
-### First-time user
-If the user doesn't have a profile yet, guide them to create one BEFORE scanning:
-1. Ask for a name, an emoji, and three short lines about themselves
-2. Use `antenna_profile` action="set" to save it
-3. Then proceed to scan
-
-### 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
-
-Example:
-> 📡 附近发现 3 个人：
->
-> 🎸 **小林** — 吉他手，喜欢后摇和 shoegaze，在找人一起 jam
-> → 你们都提到了音乐和后摇——可能聊得来
+### First-time user — 聊天式引导（不要让用户填表）
+
+**绝对不要**一次性说"请填写 emoji、名字、三句话介绍"——这会让用户懵掉。
+
+用聊天的方式一步一步引导：
+
+**第一步：开场**
+> "嘿，第一次用 Antenna？我帮你做张名片，附近的人会看到它。先聊几句就行。"
+
+**第二步：问职业/身份**（→ line1）
+> "你平时做什么？工作、学生、自由职业、还是别的？"
+
+用户可能回答很长，也可能很短。不管怎样，你提炼成一句简短的话。
+
+**第三步：问兴趣**（→ line2）
+> "最近在玩什么？或者对什么特别感兴趣？"
+
+**第四步：问意图**（→ line3）
+> "来这儿想认识什么样的人？或者找什么？"
+
+**第五步：问名字和 emoji**
+> "最后——你想被叫什么？再选个 emoji 代表你自己。"
+
+**第六步：确认**
+把名片组装好，展示给用户确认：
+> 你的名片：
 >
-> 🏃 **Alex** — 跑步爱好者，每周三晚朝阳公园
-> → 就在附近
+> 🎸 **小林**
+> 吉他手，在乐队弹后摇
+> 喜欢 shoegaze 和 post-rock，最近在听 Mogwai
+> 找人一起 jam 或者聊音乐
 >
-> 想跟谁打个招呼？
+> 看看有没有要改的？OK 的话我就存了。
+
+用户说 OK → `antenna_profile` action="set" 保存。
+用户说要改 → 改完再确认。
+
+**关键原则：**
+- 每次只问一个问题
+- 用户说的原话尽量保留，不要过度润色
+- 可以帮用户缩短太长的回答，但要让用户确认
+- 如果用户不想回答某一项，留空也行（"那这行先空着，以后想加再说"）
+- 整个过程应该像跟朋友聊天，不像填表
+
+### Showing results — 你来判断，不是服务器
+
+`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: