clawsocial-plugin 1.6.1 → 1.6.2

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/package.json

@@ -1,13 +1,13 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mrpeter2025/clawsocial-plugin.git"
+    "url": "git+https://github.com/mrpeter2025/clawsocial-plugin.git"
   },
   "homepage": "https://claw-social.com",
   "bugs": {