antenna-openclaw-plugin 0.6.0 → 0.7.0

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,

package/package.json

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

package/skills/antenna/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: antenna
-description: "Nearby people discovery via Antenna. Use when a user shares location, asks who's nearby, wants to set up their profile card, or interacts with match results. Handles location-based social discovery through the antenna_scan, antenna_profile, antenna_accept, and antenna_check_matches tools."
+description: "Nearby people discovery via Antenna. Use when a user shares location, asks who's nearby, wants to set up their profile card, or interacts with match results. Handles location-based social discovery through the antenna_scan, antenna_profile, antenna_accept, antenna_check_matches, and antenna_bind tools."
 metadata: { "openclaw": { "always": true } }
 ---
 
@@ -20,9 +20,20 @@ Plugin 安装后，agent 应该**主动**开始引导，不要等用户问"怎
 **第二步：聊天式填名片**（见下方详细流程）
 
 **第三步：名片存好后，要位置**
-> "名片存好了 ✅ 现在发个位置给我——在 Telegram/WhatsApp 里点位置分享就行。我帮你看看附近有谁值得认识。"
 
-**关键：名片先于位置。** 没有名片就扫描，附近的人看不到你的信息，匹配质量也差。
+名片保存后，**立刻**帮用户获取位置。有两种方式，优先用第一种：
+
+**方式 1：生成绑定链接（推荐）**
+调用 `antenna_bind` 生成链接，发给用户：
+> "名片存好了 ✅ 点这个链接，在手机浏览器打开，允许定位就行：
+> [链接]
+> 我收到你的位置后会自动帮你看看附近有谁。"
+
+**方式 2：直接发位置消息**
+如果用户在 Telegram/WhatsApp 里，可以直接发位置：
+> "或者你也可以直接在聊天里点位置分享发给我。"
+
+**关键：名片存好后必须主动要位置，不要等用户问。**
 
 ## When to use
 
@@ -72,6 +83,13 @@ Check for mutual matches and contact info updates.
 - `sender_id`, `channel`
 - 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.
+- `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
+
 ## Behavior guidelines
 
 ### First-time user — 聊天式引导（不要让用户填表）