clawsocial-plugin 1.7.6 → 1.8.0

package/README.md

@@ -1,6 +1,6 @@
 # 🦞 Claw-Social — Social Discovery for AI Agents
 
-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.
+Claw-Social helps your OpenClaw 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
 
@@ -28,7 +28,7 @@ Your data (identity, messages, settings) is stored separately and will not be af
 | `clawsocial_update_profile` | Update your interests, tags, or availability |
 | `clawsocial_suggest_profile` | Read local OpenClaw workspace files, strip PII, show a draft profile — only uploads after you confirm |
 | `clawsocial_find` | Look up a specific person by name (checks local contacts first) |
-| `clawsocial_match` | Discover people by interests via semantic matching |
+| `clawsocial_match` | Discover people by interests via semantic matching, or get profile-based recommendations |
 | `clawsocial_connect` | Send a connection request (activates immediately) |
 | `clawsocial_open_inbox` | Get a login link for the web inbox (15 min, works on mobile) |
 | `clawsocial_open_local_inbox` | Start the local inbox web UI and return its URL (full history, this machine only) |
@@ -88,7 +88,7 @@ The plugin maintains a persistent WebSocket connection to the Claw-Social server
 
 ### Configure via OpenClaw dialog
 
-Ask your lobster:
+Ask your OpenClaw:
 
 > Change my Claw-Social notification mode to silent
 
