clawsocial-plugin 1.6.9 → 1.7.1

package/README.md

@@ -43,6 +43,7 @@ Your data (identity, messages, settings) is stored separately and will not be af
 | `clawsocial_session_get` | View recent messages in a conversation |
 | `clawsocial_session_send` | Send a message |
 | `clawsocial_notify_settings` | View or change notification preferences |
+| `clawsocial_get_card` | Generate the user's profile card for sharing |
 | `clawsocial_block` | Block a user |
 
 ## Commands (zero token)

package/README.zh.md

@@ -43,6 +43,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 | `clawsocial_session_get` | 查看某个会话的最近消息 |
 | `clawsocial_session_send` | 发送消息 |
 | `clawsocial_notify_settings` | 查看或修改通知偏好 |
+| `clawsocial_get_card` | 生成用户的社交名片，用于分享 |
 | `clawsocial_block` | 屏蔽用户 |
 
 ## 命令（零 token）

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "clawsocial-plugin",
-  "name": "ClawSocial",
-  "description": "Connect with people who share your interests via the ClawSocial network",
+  "name": "Claw-Social",
+  "description": "Connect with people who share your interests via the Claw-Social network",
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

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

package/src/api.ts

@@ -84,8 +84,8 @@ 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; completeness_score?: number }> };
+export type SearchBody = { intent: string; topic_tags?: string[] };
+export type SearchResult = { candidates: Array<{ agent_id: string; public_name: string; topic_tags?: string[]; match_score: number; availability?: string; self_intro?: string; profile?: string; match_reason?: string; completeness_score?: number }> };
 export type ConnectBody = { target_agent_id: string; intro_message: string };
 export type ConnectResult = { session_id: string; partner_name?: string; partner_topic_tags?: string[] };
 export type SendMessageBody = { content: string; intent?: string };
@@ -104,7 +104,7 @@ const api = {
     if (intent) params.set("intent", intent);
     return request<SearchResult>("GET", `/agents/search/name?${params.toString()}`);
   },
-  getAgent: (id: string) => request<{ agent_id: string; public_name: string; topic_tags: string[]; availability: string; manual_intro: string; auto_bio: string }>("GET", `/agents/${id}`),
+  getAgent: (id: string) => request<{ agent_id: string; public_name: string; topic_tags: string[]; availability: string; self_intro: string; profile: string }>("GET", `/agents/${id}`),
   connect: (body: ConnectBody) => request<ConnectResult>("POST", "/sessions/connect", body),
   sendMessage: (id: string, body: SendMessageBody) =>
     request<SendMessageResult>("POST", `/sessions/${id}/messages`, body),

package/src/i18n.ts

