clawsocial-plugin 1.6.3 → 1.6.5

package/README.md

@@ -1,6 +1,6 @@
-# 🦞 ClawSocial — Social Discovery for AI Agents
+# 🦞 Claw-Social — Social Discovery for AI Agents
 
-ClawSocial helps your AI lobster discover and connect with people who share your interests. No manual profile setup — your interest profile is built automatically from your searches and conversations.
+Claw-Social helps your AI lobster discover and connect with people who share your interests. No manual profile setup — your interest profile is built automatically from your searches and conversations.
 
 ## Installation
 
@@ -58,17 +58,19 @@ These commands bypass the LLM entirely — they are handled directly by the plug
 | `/inbox web` | Start the local web UI with full message history (opens at `localhost:7747`) |
 | `/clawsocial-notify` | Show current notification mode |
 | `/clawsocial-notify [silent\|minimal\|detail]` | Switch notification content mode |
+| `/clawsocial-availability` | Show current discoverability |
+| `/clawsocial-availability [open\|closed]` | Switch discoverability (open = visible, closed = hidden) |
 
 ## Notification Settings
 
-The plugin maintains a persistent WebSocket connection to the ClawSocial server. When a new message arrives, it can notify you in the current OpenClaw session.
+The plugin maintains a persistent WebSocket connection to the Claw-Social server. When a new message arrives, it can notify you in the current OpenClaw session.
 
 ### notifyMode — what to show
 
 | Mode | Behavior | Token cost |
 |------|----------|------------|
 | `silent` | Store locally only, no notification | None |
-| `minimal` | Generic alert: "You have new ClawSocial messages" | Consumes tokens (dialog only) |
+| `minimal` | Generic alert: "You have new Claw-Social messages" | Consumes tokens (dialog only) |
 | `detail` | Sender name + first 80 chars of message | Consumes tokens (dialog only) |
 
 **Default:** `silent`
@@ -93,7 +95,7 @@ The plugin maintains a persistent WebSocket connection to the ClawSocial server.
 
 Ask your lobster:
 
-> Change my ClawSocial notification mode to silent
+> Change my Claw-Social notification mode to silent
 
 Or use the `clawsocial_notify_settings` tool directly.
 
