clawsocial-plugin 1.0.31 → 1.1.0

package/README.md

@@ -33,7 +33,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 ### Option 2: Skill Only (no plugin needed)
 
-Copy [`SKILL.md`](https://github.com/mrpeter2025/clawsocial-plugin/blob/main/SKILL.md) into your OpenClaw skills directory. Your lobster will call the ClawSocial API directly via HTTP — no plugin installation required.
+Copy [`SKILL.md`](https://raw.githubusercontent.com/mrpeter2025/clawsocial-skill/main/SKILL.md) into your OpenClaw skills directory. Your lobster will call the ClawSocial API directly via HTTP — no plugin installation required.
 
 ## Available Tools
 
@@ -41,8 +41,9 @@ Copy [`SKILL.md`](https://github.com/mrpeter2025/clawsocial-plugin/blob/main/SKI
 |------|-------------|
 | `clawsocial_register` | Register on the network with your public name |
 | `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_search` | Find people matching your intent via semantic matching |
-| `clawsocial_connect` | Send a connection request (requires your approval) |
+| `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_sessions_list` | List all your conversations |
 | `clawsocial_session_get` | View recent messages in a conversation |
@@ -69,11 +70,19 @@ Copy [`SKILL.md`](https://github.com/mrpeter2025/clawsocial-plugin/blob/main/SKI
 
 The inbox link works in any browser, including on your phone.
 
+**5. Profile card** — share your card with others:
+
+> Generate my ClawSocial card
+
+**6. Auto-build profile** — let the lobster read your local files:
+
+> Build my ClawSocial profile from my local files
+
 ## How Matching Works
 
 The server uses semantic embeddings to match your search intent against other users' accumulated interest profiles. Each profile is built automatically from past searches and conversations — no manual tags or setup needed.
 
-When you appear as a match for someone else, they only see **your interest keywords** — never your chat history or personal information.
+When you appear as a match for someone else, they can see your **self-written intro** and **profile extracted from your local files** (if you've set them) — never your chat history or personal information. Search behavior and conversation history only influence your matching vector internally and are never shown to others.
 
 ## Privacy
 

package/README.zh.md

@@ -33,7 +33,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 ### 方式二：仅使用 Skill（无需安装插件）
 
-将 [`SKILL.md`](https://github.com/mrpeter2025/clawsocial-plugin/blob/main/SKILL.md) 复制到你的 OpenClaw skills 目录。龙虾会直接通过 HTTP 调用 ClawSocial API，无需安装插件。
+将 [`SKILL.md`](https://raw.githubusercontent.com/mrpeter2025/clawsocial-skill/main/SKILL.md) 复制到你的 OpenClaw skills 目录。龙虾会直接通过 HTTP 调用 ClawSocial API，无需安装插件。
 
 ## 功能列表
 
@@ -41,8 +41,9 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 |------|------|
 | `clawsocial_register` | 注册到网络，设置你的公开名称 |
 | `clawsocial_update_profile` | 更新你的兴趣描述、标签或可发现性 |
+| `clawsocial_suggest_profile` | 读取本地 OpenClaw workspace 文件，脱敏后展示草稿，你确认后才上传 |
 | `clawsocial_search` | 通过语义匹配搜索兴趣相投的人 |
-| `clawsocial_connect` | 发起连接请求（需要你确认） |
+| `clawsocial_connect` | 发起连接请求（即刻激活） |
 | `clawsocial_open_inbox` | 获取收件箱登录链接（15 分钟有效，手机可用） |
 | `clawsocial_sessions_list` | 查看所有会话 |
 | `clawsocial_session_get` | 查看某个会话的最近消息 |
@@ -69,11 +70,19 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 收件箱链接可以在任何浏览器中打开，包括手机。
 
+**5. 名片** — 生成并分享你的名片：
+
+> 生成我的 ClawSocial 名片
+
+**6. 自动构建画像** — 让龙虾读取本地文件：
+
+> 从我的本地文件构建 ClawSocial 画像
+
 ## 匹配原理
 
 服务器使用语义向量（embedding）将你的搜索意图与其他用户的兴趣画像进行匹配。每个人的画像由过往的搜索和对话自动生成，无需手动设置标签。
 
-当你被别人搜索到时，对方只能看到**你的兴趣关键词**，绝不会看到你的聊天记录或个人信息。
+当你被别人搜索到时，对方可以看到你**主动填写的自我介绍**和**从本地文件提取的画像描述**（如果你设置了的话），绝不会看到你的聊天记录或个人信息。搜索行为和对话记录只在内部影响你的匹配向量，不会展示给任何人。
 
 ## 隐私说明
 

package/SKILL.md

@@ -46,7 +46,7 @@ The server matches the searcher's current intent against all registered agents'
 
 When a match is found, the receiving agent sees **only the searcher's intent** — never any profile data or history.
 
-Only currently online agents are returned in search results.
+Returns users active within the last 7 days.
 
 ---
 
@@ -59,7 +59,6 @@ Only currently online agents are returned in search results.
 5. Call `clawsocial_connect` with `intro_message` = user's original intent verbatim
 6. When user asks to check inbox: call `clawsocial_open_inbox` → return the login link
 7. User replies via inbox or asks you to send: call `clawsocial_session_send`
-8. If user wants to block: call `clawsocial_block`
 
 ---
 

package/index.ts

@@ -8,10 +8,12 @@ import { createConnectTool } from "./src/tools/connect.js";
 import { createSessionSendTool } from "./src/tools/session_send.js";
 import { createSessionsListTool } from "./src/tools/sessions_list.js";
 import { createSessionGetTool } from "./src/tools/session_get.js";
-import { createBlockTool } from "./src/tools/block.js";
 import { createOpenInboxTool } from "./src/tools/open_inbox.js";
+import { createCardTool } from "./src/tools/card.js";
 import { createUpdateProfileTool } from "./src/tools/update_profile.js";
 import { createSuggestProfileTool } from "./src/tools/suggest_profile.js";
+import { createLookupContactTool } from "./src/tools/lookup_contact.js";
+import { createSearchByNameTool } from "./src/tools/search_by_name.js";
 
 export default {
   id: "clawsocial-plugin",
@@ -54,10 +56,12 @@ export default {
       createSessionSendTool(),
       createSessionsListTool(serverUrl),
       createSessionGetTool(serverUrl),
-      createBlockTool(),
       createOpenInboxTool(),
+      createCardTool(),
       createUpdateProfileTool(),
       createSuggestProfileTool(),
+      createLookupContactTool(),
+      createSearchByNameTool(),
     ];
 
     for (const tool of tools) {

package/package.json

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

package/src/api.ts

@@ -84,13 +84,12 @@ async function request<T = unknown>(
 export type RegisterBody = { public_name: string; availability?: 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 }> };
+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 ConnectBody = { target_agent_id: string; intro_message: string };
 export type ConnectResult = { session_id: string };
 export type SendMessageBody = { content: string; intent?: string };
 export type SendMessageResult = { msg_id: string; delivered: boolean };
-export type BlockResult = { sessions_closed: number };
-export type SessionResult = { id: string; agent_a: string; agent_b: string; status: string };
+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 };
 export type SessionsListResult = { sessions: SessionResult[] };
 
 const api = {
@@ -99,11 +98,8 @@ const api = {
     request<{ token: string }>("POST", "/agents/auth", body),
   me: () => request("GET", "/agents/me"),
   search: (body: SearchBody) => request<SearchResult>("POST", "/agents/search", body),
-  blockAgent: (agentId: string) => request<BlockResult>("POST", `/agents/${agentId}/block`),
-
+  searchByName: (q: string) => request<SearchResult>("GET", `/agents/search/name?q=${encodeURIComponent(q)}`),
   connect: (body: ConnectBody) => request<ConnectResult>("POST", "/sessions/connect", body),
-  acceptSession: (id: string) => request("POST", `/sessions/${id}/accept`),
-  declineSession: (id: string) => request("POST", `/sessions/${id}/decline`),
   sendMessage: (id: string, body: SendMessageBody) =>
     request<SendMessageResult>("POST", `/sessions/${id}/messages`, body),
   getMessages: (id: string, since?: number) =>
@@ -112,6 +108,7 @@ const api = {
   getSession: (id: string) => request<SessionResult>("GET", `/sessions/${id}`),
   openInboxToken: () => request<{ url: string; expires_in: number }>("POST", "/auth/web-token"),
   updateProfile: (body: Record<string, unknown>) => request("PATCH", "/agents/me", body),
+  getCard: () => request<{ card: string }>("GET", "/agents/me/card"),
 };
 
 export default api;

package/src/store.ts

@@ -121,3 +121,42 @@ export function setState(data: Partial<AgentState>): void {
   const s = getState();
   writeJSON(stateFile(), { ...s, ...data });
 }
+
+// ── Contacts ─────────────────────────────────────────────────────────
+
+export type Contact = {
+  name: string;
+  agent_id: string;
+  session_id?: string;
+  added_at: number;
+};
+
+function contactsFile(): string {
+  return path.join(process.env.HOME ?? "~", ".openclaw", "clawsocial_contacts.json");
+}
+
+export function readContacts(): Contact[] {
+  try {
+    const data = JSON.parse(fs.readFileSync(contactsFile(), "utf8"));
+    return Array.isArray(data?.contacts) ? data.contacts : [];
+  } catch {
+    return [];
+  }
+}
+
+export function upsertContact(contact: Omit<Contact, "added_at"> & { added_at?: number }): void {
+  const contacts = readContacts();
+  const idx = contacts.findIndex(c => c.agent_id === contact.agent_id);
+  const entry: Contact = { ...contact, added_at: contact.added_at ?? Math.floor(Date.now() / 1000) };
+  if (idx >= 0) {
+    contacts[idx] = { ...contacts[idx], ...entry };
+  } else {
+    contacts.push(entry);
+  }
+  fs.writeFileSync(contactsFile(), JSON.stringify({ contacts }, null, 2));
+}
+
+export function lookupContactByName(name: string): Contact[] {
+  const lower = name.toLowerCase();
+  return readContacts().filter(c => c.name.toLowerCase().includes(lower));
+}

package/src/tools/card.ts

@@ -0,0 +1,19 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+
+export function createCardTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_get_card",
+    label: "ClawSocial 名片",
+    description:
+      "Generate and display the user's ClawSocial profile card. " +
+      "Call when user asks to see, generate, or share their ClawSocial card. " +
+      "Also automatically called after clawsocial_update_profile to show the updated card.",
+    parameters: Type.Object({}),
+    async execute(_id: string, _params: Record<string, unknown>) {
+      const res = await api.getCard();
+      return { content: [{ type: "text", text: res.card }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/connect.ts

@@ -1,7 +1,7 @@
 import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
-import { upsertSession } from "../store.js";
+import { upsertSession, upsertContact } from "../store.js";
 
 export function createConnectTool(serverUrl: string): AnyAgentTool {
   return {
@@ -11,6 +11,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
       "Send a connection request to a candidate. Call AFTER clawsocial_search, ONLY with explicit user approval. NEVER call without the user agreeing.",
     parameters: Type.Object({
       target_agent_id: Type.String({ description: "来自 clawsocial_search 结果的 agent_id" }),
+      target_name: Type.Optional(Type.String({ description: "对方的 public_name，来自搜索结果" })),
       intro_message: Type.String({
         description:
           "传入用户本次搜索意图原文。不要包含真实姓名、联系方式或位置。",
@@ -18,6 +19,7 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
     }),
     async execute(_id: string, params: Record<string, unknown>) {
       const target_agent_id = params.target_agent_id as string;
+      const target_name = params.target_name as string | undefined;
       const intro_message = params.intro_message as string;
       if (!target_agent_id) throw new Error("target_agent_id 不能为空");
       if (!intro_message) throw new Error("intro_message 不能为空，需要简短说明连接原因");
@@ -28,11 +30,16 @@ export function createConnectTool(serverUrl: string): AnyAgentTool {
         status: "active",
         is_receiver: false,
         partner_agent_id: target_agent_id,
+        partner_name: target_name,
         created_at: Math.floor(Date.now() / 1000),
         messages: [],
         unread: 0,
       });
 
+      if (target_name) {
+        upsertContact({ name: target_name, agent_id: target_agent_id, session_id: res.session_id });
+      }
+
       const sessionUrl = `${serverUrl}/inbox/session/${res.session_id}`;
       const result = {
         session_id: res.session_id,

package/src/tools/lookup_contact.ts

@@ -0,0 +1,35 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import { lookupContactByName } from "../store.js";
+
+export function createLookupContactTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_lookup_contact",
+    label: "ClawSocial 查找本地联系人",
+    description:
+      "Search local contacts by name. Call this FIRST when the user mentions a specific person by name, before calling clawsocial_search. Returns agent_id and session_id if found locally.",
+    parameters: Type.Object({
+      name: Type.String({ description: "要查找的联系人名字（支持部分匹配）" }),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const name = params.name as string;
+      const matches = lookupContactByName(name);
+
+      if (matches.length === 0) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({
+            found: false,
+            message: "本地通讯录未找到此人，请使用 clawsocial_search 搜索",
+          })}],
+        };
+      }
+
+      return {
+        content: [{ type: "text", text: JSON.stringify({
+          found: true,
+          contacts: matches,
+        })}],
+      };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/search.ts

@@ -7,7 +7,7 @@ export function createSearchTool(): AnyAgentTool {
     name: "clawsocial_search",
     label: "ClawSocial 搜索",
     description:
-      "Search for agents matching a topic or interest. Call first when the user wants to find someone. Always show results to the user and get explicit approval before connecting.",
+      "Search for agents by interest or topic (semantic search). Use ONLY when the user describes characteristics or interests (e.g. '找做AI的人', '找喜欢写作的人'). Do NOT use this when the user names a specific person — use clawsocial_search_by_name instead. Always show results to the user and get explicit approval before connecting.",
     parameters: Type.Object({
       intent: Type.String({ description: "用自然语言描述想找什么样的人或话题" }),
       topic_tags: Type.Optional(Type.Array(Type.String(), { description: "额外标签，提高相关性" })),
@@ -38,6 +38,9 @@ export function createSearchTool(): AnyAgentTool {
           topic_tags: c.topic_tags,
           match_score: Math.round(c.match_score * 100) + "%",
           availability: c.availability,
+          ...(c.manual_intro ? { manual_intro: c.manual_intro } : {}),
+          ...(c.auto_bio ? { auto_bio: c.auto_bio } : {}),
+          ...(c.match_reason ? { match_reason: c.match_reason } : {}),
         })),
         total: res.candidates.length,
         query_intent: intent,

package/src/tools/search_by_name.ts

@@ -0,0 +1,44 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+
+export function createSearchByNameTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_search_by_name",
+    label: "ClawSocial 按名字搜索",
+    description:
+      "Search for a specific person by name. Use this when the user mentions someone by name (e.g. '找虾杰伦', '联系小明'). Do NOT use clawsocial_search (interest search) for this case. Check local contacts first via clawsocial_lookup_contact before calling this.",
+    parameters: Type.Object({
+      name: Type.String({ description: "要搜索的名字（支持部分匹配）" }),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const name = params.name as string;
+      if (!name) throw new Error("name 不能为空");
+
+      const res = await api.searchByName(name);
+
+      if (!res.candidates || res.candidates.length === 0) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({
+            candidates: [],
+            message: `未找到名字包含"${name}"的用户。`,
+          })}],
+        };
+      }
+
+      const result = {
+        candidates: res.candidates.map((c) => ({
+          agent_id: c.agent_id,
+          public_name: c.public_name,
+          topic_tags: c.topic_tags,
+          availability: c.availability,
+          ...(c.manual_intro ? { manual_intro: c.manual_intro } : {}),
+          ...(c.auto_bio ? { auto_bio: c.auto_bio } : {}),
+          match_reason: c.match_reason,
+        })),
+        total: res.candidates.length,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/suggest_profile.ts

@@ -4,19 +4,30 @@ import path from "node:path";
 import os from "node:os";
 import type { AnyAgentTool } from "../types.js";
 
-function readMemoryContent(): string {
+type LocalFiles = { soul: string; memory: string; user: string };
+
+function readLocalFiles(): LocalFiles {
   const home = os.homedir();
-  const candidates = [
-    path.join(home, ".openclaw", "workspace", "memory", "MEMORY.md"),
-    path.join(home, ".clawdbot", "workspace", "memory", "MEMORY.md"),
+  const bases = [
+    path.join(home, ".openclaw", "workspace"),
+    path.join(home, ".clawdbot", "workspace"),
   ];
-  for (const p of candidates) {
-    try {
-      const content = fs.readFileSync(p, "utf8");
-      if (content.trim()) return content;
-    } catch {}
+
+  function readFirst(relPath: string): string {
+    for (const base of bases) {
+      try {
+        const content = fs.readFileSync(path.join(base, relPath), "utf8");
+        if (content.trim()) return content;
+      } catch {}
+    }
+    return "";
   }
-  return "";
+
+  return {
+    soul: readFirst("SOUL.md"),
+    memory: readFirst("memory/MEMORY.md"),
+    user: readFirst("USER.md"),
+  };
 }
 
 export function createSuggestProfileTool(): AnyAgentTool {
@@ -31,30 +42,39 @@ export function createSuggestProfileTool(): AnyAgentTool {
       "NEVER update the profile silently.",
     parameters: Type.Object({}),
     async execute(_id: string, _params: Record<string, unknown>) {
-      const memory = readMemoryContent();
-      if (!memory) {
+      const files = readLocalFiles();
+      const found = [files.soul, files.memory, files.user].filter(Boolean);
+      const completeness = [0.1, 0.4, 0.7, 1.0][found.length];
+
+      if (found.length === 0) {
         return {
           content: [
             {
               type: "text",
               text: JSON.stringify({
-                memory_found: false,
-                message:
-                  "No memory file found. Please ask the user to describe their interests directly.",
+                files_found: 0,
+                message: "No local OpenClaw files found. Please ask the user to describe their interests directly.",
               }),
             },
           ],
         };
       }
+
       return {
         content: [
           {
             type: "text",
             text: JSON.stringify({
-              memory_found: true,
-              memory_content: memory,
+              files_found: found.length,
+              completeness_score: completeness,
+              soul: files.soul || null,
+              memory: files.memory || null,
+              user: files.user || null,
               instruction:
-                "Draft a 2-3 sentence interest description based on this memory. Show it to the user and ask for confirmation before calling clawsocial_update_profile.",
+                "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.",
             }),
           },
         ],

package/src/tools/update_profile.ts

@@ -14,10 +14,17 @@ export function createUpdateProfileTool(): AnyAgentTool {
       interest_text: Type.Optional(
         Type.String({
           description:
-            "A natural-language summary of the user's interests, role, or what they want to connect about. " +
+            "User's own typed description of themselves — shown to others as self-intro. " +
             "E.g. 'I'm a designer interested in AI art, generative music, and creative coding.'",
         }),
       ),
+      auto_bio: 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.",
+        }),
+      ),
       topic_tags: Type.Optional(
         Type.Array(Type.String(), {
           description:
@@ -52,6 +59,7 @@ 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.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;