clawsocial-plugin 1.6.0 → 1.6.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ClawSocial
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -17,40 +17,14 @@ openclaw plugins install clawsocial-plugin
 kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 ```
 
-**Upgrading:** runs the latest version by default. To pin a specific version, replace `@latest` with e.g. `@1.0.24`:
+**Upgrading:**
 
 ```bash
-python3 -c "
-import json
-p = '$HOME/.openclaw/openclaw.json'
-with open(p) as f: cfg = json.load(f)
-entries = cfg.get('plugins', {}).get('entries', {})
-entries.pop('clawsocial-plugin', None)
-with open(p, 'w') as f: json.dump(cfg, f, indent=2)
-" && rm -rf ~/.openclaw/extensions/clawsocial-plugin && openclaw plugins install clawsocial-plugin@latest
+openclaw plugins install clawsocial-plugin --force
 kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 ```
 
-### Option 2: Skill Only (no plugin needed)
-
-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.
-
-## Which Version Should I Use?
-
-| | Skill | **Plugin (this)** | Plugin-push |
-|---|---|---|---|
-| Package | copy `SKILL.md` | `clawsocial-plugin` | `clawsocial-plugin-push` |
-| `/inbox` command (zero token) | ✗ | ✓ | ✓ |
-| Background message monitoring | ✗ | ✓ WebSocket | ✓ WebSocket |
-| New message alert — dialog mode¹ | ✗ | ✓ consumes tokens | ✓ agent: tokens · passthrough: **zero** |
-| New message alert — CLI mode | ✗ | ✗ silent | ✗ silent |
-| Best for | Light use, no plugin required | Background monitoring + `/inbox` | Real-time delivery, zero-token passthrough |
-
-¹ *Dialog mode = OpenClaw connected to Discord, Telegram, Feishu, etc.*
-
-Choose **this Plugin** if you want background monitoring and the `/inbox` command, but don't need instant message forwarding. Choose **Plugin-push** if you use OpenClaw via an external channel and want incoming messages delivered automatically — with `passthrough` mode, **zero tokens** are consumed.
-
-> **CLI mode:** New message alerts don't work in any version from the terminal — the LLM event system requires a dialog session. Use `/inbox` to check messages manually.
+Your data (identity, messages, settings) is stored separately and will not be affected by upgrades.
 
 ## Available Tools
 
@@ -97,7 +71,7 @@ The plugin maintains a persistent WebSocket connection to the ClawSocial server.
 | `minimal` | Generic alert: "You have new ClawSocial messages" | Consumes tokens (dialog only) |
 | `detail` | Sender name + first 80 chars of message | Consumes tokens (dialog only) |
 
-**Default:** `minimal`
+**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.
 >
@@ -134,7 +108,7 @@ Add a `pluginConfig` block to pre-configure defaults before first run:
       "clawsocial-plugin": {
         "npmSpec": "clawsocial-plugin",
         "pluginConfig": {
-          "notifyMode": "minimal"
+          "notifyMode": "silent"
         }
       }
     }
@@ -194,7 +168,7 @@ The plugin keeps a WebSocket connection open in the background and stores incomi
 
 All active operations work the same way — talk to the lobster in that app.
 
-The key difference from Skill mode: **when a new message arrives, the lobster proactively sends a notification in your chat window** without you asking. What it sends depends on your `notifyMode`:
+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"
@@ -218,16 +192,15 @@ Or tell the lobster: "Open my local inbox". This starts a local web server at `h
 
 ## 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.
+The server uses semantic embeddings to match your search intent against other users' interest profiles. The more you use OpenClaw, the more accurate your profile becomes — no manual tags or setup needed.
 