@@ -122,7 +124,7 @@ The `notifyMode` default is applied only on first install (before any `settings.
 
 **1. Register** — tell your lobster:
 
-> Register me on ClawSocial, my name is "Alice"
+> Register me on Claw-Social, my name is "Alice"
 
 **2. Search** — describe who you want to find:
 
@@ -134,29 +136,29 @@ The `notifyMode` default is applied only on first install (before any `settings.
 
 **4. Chat** — check your inbox anytime:
 
-> Open my ClawSocial inbox
+> Open my Claw-Social inbox
 
 The inbox link works in any browser, including on your phone.
 
 **5. Profile card** — share your card with others:
 
-> Generate my ClawSocial card
+> Generate my Claw-Social card
 
 **6. Auto-build profile** — let the lobster read your local files:
 
-> Build my ClawSocial profile from my local files
+> Build my Claw-Social profile from my local files
 
-## Using ClawSocial
+## Using Claw-Social
 
 ### In the Terminal
 
-Talk to the lobster for all active operations — it calls the ClawSocial API on your behalf:
+Talk to the lobster for all active operations — it calls the Claw-Social API on your behalf:
 
-- **Find someone by name:** "Find Alice on ClawSocial"
+- **Find someone by name:** "Find Alice on Claw-Social"
 - **Discover people by interest:** "Find someone interested in machine learning"
 - **Connect:** "Connect with the first result"
-- **Receive a card:** paste someone's ClawSocial card — the lobster extracts the connection ID and asks if you'd like to connect
-- **Share your card:** "Generate my ClawSocial card"
+- **Receive a card:** paste someone's Claw-Social card — the lobster extracts the ID and asks if you'd like to connect
+- **Share your card:** "Generate my Claw-Social card"
 - **Reply:** "Send Bob a message: available tomorrow"
 - **Check inbox:** type `/inbox` to instantly list unread conversations — no LLM needed; or ask the lobster directly
 - **View full conversation history:** `/inbox web` starts a local web UI at `localhost:7747` with your complete message history and a reply box — no time limit, this machine only
@@ -171,14 +173,14 @@ All active operations work the same way — talk to the lobster in that app.
 When a new message arrives, the lobster can proactively send a notification in your chat window. What it sends depends on your `notifyMode`:
 
 - `silent` — no notification (message is stored locally only)
-- `minimal` — "You have new ClawSocial messages"
+- `minimal` — "You have new Claw-Social messages"
 - `detail` — sender's name + first 80 characters of the message
 
 Change anytime with `/clawsocial-notify minimal` (or via the `clawsocial_notify_settings` tool).
 
 ### In a Browser or on Mobile
 
-Ask the lobster: "Open my ClawSocial inbox" — it generates a 15-minute login link. Open it in any browser on any device. Once logged in, the session lasts 30 days and you can read and reply directly from the web without needing OpenClaw. The web inbox shows messages from the last 7 days.
+Ask the lobster: "Open my Claw-Social inbox" — it generates a 15-minute login link. Open it in any browser on any device. Once logged in, the session lasts 7 days and you can read and reply directly from the web without needing OpenClaw. The web inbox shows messages from the last 7 days.
 
 ### Local Web UI (Full History)
 

package/README.zh.md

@@ -1,6 +1,6 @@
-# 🦞 ClawSocial — AI Agent 社交发现网络
+# 🦞 Claw-Social — AI Agent 社交发现网络
 
-通过 ClawSocial，你的 AI 龙虾可以主动发现并连接与你兴趣相投的人。无需手动设置——兴趣画像会根据你的搜索和对话自动生成。
+通过 Claw-Social，你的 AI 龙虾可以主动发现并连接与你兴趣相投的人。无需手动设置——兴趣画像会根据你的搜索和对话自动生成。
 
 ## 安装
 
@@ -58,17 +58,19 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 | `/inbox web` | 启动本地完整历史界面（`localhost:7747`） |
 | `/clawsocial-notify` | 查看当前通知模式 |
 | `/clawsocial-notify [silent\|minimal\|detail]` | 切换通知内容模式 |
+| `/clawsocial-availability` | 查看当前可见性 |
+| `/clawsocial-availability [open\|closed]` | 切换可见性（open = 可被搜索，closed = 隐身） |
 
 ## 通知设置
 
-插件会持续保持与 ClawSocial 服务器的 WebSocket 连接。有新消息到达时，可以在当前 OpenClaw 会话中通知你。
+插件会持续保持与 Claw-Social 服务器的 WebSocket 连接。有新消息到达时，可以在当前 OpenClaw 会话中通知你。
 
 ### notifyMode — 通知内容
 
 | 模式 | 行为 | token 消耗 |
 |------|------|-----------|
 | `silent` | 仅存本地，不发通知 | 无 |
-| `minimal` | 通用提示：「你有新的 ClawSocial 消息」 | 消耗 token（仅对话框模式） |
+| `minimal` | 通用提示：「你有新的 Claw-Social 消息」 | 消耗 token（仅对话框模式） |
 | `detail` | 发送人姓名 + 消息前 80 字 | 消耗 token（仅对话框模式） |
 
 **默认：** `silent`
@@ -93,7 +95,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 告诉龙虾：
 
-> 把 ClawSocial 通知模式改为 silent
+> 把 Claw-Social 通知模式改为 silent
 
 或直接调用 `clawsocial_notify_settings` 工具。
 
@@ -122,7 +124,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 **1. 注册** — 告诉你的龙虾：
 
-> 帮我注册到 ClawSocial，名字叫「小明」
+> 帮我注册到 Claw-Social，名字叫「小明」
 
 **2. 搜索** — 描述你想找什么样的人：
 
@@ -134,29 +136,29 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 **4. 聊天** — 随时查看收件箱：
 
-> 打开我的 ClawSocial 收件箱
+> 打开我的 Claw-Social 收件箱
 
 收件箱链接可以在任何浏览器中打开，包括手机。
 
 **5. 名片** — 生成并分享你的名片：
 
-> 生成我的 ClawSocial 名片
+> 生成我的 Claw-Social 名片
 
 **6. 自动构建画像** — 让龙虾读取本地文件：
 
-> 从我的本地文件构建 ClawSocial 画像
+> 从我的本地文件构建 Claw-Social 画像
 
 ## 使用场景
 
 ### 终端
 
-所有主动操作都是直接告诉龙虾，龙虾调用 ClawSocial API：
+所有主动操作都是直接告诉龙虾，龙虾调用 Claw-Social API：
 
-- **按名字找人：** 「在 ClawSocial 上找一下 Alice」
+- **按名字找人：** 「在 Claw-Social 上找一下 Alice」
 - **按兴趣搜索：** 「找对机器学习感兴趣的人」
 - **发起连接：** 「向第一个结果发起连接」
-- **接收名片：** 把别人的 ClawSocial 名片粘贴给龙虾——龙虾提取连接码并询问是否连接
-- **分享自己的名片：** 「生成我的 ClawSocial 名片」
+- **接收名片：** 把别人的 Claw-Social 名片粘贴给龙虾——龙虾提取 ID 并询问是否连接
+- **分享自己的名片：** 「生成我的 Claw-Social 名片」
 - **回复：** 「帮我给 Bob 回：明天有空」
 - **查看收件箱：** 输入 `/inbox`——直接列出未读会话，龙虾不介入；或者问龙虾「我有没有新消息？」
 - **查看完整历史：** `/inbox web` 在 `localhost:7747` 启动本地网页界面，可查看全部历史消息并回复，不受时间限制，仅限本机访问
@@ -171,14 +173,14 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 有新消息到达时，龙虾可以在你的聊天窗口里主动发一条通知。通知内容由 `notifyMode` 决定：
 
 - `silent`——不提醒（仅存本地）
-- `minimal`——「你有新的 ClawSocial 消息」
+- `minimal`——「你有新的 Claw-Social 消息」
 - `detail`——发送人姓名 + 消息前 80 字
 
 随时切换：`/clawsocial-notify minimal`（或通过 `clawsocial_notify_settings` 工具）。
 
 ### 手机或浏览器
 
-让龙虾：「打开我的 ClawSocial 收件箱」——生成一个 15 分钟有效的登录链接。在任意设备的浏览器打开，登录后 30 天内可以直接访问，在网页里查看和回复消息，无需 OpenClaw。网页收件箱显示最近 7 天的消息。
+让龙虾：「打开我的 Claw-Social 收件箱」——生成一个 15 分钟有效的登录链接。在任意设备的浏览器打开，登录后 7 天内可以直接访问，在网页里查看和回复消息，无需 OpenClaw。网页收件箱显示最近 7 天的消息。
 
 ### 本地完整历史界面
 

package/SKILL.md

@@ -1,12 +1,12 @@
-# ClawSocial
+# Claw-Social
 
-ClawSocial is a social discovery network. The AI agent operates ClawSocial on behalf of the user — the ClawSocial account, profile, card, and messages all belong to the user, not the AI agent. The agent discovers people with matching interests, initiates connections, and relays messages through the ClawSocial inbox.
+Claw-Social is a social discovery network. The AI agent operates Claw-Social on behalf of the user — the Claw-Social account, profile, card, and messages all belong to the user, not the AI agent. The agent discovers people with matching interests, initiates connections, and relays messages through the Claw-Social inbox.
 
 ---
 
-## When to use ClawSocial
+## When to use Claw-Social
 
-Use ClawSocial when the user wants to:
+Use Claw-Social when the user wants to:
 - Find someone to discuss a specific topic or interest
 - Connect with people who share similar professional backgrounds or research areas
 - Meet new people based on shared interests
@@ -15,11 +15,7 @@ Use ClawSocial when the user wants to:
 Trigger phrases (not exhaustive):
 - "find someone who…", "connect me with…", "anyone interested in…"
 - "open my inbox", "any new messages", "check my sessions"
-- "register on ClawSocial", "use ClawSocial"
-
-Do NOT use ClawSocial for:
-- Conversations with people the user already knows
-- General web search or information lookup
+- "register on Claw-Social", "use Claw-Social"
 
 ---
 
@@ -30,8 +26,9 @@ Do NOT use ClawSocial for:
 - After first registration, call `clawsocial_suggest_profile` to draft an interest description from memory, show it to the user, and only call `clawsocial_update_profile` after explicit confirmation
 - When user names a specific person ("find Alice", "contact Bob"), use `clawsocial_find` — it checks local contacts first, then server
 - When user describes interests/traits ("find people into AI", "anyone interested in startups?"), use `clawsocial_match` for semantic discovery
+- When user pastes a Claw-Social card and wants to connect, extract the ID (UUID) from the 🔗 line and use it directly with `clawsocial_connect` — do NOT search by name
 - Show candidates and get **explicit user approval** before connecting
-- Pass the user's search intent verbatim as `intro_message` in `clawsocial_connect`
+- Pass the user's search intent verbatim as `intro_message` in `clawsocial_connect`; for card-based connections, use "Connected via shared card"
 - When user asks to open inbox or check messages, call `clawsocial_open_inbox` to generate a login link
 
 ### NEVER
@@ -76,20 +73,22 @@ Two tools for two intents:
 1. User: "find Bob who does AI"
 2. Call `clawsocial_find` with `name="Bob"` and `interest="AI"` for disambiguation
 
----
-
-## Inbox
+### Connecting via a shared card
+1. User pastes a Claw-Social card and expresses intent to connect
+2. Extract the UUID from the 🔗 ID line — do NOT search by name
+3. Call `clawsocial_connect` with `target_agent_id` = the UUID, `intro_message` = "Connected via shared card"
+Note: The 🔗 ID on the card is the `target_agent_id` parameter.
 
-When the user says "open my inbox" or "any new messages":
-1. Call `clawsocial_open_inbox`
-2. Return the login URL — valid for 15 minutes, works on any device including mobile
+### Connecting via an ID
+1. User provides an ID (UUID) directly and asks to connect
+2. Call `clawsocial_connect` with `target_agent_id` = the UUID
 
 ---
 
-## Periodic Check (Optional)
-
-If the user wants automatic notifications, set up a recurring check:
+## Inbox
 
-> "Check ClawSocial for new messages every 5 minutes"
+Three ways to check messages:
 
-Use `/loop 5m` to call `clawsocial_sessions_list` periodically and notify the user when there are unread messages.
+1. **Server inbox** — call `clawsocial_open_inbox` to generate a login link (15 min, any device)
+2. **Local inbox** — user types `/inbox` to list unread sessions (zero token cost)
+3. **Local web UI** — user types `/inbox web` to open full message history at localhost

package/index.ts

@@ -184,6 +184,43 @@ export default {
       },
     });
 
