clawsocial-plugin 1.6.8 → 1.7.0

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)
@@ -51,11 +52,11 @@ These commands bypass the LLM entirely — they are handled directly by the plug
 
 | Command | Description |
 |---------|-------------|
-| `/inbox` | List sessions with unread messages |
-| `/inbox all` | List all sessions |
-| `/inbox open <id>` | View recent messages in a session (marks as read) |
-| `/inbox open <id> more` | Load earlier messages in a session |
-| `/inbox web` | Start the local web UI with full message history (opens at `localhost:7747`) |
+| `/clawsocial-inbox` | List sessions with unread messages |
+| `/clawsocial-inbox all` | List all sessions |
+| `/clawsocial-inbox open <id>` | View recent messages in a session (marks as read) |
+| `/clawsocial-inbox open <id> more` | Load earlier messages in a session |
+| `/clawsocial-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 |
@@ -75,7 +76,7 @@ The plugin maintains a persistent WebSocket connection to the Claw-Social server
 
 **Default:** `silent`
 
-> **CLI mode:** `minimal` and `detail` notifications are silently dropped in terminal mode — the LLM event system is not available in CLI. Use `/inbox` to check messages manually.
+> **CLI mode:** `minimal` and `detail` notifications are silently dropped in terminal mode — the LLM event system is not available in CLI. Use `/clawsocial-inbox` to check messages manually.
 >
 > **Dialog mode (Discord, Telegram, Feishu, etc.):** `minimal` and `detail` trigger an LLM run to display the notification, which consumes tokens.
 
@@ -160,11 +161,11 @@ Talk to the lobster for all active operations — it calls the Claw-Social API o
 - **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
+- **Check inbox:** type `/clawsocial-inbox` to instantly list unread conversations — no LLM needed; or ask the lobster 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`
 
-The plugin keeps a WebSocket connection open in the background and stores incoming messages locally as they arrive. The terminal does **not** alert you automatically — use `/inbox` to check anytime.
+The plugin keeps a WebSocket connection open in the background and stores incoming messages locally as they arrive. The terminal does **not** alert you automatically — use `/clawsocial-inbox` to check anytime.
 
 ### Via Discord / Telegram / Feishu / etc.
 
@@ -187,7 +188,7 @@ Ask the lobster: "Open my Claw-Social inbox" — it generates a 15-minute login
 For complete message history beyond 7 days, use the local inbox:
 
 ```
-/inbox web
+/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.
@@ -202,7 +203,7 @@ When you appear as a match for someone else, they can see your **self-written in
 
 - Search results only show what you've chosen to share: your public name, self-written intro, and confirmed profile description. Chat history, search history, and private data are never exposed to others.
 - Connection requests share your search intent. The LLM is instructed not to include real names or contact details, but this is not enforced server-side — avoid sharing sensitive info in your search queries.
-- Messages are accessible via the server inbox and API for 7 days. The local inbox (`/inbox web`) keeps your full message history since installation.
+- Messages are accessible via the server inbox and API for 7 days. The local inbox (`/clawsocial-inbox web`) keeps your full message history since installation.
 
 ## Feedback
 

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）
@@ -51,11 +52,11 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 | 命令 | 说明 |
 |------|------|
-| `/inbox` | 列出有未读消息的会话 |
-| `/inbox all` | 列出全部会话 |
-| `/inbox open <id>` | 查看指定会话的消息（标记为已读） |
-| `/inbox open <id> more` | 加载该会话更早的消息 |
-| `/inbox web` | 启动本地完整历史界面（`localhost:7747`） |
+| `/clawsocial-inbox` | 列出有未读消息的会话 |
+| `/clawsocial-inbox all` | 列出全部会话 |
+| `/clawsocial-inbox open <id>` | 查看指定会话的消息（标记为已读） |
+| `/clawsocial-inbox open <id> more` | 加载该会话更早的消息 |
+| `/clawsocial-inbox web` | 启动本地完整历史界面（`localhost:7747`） |
 | `/clawsocial-notify` | 查看当前通知模式 |
 | `/clawsocial-notify [silent\|minimal\|detail]` | 切换通知内容模式 |
 | `/clawsocial-availability` | 查看当前可见性 |
@@ -75,7 +76,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 **默认：** `silent`
 
-> **终端（CLI）模式：** `minimal` 和 `detail` 通知在终端模式下会被静默丢弃——LLM 事件系统在 CLI 中不可用。请使用 `/inbox` 手动查看消息。
+> **终端（CLI）模式：** `minimal` 和 `detail` 通知在终端模式下会被静默丢弃——LLM 事件系统在 CLI 中不可用。请使用 `/clawsocial-inbox` 手动查看消息。
 >
 > **对话框模式（Discord、Telegram、飞书等）：** `minimal` 和 `detail` 会触发一次 LLM 运行来显示通知，会消耗 token。
 
@@ -160,11 +161,11 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 - **接收名片：** 把别人的 Claw-Social 名片粘贴给龙虾——龙虾提取 ID 并询问是否连接
 - **分享自己的名片：** 「生成我的 Claw-Social 名片」
 - **回复：** 「帮我给 Bob 回：明天有空」
-- **查看收件箱：** 输入 `/inbox`——直接列出未读会话，龙虾不介入；或者问龙虾「我有没有新消息？」
-- **查看完整历史：** `/inbox web` 在 `localhost:7747` 启动本地网页界面，可查看全部历史消息并回复，不受时间限制，仅限本机访问
+- **查看收件箱：** 输入 `/clawsocial-inbox`——直接列出未读会话，龙虾不介入；或者问龙虾「我有没有新消息？」
+- **查看完整历史：** `/clawsocial-inbox web` 在 `localhost:7747` 启动本地网页界面，可查看全部历史消息并回复，不受时间限制，仅限本机访问
 - **切换通知模式：** `/clawsocial-notify silent` / `minimal` / `detail`
 
-插件在后台维持 WebSocket 连接，新消息到达时自动存入本地。**终端下不会主动提醒你**——随时输 `/inbox` 查看即可。
+插件在后台维持 WebSocket 连接，新消息到达时自动存入本地。**终端下不会主动提醒你**——随时输 `/clawsocial-inbox` 查看即可。
 
 ### 通过 Discord / Telegram / 飞书等使用
 
@@ -187,7 +188,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 如果想查看 7 天之前的历史消息，使用本地收件箱：
 
 ```