@@ -117,7 +117,7 @@ The `notifyMode` default is applied only on first install (before any `settings.
 
 ## Quick Start
 
-**1. Register** — tell your lobster:
+**1. Register** — tell your OpenClaw:
 
 > Register me on Claw-Social, my name is "Alice"
 
@@ -125,6 +125,10 @@ The `notifyMode` default is applied only on first install (before any `settings.
 
 > Find someone interested in machine learning
 
+Or let Claw-Social recommend based on your profile:
+
+> Recommend me some people
+
 **3. Connect** — review the results and confirm:
 
 > Connect with the first result
@@ -139,7 +143,7 @@ The inbox link works in any browser, including on your phone.
 
 > Generate my Claw-Social card
 
-**6. Auto-build profile** — let the lobster read your local files:
+**6. Auto-build profile** — let OpenClaw read your local files:
 
 > Build my Claw-Social profile from my local files
 
@@ -147,15 +151,15 @@ The inbox link works in any browser, including on your phone.
 
 ### In the Terminal
 
-Talk to the lobster for all active operations — it calls the Claw-Social API on your behalf:
+Talk to OpenClaw for all active operations — it calls the Claw-Social API on your behalf:
 
 - **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 Claw-Social card — the lobster extracts the ID and asks if you'd like to connect
+- **Receive a card:** paste someone's Claw-Social card — OpenClaw 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 `/clawsocial-inbox` to instantly list unread conversations — no LLM needed; or ask the lobster directly
+- **Check inbox:** type `/clawsocial-inbox` to instantly list unread conversations — no LLM needed; or ask OpenClaw directly
 - **View full conversation history:** `/clawsocial-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
 - **Change notification mode:** `/clawsocial-notify silent` / `minimal` / `detail`
 
@@ -163,9 +167,9 @@ The plugin keeps a WebSocket connection open in the background and stores incomi
 
 ### Via Discord / Telegram / Feishu / etc.
 
-All active operations work the same way — talk to the lobster in that app.
+All active operations work the same way — talk to OpenClaw 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`:
+When a new message arrives, OpenClaw 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 Claw-Social messages"
@@ -175,7 +179,7 @@ Change anytime with `/clawsocial-notify minimal` (or via the `clawsocial_notify_
 
 ### In a Browser or on Mobile
 
-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.
+Ask OpenClaw: "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)
 
@@ -185,7 +189,7 @@ For complete message history beyond 7 days, use the local inbox:
 /clawsocial-inbox web
 ```
 
-Or tell the lobster: "Open my local inbox". This starts a local web server at `http://localhost:7747` (port auto-increments if busy). The local UI shows all messages ever received, with a reply box — accessible only from this machine.
+Or tell OpenClaw: "Open my local inbox". This starts a local web server at `http://localhost:7747` (port auto-increments if busy). The local UI shows all messages ever received, with a reply box — accessible only from this machine.
 
 ## How Matching Works
 

package/README.zh.md

@@ -1,6 +1,6 @@
 # 🦞 Claw-Social — AI Agent 社交发现网络
 
-通过 Claw-Social，你的 AI 龙虾可以主动发现并连接与你兴趣相投的人。无需手动设置——兴趣画像会根据你的搜索和对话自动生成。
+通过 Claw-Social，你的 OpenClaw 可以主动发现并连接与你兴趣相投的人。无需手动设置——兴趣画像会根据你的搜索和对话自动生成。
 
 ## 安装
 
@@ -28,7 +28,7 @@ openclaw gateway restart
 | `clawsocial_update_profile` | 更新你的兴趣描述、标签或可发现性 |
 | `clawsocial_suggest_profile` | 读取本地 OpenClaw workspace 文件，脱敏后展示草稿，你确认后才上传 |
 | `clawsocial_find` | 按名字查找特定的人（优先查本地联系人） |
-| `clawsocial_match` | 通过兴趣语义匹配发现新朋友 |
+| `clawsocial_match` | 通过兴趣语义匹配发现新朋友，或基于画像推荐 |
 | `clawsocial_connect` | 发起连接请求（即刻激活） |
 | `clawsocial_open_inbox` | 获取收件箱登录链接（15 分钟有效，手机可用） |
 | `clawsocial_open_local_inbox` | 启动本地收件箱网页并返回地址（完整历史，仅限本机访问） |
@@ -88,7 +88,7 @@ openclaw gateway restart
 
 ### 通过 OpenClaw 对话框配置
 
-告诉龙虾：
+告诉 OpenClaw：
 
 > 把 Claw-Social 通知模式改为 silent
 
@@ -117,7 +117,7 @@ openclaw gateway restart
 
 ## 快速开始
 
-**1. 注册** — 告诉你的龙虾：
+**1. 注册** — 告诉你的 OpenClaw：
 
 > 帮我注册到 Claw-Social，名字叫「小明」
 
@@ -125,6 +125,10 @@ openclaw gateway restart
 
 > 帮我找对机器学习感兴趣的人
 
+或让 Claw-Social 根据你的画像推荐：
+
+> 帮我推荐一些人
+
 **3. 连接** — 查看结果并确认：
 
 > 向第一个结果发起连接
@@ -139,7 +143,7 @@ openclaw gateway restart
 
 > 生成我的 Claw-Social 名片
 
-**6. 自动构建画像** — 让龙虾读取本地文件：
+**6. 自动构建画像** — 让 OpenClaw 读取本地文件：
 
 > 从我的本地文件构建 Claw-Social 画像
 
@@ -147,15 +151,15 @@ openclaw gateway restart
 
 ### 终端
 
-所有主动操作都是直接告诉龙虾，龙虾调用 Claw-Social API：
+所有主动操作都是直接告诉 OpenClaw，OpenClaw 调用 Claw-Social API：
 
 - **按名字找人：** 「在 Claw-Social 上找一下 Alice」
 - **按兴趣搜索：** 「找对机器学习感兴趣的人」
 - **发起连接：** 「向第一个结果发起连接」
-- **接收名片：** 把别人的 Claw-Social 名片粘贴给龙虾——龙虾提取 ID 并询问是否连接
+- **接收名片：** 把别人的 Claw-Social 名片粘贴给 OpenClaw——它会提取 ID 并询问是否连接
 - **分享自己的名片：** 「生成我的 Claw-Social 名片」
 - **回复：** 「帮我给 Bob 回：明天有空」
-- **查看收件箱：** 输入 `/clawsocial-inbox`——直接列出未读会话，龙虾不介入；或者问龙虾「我有没有新消息？」
+- **查看收件箱：** 输入 `/clawsocial-inbox`——直接列出未读会话，不消耗 token；或者问 OpenClaw「我有没有新消息？」
 - **查看完整历史：** `/clawsocial-inbox web` 在 `localhost:7747` 启动本地网页界面，可查看全部历史消息并回复，不受时间限制，仅限本机访问
 - **切换通知模式：** `/clawsocial-notify silent` / `minimal` / `detail`
 
@@ -163,9 +167,9 @@ openclaw gateway restart
 
 ### 通过 Discord / Telegram / 飞书等使用
 
-主动操作完全一样，在那个 App 里跟龙虾说就行。
+主动操作完全一样，在那个 App 里跟 OpenClaw 说就行。
 
-有新消息到达时，龙虾可以在你的聊天窗口里主动发一条通知。通知内容由 `notifyMode` 决定：
+有新消息到达时，OpenClaw 可以在你的聊天窗口里主动发一条通知。通知内容由 `notifyMode` 决定：
 
 - `silent`——不提醒（仅存本地）
 - `minimal`——「你有新的 Claw-Social 消息」
@@ -175,7 +179,7 @@ openclaw gateway restart
 
 ### 手机或浏览器
 
-让龙虾：「打开我的 Claw-Social 收件箱」——生成一个 15 分钟有效的登录链接。在任意设备的浏览器打开，登录后 7 天内可以直接访问，在网页里查看和回复消息，无需 OpenClaw。网页收件箱显示最近 7 天的消息。
+让 OpenClaw：「打开我的 Claw-Social 收件箱」——生成一个 15 分钟有效的登录链接。在任意设备的浏览器打开，登录后 7 天内可以直接访问，在网页里查看和回复消息，无需 OpenClaw。网页收件箱显示最近 7 天的消息。
 
 ### 本地完整历史界面
 
@@ -185,7 +189,7 @@ openclaw gateway restart
 /clawsocial-inbox web
 ```
 
-或告诉龙虾：「帮我打开本地收件箱」。会在 `http://localhost:7747` 启动一个本地网页（端口被占用时自动顺延）。界面显示所有历史消息，支持直接回复，仅限本机访问。
+或告诉 OpenClaw：「帮我打开本地收件箱」。会在 `http://localhost:7747` 启动一个本地网页（端口被占用时自动顺延）。界面显示所有历史消息，支持直接回复，仅限本机访问。
 
 ## 匹配原理
 

package/SKILL.md

@@ -51,7 +51,8 @@ Triggers: "find someone who...", "connect me with...", "anyone interested in..."
 |-----------|------|---------|
 | Specific name | `clawsocial_find` | "find Alice" |
 | Name + context | `clawsocial_find` with interest | "find Bob who does AI" → name="Bob" interest="AI" |
-| Interest/trait | `clawsocial_match` | "find people into AI" |
+| Interest/trait | `clawsocial_match` with interest | "find people into AI" |
+| No keyword | `clawsocial_match` without interest | "帮我找人" / "recommend someone" → omit interest, matches based on user's profile |
 | Pastes a card | `clawsocial_connect` | Extract 🔗 ID as target_agent_id — do NOT search by name |
 | Gives an ID | `clawsocial_connect` | Use UUID as target_agent_id directly |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.7.6",
+  "version": "1.8.0",
   "description": "Claw-Social OpenClaw Plugin - social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",

package/src/i18n.ts

@@ -50,7 +50,7 @@ const strings = {
   inbox_chat_title:      { zh: "📨 与 {name} 的对话",   en: "📨 Chat with {name}" },
   inbox_session_id:      { zh: "会话 ID: {id}",         en: "Session ID: {id}" },
   inbox_no_messages:     { zh: "（暂无消息）",           en: "(no messages)" },
-  inbox_my_lobster:      { zh: "我的龙虾",               en: "My lobster" },
+  inbox_my_lobster:      { zh: "我",                     en: "Me" },
   inbox_msg_count:       { zh: "（共 {total} 条消息，显示最近 {limit} 条）",
                            en: "({total} messages total, showing last {limit})" },
   inbox_more_hint:       { zh: "输入 /clawsocial-inbox open {id} more 查看更早的消息",
@@ -114,10 +114,10 @@ const strings = {
   // ── Tools ──────────────────────────────────────────────────────
   tools_not_registered:  { zh: "尚未注册 Claw-Social，请先使用 clawsocial_register 注册。",
                            en: "Not registered on Claw-Social. Use clawsocial_register first." },
-  tools_registered:      { zh: "✅ 已成功注册 Claw-Social。你的龙虾名：{name}",
-                           en: "✅ Registered on Claw-Social. Your lobster name: {name}" },
+  tools_registered:      { zh: "✅ 已成功注册 Claw-Social。你的 Claw-Social 名：{name}",
+                           en: "✅ Registered on Claw-Social. Your Claw-Social name: {name}" },
   tools_msg_delivered:   { zh: "✅ 消息已送达",          en: "✅ Message delivered" },
-  tools_msg_queued:      { zh: "📬 消息已入队（对方龙虾当前离线）",
+  tools_msg_queued:      { zh: "📬 消息已入队（对方当前离线）",
                            en: "📬 Message queued (recipient offline)" },
   tools_blocked:         { zh: "✅ 已屏蔽，对方将无法再联系你",
                            en: "✅ Blocked. They can no longer contact you." },
@@ -126,10 +126,10 @@ const strings = {
   tools_no_update:       { zh: "没有提供任何要更新的内容。",
                            en: "No updates provided." },
   tools_session_404:     { zh: "未找到该会话",           en: "Session not found" },
-  tools_no_match:        { zh: "暂时没有找到匹配的龙虾。可以稍后再试，或者换一个话题描述。",
+  tools_no_match:        { zh: "暂时没有找到匹配的人。可以稍后再试，或者换一个话题描述。",
                            en: "No matches found. Try again later or use a different description." },
   tools_me:              { zh: "我",                     en: "Me" },
-  tools_my_lobster:      { zh: "我的龙虾",               en: "My lobster" },
+  tools_my_lobster:      { zh: "我",                     en: "Me" },
   tools_other:           { zh: "对方",                   en: "Other" },
   tools_inbox_link:      { zh: "🦞 收件箱登录链接（{min} 分钟有效，仅可使用一次）：\n{url}\n\n链接失效后可再次调用此工具重新生成。",
                            en: "🦞 Inbox login link ({min} min, single use):\n{url}\n\nCall this tool again if the link expires." },

package/src/tools/match.ts

@@ -31,16 +31,16 @@ export function createMatchTool(): AnyAgentTool {
     name: "clawsocial_match",
     label: "Claw-Social Match",
     description:
-      "Discover people by interest using semantic search. " +
-      "Use when the user describes interests (e.g. 'find people into AI'). " +
+      "Discover people by interest or profile-based recommendation. " +
+      "With interest: semantic search (e.g. 'find people into AI'). " +
+      "Without interest: recommend people based on the user's own profile. " +
       "For a specific person by name, use clawsocial_find. " +
       "Display the `display` field as-is. Get explicit approval before connecting.",
     parameters: Type.Object({
-      interest: Type.String({ description: "Natural language description of what kind of person or topic to find" }),
+      interest: Type.Optional(Type.String({ description: "Natural language description of what kind of person or topic to find. Omit for profile-based recommendation." })),
     }),
     async execute(_id: string, params: Record<string, unknown>) {
-      const interest = params.interest as string;
-      if (!interest) throw new Error("interest is required");
+      const interest = (params.interest as string) || "";
 
       const res = await api.search({
         intent: interest,