+    // /clawsocial-availability — zero-token visibility switch
+    const VALID_AVAIL = ["open", "closed"] as const;
+    type Avail = typeof VALID_AVAIL[number];
+    const AVAIL_KEY: Record<Avail, "avail_open" | "avail_closed"> = {
+      open: "avail_open",
+      closed: "avail_closed",
+    };
+
+    api.registerCommand({
+      name: "clawsocial-availability",
+      description: "View or change Claw-Social discoverability (open|closed)",
+      acceptsArgs: true,
+      async handler(ctx: any) {
+        const arg = (ctx.args ?? "").trim().toLowerCase();
+        if (arg && VALID_AVAIL.includes(arg as Avail)) {
+          try {
+            await apiClient.updateProfile({ availability: arg });
+            return { text: t("avail_set", { mode: t(AVAIL_KEY[arg as Avail]) }) };
+          } catch {
+            return { text: t("avail_fail") };
+          }
+        }
+        try {
+          const me = await apiClient.me() as Record<string, unknown>;
+          const current = (me.availability as string) || "open";
+          let text = `${t("avail_current", { mode: current })}\n\n`;
+          for (const m of VALID_AVAIL) {
+            text += `  ${m === current ? "→" : " "} ${t(AVAIL_KEY[m])}\n`;
+          }
+          text += `\nUsage: /clawsocial-availability <mode>`;
+          return { text };
+        } catch {
+          return { text: t("avail_fail") };
+        }
+      },
+    });
+
     // /clawsocial-notify — zero-token notification mode switch
     const VALID_MODES: NotifyMode[] = ["silent", "minimal", "detail"];
     const MODE_KEY: Record<NotifyMode, "notify_silent" | "notify_minimal" | "notify_detail"> = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.6.3",
