antenna-openclaw-plugin 0.6.1 → 0.7.1

package/index.ts

@@ -221,17 +221,17 @@ export default function register(api: any) {
   api.registerTool({
     name: "antenna_scan",
     description:
-      "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'.",
+      "Scan for nearby people. If lat/lng are omitted, uses the location from the user's web GPS binding (antenna.fyi/locate). Returns raw profile cards — the agent decides who to recommend.",
     parameters: {
       type: "object",
       properties: {
-        lat: { type: "number", description: "Latitude" },
-        lng: { type: "number", description: "Longitude" },
+        lat: { type: "number", description: "Latitude (optional if location was shared via web)" },
+        lng: { type: "number", description: "Longitude (optional if location was shared via web)" },
         radius_m: { type: "number", description: "Search radius in meters (default: 500)" },
         sender_id: { type: "string", description: "The sender's user ID (from message context)" },
         channel: { type: "string", description: "The channel name (telegram, whatsapp, etc.)" },
       },
-      required: ["lat", "lng", "sender_id", "channel"],
+      required: ["sender_id", "channel"],
     },
     async execute(_id: string, params: any) {
       const cfg = getConfig(api);
@@ -243,7 +243,21 @@ export default function register(api: any) {
         return ok({ nearby: [], message: "刚刚才扫描过，稍等一会儿再试。", rate_limited: true });
       }
 
-      const fuzzy = fuzzyCoords(params.lat, params.lng);
+      let lat = params.lat;
+      let lng = params.lng;
+
+      // If no coordinates, read from profile (web GPS bind)
+      if (lat == null || lng == null) {
+        const { data: loc } = await supabase.rpc("get_profile_location", { p_device_id: deviceId });
+        if (loc?.found) {
+          lat = loc.lat;
+          lng = loc.lng;
+        } else {
+          return ok({ nearby: [], message: "还没有位置信息。请先通过链接分享位置，或者发送位置消息。" });
+        }
+      }
+
+      const fuzzy = fuzzyCoords(lat, lng);
 
       const { error: upsertErr } = await supabase.rpc("upsert_profile_location", {
         p_device_id: deviceId, p_lng: fuzzy.lng, p_lat: fuzzy.lat,
@@ -333,6 +347,7 @@ export default function register(api: any) {
         updated: true,
         profile: { display_name: data.display_name, emoji: data.emoji,
           line1: data.line1, line2: data.line2, line3: data.line3, visible: data.visible },
+        next_step: "IMPORTANT: Now call antenna_bind to generate a GPS link for the user. Do not skip this.",
       });
     },
   });

package/package.json

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

package/skills/antenna/SKILL.md

@@ -19,21 +19,18 @@ Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎
 
 **第二步：聊天式填名片**（见下方详细流程）
 
-**第三步：名片存好后，要位置**
+**第三步：名片存好后，立刻调 antenna_bind**
 
-名片保存后，**立刻**帮用户获取位置。有两种方式，优先用第一种：
+**这一步是强制的。** 名片保存成功后，你**必须立刻**调用 `antenna_bind` 生成链接并发给用户。不要问用户要不要，不要等用户说什么，直接调。
 
-**方式 1：生成绑定链接（推荐）**
 调用 `antenna_bind` 生成链接，发给用户：
 > "名片存好了 ✅ 点这个链接，在手机浏览器打开，允许定位就行：
 > [链接]
 > 我收到你的位置后会自动帮你看看附近有谁。"
 
-**方式 2：直接发位置消息**
-如果用户在 Telegram/WhatsApp 里，可以直接发位置：
-> "或者你也可以直接在聊天里点位置分享发给我。"
+备选：如果用户在 Telegram/WhatsApp 里，也可以直接发位置消息。但优先用链接。
 
-**关键：名片存好后必须主动要位置，不要等用户问。**
+**⚠️ 如果你保存了名片但没有调 antenna_bind，你就没有完成 onboarding。**
 
 ## When to use
 
@@ -84,11 +81,11 @@ Check for mutual matches and contact info updates.
 - Returns mutual matches with any contact info the other person shared
 
 ### `antenna_bind`
-Generate a GPS binding link. Call this after profile is created to get the user's location.
+Generate a GPS binding link. **You MUST call this immediately after saving a profile.** Do not skip this step.
 - `sender_id`, `channel`: from context
 - Returns a URL like `https://www.antenna.fyi/locate?token=xxx`
-- Send this link to the user — they open it on their phone, allow GPS, and their location is automatically shared with Supabase
-- **Always call this right after saving the profile** — don't wait for the user to ask
+- Send this link to the user — they open it on their phone, allow GPS, and their location is automatically shared
+- **MANDATORY after profile save. Do not wait for user to ask.**
 
 ## Behavior guidelines