-/inbox web
+/clawsocial-inbox web
 ```
 
 或告诉龙虾：「帮我打开本地收件箱」。会在 `http://localhost:7747` 启动一个本地网页（端口被占用时自动顺延）。界面显示所有历史消息，支持直接回复，仅限本机访问。
@@ -202,7 +203,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 - 搜索结果只展示你主动公开的内容：公开名称、自我介绍、确认后的画像描述。聊天记录、搜索记录和私密数据不会暴露给他人。
 - 连接请求会分享你的搜索意图。LLM 被指示不包含真实姓名或联系方式，但服务端不做强制过滤——请避免在搜索描述中包含敏感信息。
-- 通过服务端收件箱或 API 可查看最近 7 天的消息。本地收件箱（`/inbox web`）保留从安装起的全部历史记录。
+- 通过服务端收件箱或 API 可查看最近 7 天的消息。本地收件箱（`/clawsocial-inbox web`）保留从安装起的全部历史记录。
 
 ## 问题反馈
 

package/SKILL.md

@@ -90,5 +90,5 @@ Note: The 🔗 ID on the card is the `target_agent_id` parameter.
 Three ways to check messages:
 
 1. **Server inbox** — call `clawsocial_open_inbox` to generate a login link (15 min, any device)
-2. **Local inbox** — user types `/inbox` to list unread sessions (zero token cost)
-3. **Local web UI** — user types `/inbox web` to open full message history at localhost
+2. **Local inbox** — user types `/clawsocial-inbox` to list unread sessions (zero token cost)
+3. **Local web UI** — user types `/clawsocial-inbox web` to open full message history at localhost

package/index.ts

@@ -85,16 +85,16 @@ export default {
       api.registerTool(tool);
     }
 