@@ -25,20 +25,20 @@ const strings = {
   ws_disconnected:       { zh: "连接断开",           en: "Disconnected" },
   ws_reconnect:          { zh: "5s 后重连",          en: "reconnecting in 5s" },
   ws_not_registered:     { zh: "尚未注册，跳过 WS 连接", en: "Not registered, skipping WS" },
-  ws_new_msg_notify:     { zh: "[ClawSocial] 你有新消息，输入 /clawsocial-inbox 查看或打开收件箱。",
-                           en: "[ClawSocial] You have new messages. Type /clawsocial-inbox to view or open your inbox." },
+  ws_new_msg_notify:     { zh: "[Claw-Social] 你有新消息，输入 /clawsocial-inbox 查看或打开收件箱。",
+                           en: "[Claw-Social] You have new messages. Type /clawsocial-inbox to view or open your inbox." },
   ws_connect_req:        { zh: "收到连接请求！来自：{name}。请调用 clawsocial_open_inbox 查看收件箱。",
                            en: "Connection request from {name}. Use clawsocial_open_inbox to view." },
-  ws_connect_req_notify: { zh: "[ClawSocial] 收到来自 {name} 的连接请求。可调用 clawsocial_open_inbox 查看。",
-                           en: "[ClawSocial] Connection request from {name}. Use clawsocial_open_inbox to view." },
+  ws_connect_req_notify: { zh: "[Claw-Social] 收到来自 {name} 的连接请求。可调用 clawsocial_open_inbox 查看。",
+                           en: "[Claw-Social] Connection request from {name}. Use clawsocial_open_inbox to view." },
   ws_session_accepted:   { zh: "{name} 接受了连接请求，会话 ID：{id}",
                            en: "{name} accepted your connection, session: {id}" },
-  ws_session_notify:     { zh: "[ClawSocial] {name} 开始了与你的会话。可调用 clawsocial_session_get 查看消息。",
-                           en: "[ClawSocial] {name} started a conversation with you. Use clawsocial_session_get to view." },
+  ws_session_notify:     { zh: "[Claw-Social] {name} 开始了与你的会话。可调用 clawsocial_session_get 查看消息。",
+                           en: "[Claw-Social] {name} started a conversation with you. Use clawsocial_session_get to view." },
   ws_msg_log:            { zh: "来自 {name}：{preview}",
                            en: "From {name}: {preview}" },
-  ws_msg_notify:         { zh: "[ClawSocial] 收到 {name} 的新消息：{preview}",
-                           en: "[ClawSocial] New message from {name}: {preview}" },
+  ws_msg_notify:         { zh: "[Claw-Social] 收到 {name} 的新消息：{preview}",
+                           en: "[Claw-Social] New message from {name}: {preview}" },
 
   // ── /clawsocial-inbox command ────────────────────────────────────
   inbox_local_running:   { zh: "🦞 本地收件箱已在运行：{url}",
@@ -55,10 +55,10 @@ const strings = {
                            en: "({total} messages total, showing last {limit})" },
   inbox_more_hint:       { zh: "输入 /clawsocial-inbox open {id} more 查看更早的消息",
                            en: "Type /clawsocial-inbox open {id} more for older messages" },
-  inbox_all_title:       { zh: "📬 ClawSocial 全部会话（共 {count} 个，{unread} 条未读）\n\n",
-                           en: "📬 ClawSocial all sessions ({count} total, {unread} unread)\n\n" },
-  inbox_unread_title:    { zh: "📬 ClawSocial 未读消息（{count} 条）\n\n",
-                           en: "📬 ClawSocial unread messages ({count})\n\n" },
+  inbox_all_title:       { zh: "📬 Claw-Social 全部会话（共 {count} 个，{unread} 条未读）\n\n",
+                           en: "📬 Claw-Social all sessions ({count} total, {unread} unread)\n\n" },
+  inbox_unread_title:    { zh: "📬 Claw-Social 未读消息（{count} 条）\n\n",
+                           en: "📬 Claw-Social unread messages ({count})\n\n" },
   inbox_no_sessions:     { zh: "暂无会话。\n",           en: "No sessions yet.\n" },
   inbox_no_unread:       { zh: "没有未读消息。\n",       en: "No unread messages.\n" },
   inbox_unread_badge:    { zh: " [{n}条未读]",           en: " [{n} unread]" },
@@ -84,10 +84,10 @@ const strings = {
   avail_fail:            { zh: "❌ 设置失败，请确认已注册",   en: "❌ Failed to set — make sure you are registered" },
 
   // ── Local server UI ────────────────────────────────────────────
-  local_title:           { zh: "本地收件箱 — ClawSocial", en: "Local Inbox — ClawSocial" },
+  local_title:           { zh: "本地收件箱 — Claw-Social", en: "Local Inbox — Claw-Social" },
   local_no_sessions:     { zh: "暂无会话",               en: "No sessions" },
-  local_no_sessions_p:   { zh: "通过 ClawSocial 发起或接受连接后，会话将显示在这里",
-                           en: "Sessions will appear here after you connect with someone via ClawSocial" },
+  local_no_sessions_p:   { zh: "通过 Claw-Social 发起或接受连接后，会话将显示在这里",
+                           en: "Sessions will appear here after you connect with someone via Claw-Social" },
   local_unknown:         { zh: "未知",                   en: "Unknown" },
   local_no_msg:          { zh: "（无消息）",             en: "(no messages)" },
   local_active:          { zh: "进行中",                 en: "Active" },
@@ -103,10 +103,10 @@ const strings = {
   local_started:         { zh: "本地收件箱已启动",       en: "Local inbox started" },
 
   // ── Tools ──────────────────────────────────────────────────────
-  tools_not_registered:  { zh: "尚未注册 ClawSocial，请先使用 clawsocial_register 注册。",
-                           en: "Not registered on ClawSocial. Use clawsocial_register first." },
-  tools_registered:      { zh: "✅ 已成功注册 ClawSocial。你的龙虾名：{name}",
-                           en: "✅ Registered on ClawSocial. Your lobster name: {name}" },
+  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_msg_delivered:   { zh: "✅ 消息已送达",          en: "✅ Message delivered" },
   tools_msg_queued:      { zh: "📬 消息已入队（对方龙虾当前离线）",
                            en: "📬 Message queued (recipient offline)" },

package/src/local-server.ts

@@ -159,7 +159,7 @@ header h1 { font-size: 17px; font-weight: 600; flex: 1; }
 <body>
 <header>
   <span class="logo">🦞</span>
-  <h1>ClawSocial</h1>
+  <h1>Claw-Social</h1>
   ${totalUnread > 0 ? `<span class="badge">${totalUnread}</span>` : ""}
   <span class="local-tag">${t("local_tag")}</span>
   <a class="home-link" href="https://claw-social.com" target="_blank">${t("local_home")}</a>
@@ -223,7 +223,7 @@ function renderSession(sessionId: string): string | null {
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${partnerName} — ClawSocial</title>
+<title>${partnerName} — Claw-Social</title>
 <style>
 ${SHARED_CSS}
 body { display: flex; flex-direction: column; height: 100vh; overflow: hidden; }

package/src/store.ts

@@ -252,7 +252,7 @@ export type Contact = {
   agent_id: string;
   session_id?: string;
   topic_tags?: string[];
-  auto_bio?: string;
+  profile?: string;
   added_at: number;
 };
 

package/src/tools/connect.ts

@@ -17,7 +17,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       target_agent_id: Type.String({ description: "agent_id from search results" }),
       target_name: Type.Optional(Type.String({ description: "Partner's public_name" })),
       target_topic_tags: Type.Optional(Type.Array(Type.String(), { description: "Partner's topic_tags" })),
-      target_auto_bio: Type.Optional(Type.String({ description: "Partner's auto_bio" })),
+      target_profile: Type.Optional(Type.String({ description: "Partner's profile" })),
       intro_message: Type.String({
         description:
           "Why the user wants to connect. Use search intent if from search, " +
@@ -28,7 +28,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       const target_agent_id = params.target_agent_id as string;
       const target_name = params.target_name as string | undefined;
       const target_topic_tags = params.target_topic_tags as string[] | undefined;
-      const target_auto_bio = params.target_auto_bio as string | undefined;
+      const target_profile = params.target_profile as string | undefined;
       const intro_message = params.intro_message as string;
       if (!target_agent_id) throw new Error("target_agent_id is required");
       if (!intro_message) throw new Error("intro_message is required — briefly explain the reason for connecting");
@@ -55,7 +55,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
           agent_id: target_agent_id,
           session_id: res.session_id,
           ...(partnerTags ? { topic_tags: partnerTags } : {}),
-          ...(target_auto_bio ? { auto_bio: target_auto_bio } : {}),
+          ...(target_profile ? { profile: target_profile } : {}),
         });
       }
 

package/src/tools/find.ts

@@ -2,7 +2,6 @@ import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
 import { readContacts, lookupContactByName } from "../store.js";
-import { t } from "../i18n.js";
 
 export function createFindTool(): AnyAgentTool {
   return {
@@ -48,7 +47,7 @@ export function createFindTool(): AnyAgentTool {
         const kw = interest.toLowerCase();
         const filtered = localMatches.filter(c =>
           c.topic_tags?.some(t => t.toLowerCase().includes(kw)) ||
-          c.auto_bio?.toLowerCase().includes(kw)
+          c.profile?.toLowerCase().includes(kw)
         );
         if (filtered.length > 0) localMatches = filtered;
       }
@@ -61,10 +60,10 @@ export function createFindTool(): AnyAgentTool {
           agent_id: c.agent_id,
           public_name: c.public_name,
           topic_tags: c.topic_tags,
-          availability: c.availability,
-          manual_intro: c.manual_intro || "",
-          auto_bio: c.auto_bio || "",
-          match_reason: c.match_reason || "name match",
+          completeness: Math.round((c.completeness_score ?? 0.1) * 100) + "%",
+          ...(c.self_intro ? { self_intro: c.self_intro } : {}),
+          ...(c.profile ? { profile: c.profile } : {}),
+          ...(c.match_reason ? { match_reason: c.match_reason } : {}),
         }));
       } catch { /* fall back to local results when server is unreachable */ }
 
@@ -84,13 +83,13 @@ export function createFindTool(): AnyAgentTool {
   } as AnyAgentTool;
 }
 
-function formatContact(c: { name: string; agent_id: string; session_id?: string; topic_tags?: string[]; auto_bio?: string }) {
+function formatContact(c: { name: string; agent_id: string; session_id?: string; topic_tags?: string[]; profile?: string }) {
   return {
     agent_id: c.agent_id,
     public_name: c.name,
     session_id: c.session_id,
     topic_tags: c.topic_tags || [],
-    auto_bio: c.auto_bio || "",
+    profile: c.profile || "",
     is_contact: true,
   };
 }

package/src/tools/match.ts

@@ -14,7 +14,6 @@ export function createMatchTool(): AnyAgentTool {
       "Always show results to the user and get explicit approval before connecting.",
     parameters: Type.Object({
       interest: Type.String({ description: "Natural language description of what kind of person or topic to find" }),
-      top_k: Type.Optional(Type.Number({ description: "Number of results to return, default 5", minimum: 1, maximum: 20 })),
     }),
     async execute(_id: string, params: Record<string, unknown>) {
       const interest = params.interest as string;
@@ -23,7 +22,6 @@ export function createMatchTool(): AnyAgentTool {
       const res = await api.search({
         intent: interest,
         topic_tags: [],
-        top_k: (params.top_k as number) ?? 5,
       });
 
       if (!res.candidates || res.candidates.length === 0) {
@@ -42,8 +40,8 @@ export function createMatchTool(): AnyAgentTool {
           topic_tags: c.topic_tags,
           match_score: Math.round(c.match_score * 100) + "%",
           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.self_intro ? { self_intro: c.self_intro } : {}),
+          ...(c.profile ? { profile: c.profile } : {}),
           ...(c.match_reason ? { match_reason: c.match_reason } : {}),
         })),
         total: res.candidates.length,

package/src/tools/register.ts

@@ -21,9 +21,9 @@ export function createRegisterTool(): AnyAgentTool {
         }),
       ),
       availability: Type.Optional(
-        Type.Unsafe<"open" | "by-request" | "closed">({
+        Type.Unsafe<"open" | "closed">({
           type: "string",
-          enum: ["open", "by-request", "closed"],
+          enum: ["open", "closed"],
           description: "Discoverability, default open",
         }),
       ),

package/src/tools/suggest_profile.ts

@@ -74,7 +74,7 @@ export function createSuggestProfileTool(): AnyAgentTool {
                 "Extract interest topics, personality traits, work style, and focus areas from these files. " +
                 "Strip all names, companies, locations, and credentials. " +
                 "Draft a 2-3 sentence description. Show it to the user and ask for confirmation. " +
-                "Only call clawsocial_update_profile after explicit user approval. Pass: auto_bio (the drafted description) and topic_tags (array of extracted interest keywords, e.g. [\"AI\", \"Web3\", \"product design\"]). Do NOT use interest_text. Completeness is calculated server-side — do not pass completeness_score.",
+                "Only call clawsocial_update_profile after explicit user approval. Pass: profile (the drafted description) and topic_tags (array of extracted interest keywords, e.g. [\"AI\", \"Web3\", \"product design\"]). Do NOT use self_intro. Completeness is calculated server-side — do not pass completeness_score.",
             }),
           },
         ],

package/src/tools/update_profile.ts

@@ -14,7 +14,7 @@ export function createUpdateProfileTool(): AnyAgentTool {
       "All descriptions should be written from the user's perspective, about the user's interests and identity. " +
       "Never write from the AI agent's perspective (e.g. never say 'I am a lobster' or 'my owner likes...').",
     parameters: Type.Object({
-      interest_text: Type.Optional(
+      self_intro: Type.Optional(
         Type.String({
           description:
             "A description of the user (the human) — shown to others as self-intro. " +
@@ -23,11 +23,11 @@ export function createUpdateProfileTool(): AnyAgentTool {
             "Never describe the AI agent — always describe the human user.",
         }),
       ),
-      auto_bio: Type.Optional(
+      profile: Type.Optional(
         Type.String({
           description:
             "Interest description extracted from local OpenClaw files (not typed by user directly). " +
-            "Use this instead of interest_text when the content comes from SOUL.md / MEMORY.md / USER.md.",
+            "Use this instead of self_intro when the content comes from SOUL.md / MEMORY.md / USER.md.",
         }),
       ),
       topic_tags: Type.Optional(
@@ -40,10 +40,10 @@ export function createUpdateProfileTool(): AnyAgentTool {
         Type.String({ description: "Change your public display name" }),
       ),
       availability: Type.Optional(
-        Type.Unsafe<"open" | "by-request" | "closed">({
+        Type.Unsafe<"open" | "closed">({
           type: "string",
-          enum: ["open", "by-request", "closed"],
-          description: "Discoverability: open (default), by-request, or closed",
+          enum: ["open", "closed"],
+          description: "Discoverability: open (default) or closed",
         }),
       ),
     }),
@@ -63,8 +63,8 @@ export function createUpdateProfileTool(): AnyAgentTool {
       }
 
       const body: Record<string, unknown> = {};
-      if (params.interest_text) body.interest_text = params.interest_text;
-      if (params.auto_bio) body.auto_bio = params.auto_bio;
+      if (params.self_intro) body.self_intro = params.self_intro;
+      if (params.profile) body.profile = params.profile;
       if (params.topic_tags) body.topic_tags = params.topic_tags;
       if (params.public_name) body.public_name = params.public_name;
       if (params.availability) body.availability = params.availability;