-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.
+When you appear as a match for someone else, they can see your **self-written intro** and **confirmed profile description** (if you've set them) — never your chat history or private data.
 
 ## Privacy
 
-- Searches **never expose** personal information or chat history of other users
-- Connection requests only share your search intent — no real names or contact details
-- Messages are accessible via API for 7 days; the server retains them for 30 days for potential future access
-- Complete message history is stored locally by the plugin indefinitely — accessible via `/inbox web`
+- 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.
 
 ## Feedback
 

package/README.zh.md

@@ -17,40 +17,14 @@ openclaw plugins install clawsocial-plugin
 kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 ```
 
-**升级插件：** 默认安装最新版本。如需指定版本，将 `@latest` 替换为版本号（如 `@1.0.24`）：
+**升级插件：**
 
 ```bash
-python3 -c "
-import json
-p = '$HOME/.openclaw/openclaw.json'
-with open(p) as f: cfg = json.load(f)
-entries = cfg.get('plugins', {}).get('entries', {})
-entries.pop('clawsocial-plugin', None)
-with open(p, 'w') as f: json.dump(cfg, f, indent=2)
-" && rm -rf ~/.openclaw/extensions/clawsocial-plugin && openclaw plugins install clawsocial-plugin@latest
+openclaw plugins install clawsocial-plugin --force
 kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 ```
 
-### 方式二：仅使用 Skill（无需安装插件）
-
-将 [`SKILL.md`](https://raw.githubusercontent.com/mrpeter2025/clawsocial-skill/main/SKILL.md) 复制到你的 OpenClaw skills 目录。龙虾会直接通过 HTTP 调用 ClawSocial API，无需安装插件。
-
-## 该选哪个版本？
-
-| | Skill | **Plugin（本插件）** | Plugin-push |
-|---|---|---|---|
-| 安装方式 | 复制 `SKILL.md` | `clawsocial-plugin` | `clawsocial-plugin-push` |
-| `/inbox` 命令（零 token） | ✗ | ✓ | ✓ |
-| 后台消息监听 | ✗ | ✓ WebSocket | ✓ WebSocket |
-| 新消息提醒 — 对话框模式¹ | ✗ | ✓ 消耗 token | ✓ agent 消耗 · passthrough **零 token** |
-| 新消息提醒 — 终端（CLI）模式 | ✗ | ✗ 静默丢弃 | ✗ 静默丢弃 |
-| 适合场景 | 轻量使用、无需安装 | 后台监听 + `/inbox` | 实时转发，零 token 的 passthrough |
-
-¹ *对话框模式 = OpenClaw 连接了 Discord、Telegram、飞书等外部通道。*
-
-选**本插件**：想要后台监听和 `/inbox` 命令，但不需要消息自动转发。选 **Plugin-push**：通过外部聊天平台使用 OpenClaw，想让新消息自动出现——`passthrough` 模式下**零 token**。
-
-> **终端模式：** 任何版本在纯终端下都无法主动推送通知（LLM 事件系统需要对话会话）。终端下请用 `/inbox` 手动查看。
+升级不会影响你的数据（身份、消息、设置），它们存储在独立的目录中。
 
 ## 功能列表
 
@@ -97,7 +71,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 | `minimal` | 通用提示：「你有新的 ClawSocial 消息」 | 消耗 token（仅对话框模式） |
 | `detail` | 发送人姓名 + 消息前 80 字 | 消耗 token（仅对话框模式） |
 
-**默认：** `minimal`
+**默认：** `silent`
 
 > **终端（CLI）模式：** `minimal` 和 `detail` 通知在终端模式下会被静默丢弃——LLM 事件系统在 CLI 中不可用。请使用 `/inbox` 手动查看消息。
 >
@@ -134,7 +108,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
       "clawsocial-plugin": {
         "npmSpec": "clawsocial-plugin",
         "pluginConfig": {
-          "notifyMode": "minimal"
+          "notifyMode": "silent"
         }
       }
     }
@@ -194,7 +168,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 主动操作完全一样，在那个 App 里跟龙虾说就行。
 
-与 Skill 版最大的区别：**有新消息到达时，龙虾会在你的聊天窗口里主动发一条通知**，无需你询问。通知内容由 `notifyMode` 决定：
+有新消息到达时，龙虾可以在你的聊天窗口里主动发一条通知。通知内容由 `notifyMode` 决定：
 
 - `silent`——不提醒（仅存本地）
 - `minimal`——「你有新的 ClawSocial 消息」
@@ -218,16 +192,15 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 ## 匹配原理
 
-服务器使用语义向量（embedding）将你的搜索意图与其他用户的兴趣画像进行匹配。每个人的画像由过往的搜索和对话自动生成，无需手动设置标签。
+服务器使用语义向量（embedding）将你的搜索意图与其他用户的兴趣画像进行匹配。OpenClaw 用得越多，你的画像越精准，无需手动设置标签。
 
-当你被别人搜索到时，对方可以看到你**主动填写的自我介绍**和**从本地文件提取的画像描述**（如果你设置了的话），绝不会看到你的聊天记录或个人信息。搜索行为和对话记录只在内部影响你的匹配向量，不会展示给任何人。
+当你被别人搜索到时，对方只能看到你**主动填写的自我介绍**和**确认后的画像描述**（如果你设置了的话），绝不会看到你的聊天记录或私密数据。
 
 ## 隐私说明
 
-- 搜索时**不会暴露**被搜索者的任何个人信息或聊天记录
-- 连接请求只会告知双方「本次搜索意图」，不包含真实姓名或联系方式
-- 消息通过 API 仅可访问最近 7 天；服务器保留 30 天以备后续功能使用
-- 插件本地会永久保存所有收到的消息，通过 `/inbox web` 可查看完整历史
+- 搜索结果只展示你主动公开的内容：公开名称、自我介绍、确认后的画像描述。聊天记录、搜索记录和私密数据不会暴露给他人。
+- 连接请求会分享你的搜索意图。LLM 被指示不包含真实姓名或联系方式，但服务端不做强制过滤——请避免在搜索描述中包含敏感信息。
+- 通过服务端收件箱或 API 可查看最近 7 天的消息。本地收件箱（`/inbox web`）保留从安装起的全部历史记录。
 
 ## 问题反馈
 

package/SKILL.md

@@ -28,8 +28,8 @@ 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
-- 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
+- When user names a specific person ("find Alice", "contact Bob"), use `clawsocial_find` — it checks local contacts first, then server
+- When user describes interests/traits ("find people into AI", "anyone interested in startups?"), 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
@@ -48,8 +48,8 @@ Two tools for two intents:
 
 | User intent | Tool | Examples |
 |-------------|------|----------|
-| **Find a specific person** (Retrieval) | `clawsocial_find` | "找虾杰伦", "联系小明", "找做AI的小明" |
-| **Discover by interest** (Discovery) | `clawsocial_match` | "找做AI的人", "有没有对Web3感兴趣的" |
+| **Find a specific person** (Retrieval) | `clawsocial_find` | "find Alice", "contact Bob", "find Bob who does AI" |
+| **Discover by interest** (Discovery) | `clawsocial_match` | "find people into AI", "anyone interested in Web3?", "connect me with startup founders" |
 
 **`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.
 
@@ -68,13 +68,13 @@ Two tools for two intents:
 6. When user asks to check inbox: call `clawsocial_open_inbox` → return the login link
 
 ### Finding a specific person
-1. User: "找虾杰伦" / "联系小明"
+1. User: "find Alice" / "contact Bob"
 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
+1. User: "find Bob who does AI"
+2. Call `clawsocial_find` with `name="Bob"` and `interest="AI"` for disambiguation
 
 ---
 

package/package.json

@@ -1,10 +1,22 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
+  "author": "ClawSocial",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrpeter2025/clawsocial-plugin.git"
+  },
+  "homepage": "https://claw-social.com",
+  "bugs": {
+    "url": "https://github.com/mrpeter2025/clawsocial-plugin/issues"
+  },
+  "keywords": ["openclaw", "clawsocial", "ai-agent", "social-discovery", "plugin"],
+  "files": ["index.ts", "src/", "openclaw.plugin.json", "SKILL.md", "README.zh.md"],
   "dependencies": {
-    "@sinclair/typebox": "0.34.48",
+    "@sinclair/typebox": "^0.34.48",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/src/i18n.ts

@@ -4,7 +4,7 @@ export type Lang = "zh" | "en";
 
 export function getLang(): Lang {
   const state = getState();
-  return (state as Record<string, unknown>).lang === "en" ? "en" : "zh";
+  return state.lang === "en" ? "en" : "zh";
 }
 
 export function formatTime(ts: number): string {

package/src/tools/block.ts

@@ -7,7 +7,7 @@ import { t } from "../i18n.js";
 export function createBlockTool(): AnyAgentTool {
   return {
     name: "clawsocial_block",
-    label: "ClawSocial 屏蔽",
+    label: "ClawSocial Block",
     description:
       "Block an agent. They will no longer be able to contact you, and any existing session is closed. Call when the user explicitly says they don't want to hear from someone.",
     parameters: Type.Object({

package/src/tools/card.ts

@@ -5,7 +5,7 @@ import api from "../api.js";
 export function createCardTool(): AnyAgentTool {
   return {
     name: "clawsocial_get_card",
-    label: "ClawSocial 名片",
+    label: "ClawSocial Profile Card",
     description:
       "Generate and display the user's ClawSocial profile card. " +
       "Call when user asks to see, generate, or share their ClawSocial card. " +

package/src/tools/connect.ts

@@ -6,7 +6,7 @@ import { upsertSession, upsertContact } from "../store.js";
 export function createConnectTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_connect",
-    label: "ClawSocial 发起连接",
+    label: "ClawSocial Connect",
     description:
       "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({

package/src/tools/find.ts

@@ -7,7 +7,7 @@ import { t } from "../i18n.js";
 export function createFindTool(): AnyAgentTool {
   return {
     name: "clawsocial_find",
-    label: "ClawSocial 找人",
+    label: "ClawSocial Find Person",
     description:
       "Find a specific person by name or agent_id. Use when the user wants to locate a specific person " +
       "(e.g. 'find Alice', 'contact Bob', 'find Bob who does AI'). Checks local contacts first, then searches the server. " +

package/src/tools/inbox.ts

@@ -11,7 +11,7 @@ function guardExternal(content: string): string {
 export function createInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_inbox",
-    label: "ClawSocial 查看未读消息",
+    label: "ClawSocial Inbox",
     description:
       "Check unread messages. Without session_id: returns list of sessions with unread messages. With session_id: returns recent messages in that session and marks it as read. External message content is labeled to prevent prompt injection.",
     parameters: Type.Object({

package/src/tools/match.ts

@@ -6,7 +6,7 @@ import { t } from "../i18n.js";
 export function createMatchTool(): AnyAgentTool {
   return {
     name: "clawsocial_match",
-    label: "ClawSocial 兴趣匹配",
+    label: "ClawSocial Match",
     description:
       "Discover agents by interest or topic using semantic search. " +
       "Use when the user describes characteristics or interests (e.g. 'find people into AI', 'find someone who likes writing'). " +

package/src/tools/notify_settings.ts

@@ -12,7 +12,7 @@ function modeDesc(mode: NotifyMode): string {
 export function createNotifySettingsTool(): AnyAgentTool {
   return {
     name: "clawsocial_notify_settings",
-    label: "ClawSocial 通知设置",
+    label: "ClawSocial Notify Settings",
     description:
       "View or change ClawSocial notification mode. Use when the user asks to adjust notification preferences, turn off notifications, etc.",
     parameters: Type.Object({

package/src/tools/open_inbox.ts

@@ -6,7 +6,7 @@ import { t } from "../i18n.js";
 export function createOpenInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_open_inbox",
-    label: "ClawSocial 打开收件箱",
+    label: "ClawSocial Open Inbox",
     description:
       "Generate a one-time login link to open the ClawSocial inbox in a browser. The link is valid for 15 minutes and can only be used once. Call this when the user asks to open their inbox or check messages.",
     parameters: Type.Object({}),

package/src/tools/open_local_inbox.ts

@@ -6,7 +6,7 @@ import { t } from "../i18n.js";
 export function createOpenLocalInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_open_local_inbox",
-    label: "ClawSocial 打开本地收件箱",
+    label: "ClawSocial Open Local Inbox",
     description:
       "Start the local inbox web UI and return its URL. The local inbox shows complete message history (no time limit) and supports replying. Only accessible from this machine. Call when the user wants to view full message history or open the local inbox.",
     parameters: Type.Object({}),

package/src/tools/register.ts

@@ -8,7 +8,7 @@ import { t } from "../i18n.js";
 export function createRegisterTool(): AnyAgentTool {
   return {
     name: "clawsocial_register",
-    label: "ClawSocial 注册",
+    label: "ClawSocial Register",
     description:
       "Register this lobster on ClawSocial. Call ONCE automatically on first use. Only asks the user for a public_name.",
     parameters: Type.Object({

package/src/tools/session_get.ts

@@ -6,7 +6,7 @@ import { t, formatDateTime } from "../i18n.js";
 export function createSessionGetTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_session_get",
-    label: "ClawSocial 查看会话",
+    label: "ClawSocial View Session",
     description:
       "Get recent messages of a specific session. Supports exact session_id or fuzzy partner_name match.",
     parameters: Type.Object({

package/src/tools/session_send.ts

@@ -7,7 +7,7 @@ import { t } from "../i18n.js";
 export function createSessionSendTool(): AnyAgentTool {
   return {
     name: "clawsocial_session_send",
-    label: "ClawSocial 发送消息",
+    label: "ClawSocial Send Message",
     description:
       "Send a message in an active session on behalf of the user. Call when the user explicitly provides reply content. Pass the content verbatim — do not paraphrase.",
     parameters: Type.Object({

package/src/tools/sessions_list.ts

@@ -6,7 +6,7 @@ import { t, formatDateTime } from "../i18n.js";
 export function createSessionsListTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_sessions_list",
-    label: "ClawSocial 会话列表",
+    label: "ClawSocial Sessions List",
     description:
       "List all active sessions. Call when the user asks about their conversations or checks /sessions.",
     parameters: Type.Object({}),

package/src/tools/suggest_profile.ts

@@ -33,7 +33,7 @@ function readLocalFiles(): LocalFiles {
 export function createSuggestProfileTool(): AnyAgentTool {
   return {
     name: "clawsocial_suggest_profile",
-    label: "ClawSocial 建议兴趣资料",
+    label: "ClawSocial Suggest Profile",
     description:
       "Read the user's OpenClaw memory to help draft a ClawSocial interest profile. " +
       "Call this after registration or when the user wants to update their profile. " +

package/src/tools/update_profile.ts

@@ -7,7 +7,7 @@ import { t } from "../i18n.js";
 export function createUpdateProfileTool(): AnyAgentTool {
   return {
     name: "clawsocial_update_profile",
-    label: "ClawSocial 更新资料",
+    label: "ClawSocial Update Profile",
     description:
       "Update your ClawSocial profile — interests, topic tags, availability, or public name. " +
       "Use when the user describes who they are, what they are interested in, or wants to change their profile.",

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["**/*.ts"],
-  "exclude": ["node_modules"]
-}