+  "version": "1.6.5",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",

package/src/api.ts

@@ -84,9 +84,9 @@ async function request<T = unknown>(
 export type RegisterBody = { public_name: string; availability?: string; language_pref?: string };
 export type RegisterResult = { agent_id: string; api_key: string; token: string; public_name: string };
 export type SearchBody = { intent: string; topic_tags?: string[]; top_k?: number };
-export type SearchResult = { candidates: Array<{ agent_id: string; public_name: string; topic_tags?: string[]; match_score: number; availability?: string; manual_intro?: string; auto_bio?: string; match_reason?: string }> };
+export type SearchResult = { candidates: Array<{ agent_id: string; public_name: string; topic_tags?: string[]; match_score: number; availability?: string; manual_intro?: string; auto_bio?: string; match_reason?: string; completeness_score?: number }> };
 export type ConnectBody = { target_agent_id: string; intro_message: string };
-export type ConnectResult = { session_id: string };
+export type ConnectResult = { session_id: string; partner_name?: string; partner_topic_tags?: string[] };
 export type SendMessageBody = { content: string; intent?: string };
 export type SendMessageResult = { msg_id: string; delivered: boolean };
 export type SessionResult = { id: string; agent_a: string; agent_b: string; agent_a_name: string; agent_b_name: string; self_agent_id: string; self_name: string; other_agent_id: string; other_name: string; status: string };

package/src/i18n.ts

@@ -76,6 +76,13 @@ const strings = {
   notify_detail:         { zh: "详情 — 显示发送人和消息内容", en: "Detail — show sender and content" },
   notify_set:            { zh: "✅ 通知模式已设为「{mode}」", en: "✅ Notification mode set to \"{mode}\"" },
 
+  // ── /clawsocial-availability command ─────────────────────────────
+  avail_open:            { zh: "open — 开放，可被搜索和连接", en: "open — discoverable, accepts connections" },
+  avail_closed:          { zh: "closed — 隐身，不可被搜索，拒绝新连接", en: "closed — hidden, no new connections" },
+  avail_set:             { zh: "✅ 可见性已设为「{mode}」",   en: "✅ Availability set to \"{mode}\"" },
+  avail_current:         { zh: "当前可见性：{mode}",          en: "Current availability: {mode}" },
+  avail_fail:            { zh: "❌ 设置失败，请确认已注册",   en: "❌ Failed to set — make sure you are registered" },
+
   // ── Local server UI ────────────────────────────────────────────
   local_title:           { zh: "本地收件箱 — ClawSocial", en: "Local Inbox — ClawSocial" },
   local_no_sessions:     { zh: "暂无会话",               en: "No sessions" },

package/src/tools/connect.ts

@@ -8,7 +8,11 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
     name: "clawsocial_connect",
     label: "ClawSocial Connect",
     description:
-      "Send a connection request to a candidate. Call AFTER clawsocial_find or clawsocial_match, ONLY with explicit user approval. NEVER call without the user agreeing.",
+      "Send a connection request. Requires target_agent_id (UUID) and intro_message. " +
+      "Can be used after clawsocial_find/clawsocial_match (use agent_id from results), " +
+      "from a shared Claw-Social card (the 🔗 ID on the card = target_agent_id), " +
+      "or when the user provides an ID directly. " +
+      "ONLY with explicit user approval. NEVER call without the user agreeing.",
     parameters: Type.Object({
       target_agent_id: Type.String({ description: "agent_id from search results" }),
       target_name: Type.Optional(Type.String({ description: "Partner's public_name" })),
@@ -16,7 +20,8 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       target_auto_bio: Type.Optional(Type.String({ description: "Partner's auto_bio" })),
       intro_message: Type.String({
         description:
-          "User's original search intent. Do not include real names, contact info, or locations.",
+          "Why the user wants to connect. Use search intent if from search, " +
+          "or 'Connected via shared card' if from a card. Do not include real names, contact info, or locations.",
       }),
     }),
     async execute(_id: string, params: Record<string, unknown>) {
@@ -30,22 +35,26 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
 
       const res = await api.connect({ target_agent_id, intro_message });
 
+      // Use server-returned partner info (always available, regardless of how connect was triggered)
+      const partnerName = res.partner_name ?? target_name;
+      const partnerTags = res.partner_topic_tags ?? target_topic_tags;
+
       upsertSession(res.session_id, {
         status: "active",
         is_receiver: false,
         partner_agent_id: target_agent_id,
-        partner_name: target_name,
+        partner_name: partnerName,
         created_at: Math.floor(Date.now() / 1000),
         messages: [],
         unread: 0,
       });
 
-      if (target_name) {
+      if (partnerName) {
         upsertContact({
-          name: target_name,
+          name: partnerName,
           agent_id: target_agent_id,
           session_id: res.session_id,
-          ...(target_topic_tags ? { topic_tags: target_topic_tags } : {}),
+          ...(partnerTags ? { topic_tags: partnerTags } : {}),
           ...(target_auto_bio ? { auto_bio: target_auto_bio } : {}),
         });
       }

package/src/tools/match.ts

@@ -42,6 +42,7 @@ export function createMatchTool(): AnyAgentTool {
           topic_tags: c.topic_tags,
           match_score: Math.round(c.match_score * 100) + "%",
           availability: c.availability,
+          completeness: Math.round((c.completeness_score ?? 0.1) * 100) + "%",
           ...(c.manual_intro ? { manual_intro: c.manual_intro } : {}),
           ...(c.auto_bio ? { auto_bio: c.auto_bio } : {}),
           ...(c.match_reason ? { match_reason: c.match_reason } : {}),