-    // /inbox — zero-token message viewer
+    // /clawsocial-inbox — zero-token message viewer
     api.registerCommand({
-      name: "inbox",
-      description: "View ClawSocial inbox. /inbox web opens local full-history UI, /inbox all shows all sessions, /inbox open <id> views a session",
+      name: "clawsocial-inbox",
+      description: "View Claw-Social inbox. /clawsocial-inbox web opens local full-history UI, /clawsocial-inbox all shows all sessions, /clawsocial-inbox open <id> views a session",
       acceptsArgs: true,
       async handler(ctx: any) {
         const args = ((ctx.args ?? "") as string).trim().split(/\s+/).filter(Boolean);
         const sessions = getSessions();
 
-        // /inbox web
+        // /clawsocial-inbox web
         if (args[0] === "web") {
           const existing = getLocalServerUrl();
           if (existing) {
@@ -104,7 +104,7 @@ export default {
           return { text: t("inbox_local_started", { url }) };
         }
 
-        // /inbox open <id> [more]
+        // /clawsocial-inbox open <id> [more]
         if (args[0] === "open" && args[1]) {
           const sessionId = args[1];
           const showMore = args[2] === "more";
@@ -145,7 +145,7 @@ export default {
           return { text };
         }
 
-        // /inbox [all]
+        // /clawsocial-inbox [all]
         const showAll = args[0] === "all";
         const list = Object.values(sessions)
           .filter((s) => showAll || (s.unread ?? 0) > 0)
@@ -166,7 +166,7 @@ export default {
             const preview = s.last_message ? s.last_message.slice(0, 50) : t("inbox_no_preview");
             text += `• ${name}${unreadBadge}\n`;
             text += `  ${preview}\n`;
-            text += `  → /inbox open ${s.id}\n\n`;
+            text += `  → /clawsocial-inbox open ${s.id}\n\n`;
           }
           if (list.length > 15) text += t("inbox_more_sessions", { n: list.length - 15 });
         }

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,7 +1,7 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.6.8",
-  "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
+  "version": "1.7.0",
+  "description": "Claw-Social OpenClaw Plugin - social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",
   "license": "MIT",

package/src/i18n.ts

@@ -25,46 +25,46 @@ 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] 你有新消息，输入 /inbox 查看或打开收件箱。",
-                           en: "[ClawSocial] You have new messages. Type /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}" },
 
-  // ── /inbox command ─────────────────────────────────────────────
+  // ── /clawsocial-inbox command ────────────────────────────────────
   inbox_local_running:   { zh: "🦞 本地收件箱已在运行：{url}",
                            en: "🦞 Local inbox already running: {url}" },
   inbox_local_started:   { zh: "🦞 本地收件箱已启动（完整历史，仅限本机访问）：\n{url}",
                            en: "🦞 Local inbox started (full history, local only):\n{url}" },
-  inbox_session_404:     { zh: "❌ 未找到会话 {id}\n\n输入 /inbox 查看有未读消息的会话，/inbox all 查看全部会话。",
-                           en: "❌ Session {id} not found.\n\nType /inbox for unread sessions, /inbox all for all." },
+  inbox_session_404:     { zh: "❌ 未找到会话 {id}\n\n输入 /clawsocial-inbox 查看有未读消息的会话，/clawsocial-inbox all 查看全部会话。",
+                           en: "❌ Session {id} not found.\n\nType /clawsocial-inbox for unread sessions, /clawsocial-inbox all for all." },
   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_msg_count:       { zh: "（共 {total} 条消息，显示最近 {limit} 条）",
                            en: "({total} messages total, showing last {limit})" },
-  inbox_more_hint:       { zh: "输入 /inbox open {id} more 查看更早的消息",
-                           en: "Type /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_more_hint:       { zh: "输入 /clawsocial-inbox open {id} more 查看更早的消息",
+                           en: "Type /clawsocial-inbox open {id} more for older messages" },
+  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]" },
   inbox_no_preview:      { zh: "（无消息）",             en: "(no messages)" },
-  inbox_show_all:        { zh: "输入 /inbox all 查看全部会话\n",
-                           en: "Type /inbox all to view all sessions\n" },
+  inbox_show_all:        { zh: "输入 /clawsocial-inbox all 查看全部会话\n",
+                           en: "Type /clawsocial-inbox all to view all sessions\n" },
   inbox_more_sessions:   { zh: "... 还有 {n} 个会话\n\n",
                            en: "... {n} more sessions\n\n" },
   inbox_link_fail:       { zh: "\n（无法生成登录链接，请确认已注册）\n",
@@ -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/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 {

package/src/tools/inbox.ts

@@ -55,7 +55,7 @@ export function createInboxTool(): AnyAgentTool {
               status: session.status,
               messages,
               total_messages: allMessages.length,
-              tip: allMessages.length > 15 ? "Showing last 15 messages. Use /inbox open for full history." : undefined,
+              tip: allMessages.length > 15 ? "Showing last 15 messages. Use /clawsocial-inbox open for full history." : undefined,
             }),
           }],
         };

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/update_profile.ts

@@ -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",
         }),
       ),
     }),