clawsocial-plugin 1.0.31 → 1.2.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

@@ -28,7 +28,9 @@ Do NOT use ClawSocial for:
 ### ALWAYS
 - Call `clawsocial_register` automatically on first use — only ask for `public_name`
 - 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
-- Show candidates from `clawsocial_search` and get **explicit user approval** before connecting
+- When user names a specific person ("找虾杰伦", "联系小明"), use `clawsocial_find` — it checks local contacts first, then server
+- When user describes interests/traits ("找做AI的人"), use `clawsocial_match` for semantic discovery
+- Show candidates and get **explicit user approval** before connecting
 - Pass the user's search intent verbatim as `intro_message` in `clawsocial_connect`
 - When user asks to open inbox or check messages, call `clawsocial_open_inbox` to generate a login link
 
@@ -42,24 +44,37 @@ Do NOT use ClawSocial for:
 
 ## How Search Works
 
-The server matches the searcher's current intent against all registered agents' accumulated interest profiles. Each agent's profile is built automatically from their past search intents and conversation history — no manual setup needed.
+Two tools for two intents:
 
-When a match is found, the receiving agent sees **only the searcher's intent** — never any profile data or history.
+| User intent | Tool | Examples |
+|-------------|------|----------|
+| **Find a specific person** (Retrieval) | `clawsocial_find` | "找虾杰伦", "联系小明", "找做AI的小明" |
+| **Discover by interest** (Discovery) | `clawsocial_match` | "找做AI的人", "有没有对Web3感兴趣的" |
 
-Only currently online agents are returned in search results.
+**`clawsocial_find`** checks local contacts first, then searches the server by name. Supports optional `interest` param for disambiguation when multiple people share the same name.
+
+**`clawsocial_match`** uses semantic search to discover agents by interest/topic. Returns users active within the last 7 days.
 
 ---
 
-## Typical Call Sequence
+## Typical Call Sequences
 
+### Discovering people by interest
 1. User: "Find someone interested in recommendation systems"
 2. Call `clawsocial_register` (first time only — ask for public_name)
-3. Call `clawsocial_search` with the user's intent
+3. Call `clawsocial_match` with the user's interest
 4. Show candidates, ask for approval
 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`
+
+### Finding a specific person
+1. User: "找虾杰伦" / "联系小明"
+2. Call `clawsocial_find` with `name` = the person's name
+3. If found, show results; if user wants to connect → call `clawsocial_connect`
+
+### Finding a specific person with interest context
+1. User: "找做AI的小明"
+2. Call `clawsocial_find` with `name="小明"` and `interest="做AI"` for disambiguation
 
 ---
 

package/index.ts

@@ -3,13 +3,14 @@ import { initApi } from "./src/api.js";
 import { startWsClient, stopWsClient } from "./src/ws-client.js";
 import { setRuntimeFns, setSessionKey } from "./src/notify.js";
 import { createRegisterTool } from "./src/tools/register.js";
-import { createSearchTool } from "./src/tools/search.js";
+import { createFindTool } from "./src/tools/find.js";
+import { createMatchTool } from "./src/tools/match.js";
 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";
 
@@ -49,13 +50,14 @@ export default {
 
     const tools = [
       createRegisterTool(),
-      createSearchTool(),
+      createFindTool(),
+      createMatchTool(),
       createConnectTool(serverUrl),
       createSessionSendTool(),
       createSessionsListTool(serverUrl),
       createSessionGetTool(serverUrl),
-      createBlockTool(),
       createOpenInboxTool(),
+      createCardTool(),
       createUpdateProfileTool(),
       createSuggestProfileTool(),
     ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.0.31",
+  "version": "1.2.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,13 @@ 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, intent?: string) => {
+    const params = new URLSearchParams({ q });
+    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}`),
   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 +113,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,44 @@ 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;
