clawsocial-plugin 1.6.4 → 1.6.6

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/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.4",
+  "version": "1.6.6",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",

package/src/api.ts

@@ -84,7 +84,7 @@ 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; partner_name?: string; partner_topic_tags?: string[] };
 export type SendMessageBody = { content: string; intent?: 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/store.ts

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 
 let _stateDir: string | null = null;
@@ -137,15 +138,59 @@ export function markRead(sessionId: string): void {
   }
 }
 
+// ── Credential backup (survives plugin/OpenClaw reinstall) ──────────
+
+function credentialBackupFile(): string {
+  return path.join(os.homedir(), ".clawsocial", "credentials.json");
+}
+
+function backupCredentials(state: AgentState): void {
+  if (!state.agent_id || !state.api_key) return;
+  try {
+    const dir = path.dirname(credentialBackupFile());
+    fs.mkdirSync(dir, { recursive: true });
+    writeJSON(credentialBackupFile(), {
+      agent_id: state.agent_id,
+      api_key: state.api_key,
+      public_name: state.public_name,
+      lang: state.lang,
+    });
+  } catch {
+    // best-effort backup, don't fail if write fails
+  }
+}
+
+function restoreCredentials(): AgentState | null {
+  try {
+    const backup = readJSON<AgentState>(credentialBackupFile(), {});
+    if (backup.agent_id && backup.api_key) return backup;
+  } catch {
+    // no backup available
+  }
+  return null;
+}
+
 // ── Agent state ─────────────────────────────────────────────────────
 
 export function getState(): AgentState {
-  return readJSON<AgentState>(stateFile(), {});
+  const state = readJSON<AgentState>(stateFile(), {});
+  // If state is empty (e.g. after reinstall), try restoring from backup
+  if (!state.agent_id || !state.api_key) {
+    const backup = restoreCredentials();
+    if (backup) {
+      writeJSON(stateFile(), backup);
+      return backup;
+    }
+  }
+  return state;
 }
 
 export function setState(data: Partial<AgentState>): void {
   const s = getState();
-  writeJSON(stateFile(), { ...s, ...data });
+  const merged = { ...s, ...data };
+  writeJSON(stateFile(), merged);
+  // Backup credentials whenever they change
+  backupCredentials(merged);
 }
 
 // ── Contacts ─────────────────────────────────────────────────────────

package/src/tools/match.ts

@@ -41,7 +41,7 @@ export function createMatchTool(): AnyAgentTool {
           public_name: c.public_name,
           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 } : {}),