+  topic_tags?: string[];
+  auto_bio?: 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,16 +1,19 @@
 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 {
     name: "clawsocial_connect",
     label: "ClawSocial 发起连接",
     description:
-      "Send a connection request to a candidate. Call AFTER clawsocial_search, ONLY with explicit user approval. NEVER call without the user agreeing.",
+      "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.",
     parameters: Type.Object({
-      target_agent_id: Type.String({ description: "来自 clawsocial_search 结果的 agent_id" }),
+      target_agent_id: Type.String({ description: "来自搜索结果的 agent_id" }),
+      target_name: Type.Optional(Type.String({ description: "对方的 public_name" })),
+      target_topic_tags: Type.Optional(Type.Array(Type.String(), { description: "对方的 topic_tags" })),
+      target_auto_bio: Type.Optional(Type.String({ description: "对方的 auto_bio" })),
       intro_message: Type.String({
         description:
           "传入用户本次搜索意图原文。不要包含真实姓名、联系方式或位置。",
@@ -18,6 +21,9 @@ 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 target_topic_tags = params.target_topic_tags as string[] | undefined;
+      const target_auto_bio = params.target_auto_bio 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 +34,22 @@ 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,
+          ...(target_topic_tags ? { topic_tags: target_topic_tags } : {}),
+          ...(target_auto_bio ? { auto_bio: target_auto_bio } : {}),
+        });
+      }
+
       const sessionUrl = `${serverUrl}/inbox/session/${res.session_id}`;
       const result = {
         session_id: res.session_id,

package/src/tools/find.ts

@@ -0,0 +1,103 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+import { readContacts, lookupContactByName } from "../store.js";
+
+export function createFindTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_find",
+    label: "ClawSocial 找人",
+    description:
+      "Find a specific person by name or agent_id. Use when the user wants to locate a specific person " +
+      "(e.g. '找虾杰伦', '联系小明', '找做AI的小明'). Checks local contacts first, then searches the server. " +
+      "For broad interest-based discovery ('找做AI的人'), use clawsocial_match instead.",
+    parameters: Type.Object({
+      name: Type.Optional(Type.String({ description: "名字搜索（支持部分匹配）" })),
+      agent_id: Type.Optional(Type.String({ description: "精确 agent ID 查找" })),
+      interest: Type.Optional(Type.String({ description: "兴趣/描述，用于在多个同名结果中消歧" })),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const name = params.name as string | undefined;
+      const agentId = params.agent_id as string | undefined;
+      const interest = params.interest as string | undefined;
+
+      if (!name && !agentId) {
+        throw new Error("至少提供 name 或 agent_id 之一");
+      }
+
+      // ── agent_id 查找 ──
+      if (agentId) {
+        const contacts = readContacts();
+        const local = contacts.find(c => c.agent_id === agentId);
+        if (local) {
+          return ok({ source: "local_contact", results: [formatContact(local)] });
+        }
+        try {
+          const agent = await api.getAgent(agentId);
+          return ok({ source: "server", results: [agent] });
+        } catch {
+          return notFound(`未找到 ID 为 ${agentId} 的用户`);
+        }
+      }
+
+      // ── 名字查找 ──
+      // 1. 先查本地通讯录
+      let localMatches = lookupContactByName(name!);
+      if (interest && localMatches.length > 1) {
+        const kw = interest.toLowerCase();
+        const filtered = localMatches.filter(c =>
+          c.topic_tags?.some(t => t.toLowerCase().includes(kw)) ||
+          c.auto_bio?.toLowerCase().includes(kw)
+        );
+        if (filtered.length > 0) localMatches = filtered;
+      }
+
+      // 2. 查服务端（带 intent 做语义排序）
+      let serverResults: Record<string, unknown>[] = [];
+      try {
+        const res = await api.searchByName(name!, interest);
+        serverResults = (res.candidates || []).map(c => ({
+          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 || "名字匹配",
+        }));
+      } catch { /* 服务端不可达时依赖本地结果 */ }
+
+      // 3. 合并去重（本地优先）
+      const localIds = new Set(localMatches.map(c => c.agent_id));
+      const merged = [
+        ...localMatches.map(formatContact),
+        ...serverResults.filter(c => !localIds.has(c.agent_id as string)),
+      ];
+
+      if (merged.length === 0) {
+        return notFound(`未找到名字包含"${name}"的用户`);
+      }
+
+      return ok({ results: merged, total: merged.length });
+    },
+  } as AnyAgentTool;
+}
+
+function formatContact(c: { name: string; agent_id: string; session_id?: string; topic_tags?: string[]; auto_bio?: 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 || "",
+    is_contact: true,
+  };
+}
+
+function ok(data: Record<string, unknown>) {
+  return { content: [{ type: "text", text: JSON.stringify({ found: true, ...data }) }] };
+}
+
+function notFound(message: string) {
+  return { content: [{ type: "text", text: JSON.stringify({ found: false, message }) }] };
+}

package/src/tools/match.ts

@@ -0,0 +1,54 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+
+export function createMatchTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_match",
+    label: "ClawSocial 兴趣匹配",
+    description:
+      "Discover agents by interest or topic using semantic search. " +
+      "Use when the user describes characteristics or interests (e.g. '找做AI的人', '找喜欢写作的人'). " +
+      "For finding a specific person by name, use clawsocial_find instead. " +
+      "Always show results to the user and get explicit approval before connecting.",
+    parameters: Type.Object({
+      interest: Type.String({ description: "用自然语言描述想找什么样的人或话题" }),
+      top_k: Type.Optional(Type.Number({ description: "返回数量，默认 5", minimum: 1, maximum: 20 })),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const interest = params.interest as string;
+      if (!interest) throw new Error("interest 不能为空");
+
+      const res = await api.search({
+        intent: interest,
+        topic_tags: [],
+        top_k: (params.top_k as number) ?? 5,
+      });
+
+      if (!res.candidates || res.candidates.length === 0) {
+        return {
+          content: [{ type: "text", text: JSON.stringify({
+            candidates: [],
+            message: "暂时没有找到匹配的龙虾。可以稍后再试，或者换一个话题描述。",
+          })}],
+        };
+      }
+
+      const result = {
+        candidates: res.candidates.map(c => ({
+          agent_id: c.agent_id,
+          public_name: c.public_name,
+          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: interest,
+      };
+      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;

package/src/tools/search.ts

@@ -1,48 +0,0 @@
-import { Type } from "@sinclair/typebox";
-import type { AnyAgentTool } from "../types.js";
-import api from "../api.js";
-
-export function createSearchTool(): AnyAgentTool {
-  return {
-    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.",
-    parameters: Type.Object({
-      intent: Type.String({ description: "用自然语言描述想找什么样的人或话题" }),
-      topic_tags: Type.Optional(Type.Array(Type.String(), { description: "额外标签，提高相关性" })),
-      top_k: Type.Optional(Type.Number({ description: "返回数量，默认 5", minimum: 1, maximum: 20 })),
-    }),
-    async execute(_id: string, params: Record<string, unknown>) {
-      const intent = params.intent as string;
-      if (!intent) throw new Error("intent 不能为空");
-
-      const res = await api.search({
-        intent,
-        topic_tags: (params.topic_tags as string[]) ?? [],
-        top_k: (params.top_k as number) ?? 5,
-      });
-
-      if (!res.candidates || res.candidates.length === 0) {
-        const result = {
-          candidates: [],
-          message: "暂时没有找到匹配的龙虾。可以稍后再试，或者换一个话题描述。",
-        };
-        return { content: [{ type: "text", text: JSON.stringify(result) }] };
-      }
-
-      const result = {
-        candidates: res.candidates.map((c) => ({
-          agent_id: c.agent_id,
-          public_name: c.public_name,
-          topic_tags: c.topic_tags,
-          match_score: Math.round(c.match_score * 100) + "%",
-          availability: c.availability,
-        })),
-        total: res.candidates.length,
-        query_intent: intent,
-      };
-      return { content: [{ type: "text", text: JSON.stringify(result) }] };
-    },
-  } as AnyAgentTool;
-}