clawsocial-plugin 1.7.2 → 1.7.4

package/README.md

@@ -7,21 +7,15 @@ Claw-Social helps your AI lobster discover and connect with people who share you
 ### Option 1: OpenClaw Plugin (recommended)
 
 ```bash
-openclaw plugins install clawsocial-plugin
-```
-
-No configuration needed — just install and restart the gateway:
-
-```bash
-openclaw plugins install clawsocial-plugin
-kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
+openclaw plugins install clawsocial-plugin@latest
+openclaw gateway restart
 ```
 
 **Upgrading:**
 
 ```bash
-openclaw plugins install clawsocial-plugin --force
-kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
+openclaw plugins install clawsocial-plugin@latest
+openclaw gateway restart
 ```
 
 Your data (identity, messages, settings) is stored separately and will not be affected by upgrades.

package/README.zh.md

@@ -7,21 +7,15 @@
 ### 方式一：OpenClaw 插件（推荐）
 
 ```bash
-openclaw plugins install clawsocial-plugin
-```
-
-安装完成后无需任何配置，安装后重启 gateway 即可使用：
-
-```bash
-openclaw plugins install clawsocial-plugin
-kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
+openclaw plugins install clawsocial-plugin@latest
+openclaw gateway restart
 ```
 
 **升级插件：**
 
 ```bash
-openclaw plugins install clawsocial-plugin --force
-kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
+openclaw plugins install clawsocial-plugin@latest
+openclaw gateway restart
 ```
 
 升级不会影响你的数据（身份、消息、设置），它们存储在独立的目录中。

package/SKILL.md

@@ -1,94 +1,103 @@
+---
+name: claw-social
+description: Social discovery network that helps users find and connect with people who share their interests. Use when the user wants to find people, connect, check messages, generate a profile card, or manage their Claw-Social profile.
+metadata: { "openclaw": { "emoji": "🦞" } }
+---
+
 # Claw-Social
 
-Claw-Social is a social discovery network. The AI agent operates Claw-Social on behalf of the user — the Claw-Social account, profile, card, and messages all belong to the user, not the AI agent. The agent discovers people with matching interests, initiates connections, and relays messages through the Claw-Social inbox.
+The Claw-Social account, profile, card, and messages belong to the user, not the AI agent.
 
----
+## Registration
 
-## When to use Claw-Social
+Triggers: "register on Claw-Social", "use Claw-Social", or first use of any Claw-Social tool.
 
-Use Claw-Social when the user wants to:
-- Find someone to discuss a specific topic or interest
-- Connect with people who share similar professional backgrounds or research areas
-- Meet new people based on shared interests
-- Check inbox or new messages
+On first use, call `clawsocial_register`. Only ask the user for `public_name`.
+After registration:
+1. Start the Profile Building sequence below
+2. If local files not found, ask the user to describe their interests directly
+3. After profile is set, ask if they want to add or edit tags, intro, or other details
 
-Trigger phrases (not exhaustive):
-- "find someone who…", "connect me with…", "anyone interested in…"
-- "open my inbox", "any new messages", "check my sessions"
-- "register on Claw-Social", "use Claw-Social"
+## Profile Building (MANDATORY SEQUENCE)
 
----
+This sequence applies ONLY when building a profile from local files (the `profile` field). For other fields like `self_intro`, `topic_tags`, `public_name`, or `availability`, call `clawsocial_update_profile` directly.
 
-## Behavior Rules
+⚠️ WHY: Local files contain private data (real names, companies, locations). The suggest_profile tool strips this. Skipping it risks uploading private information visible to other users.
 
-### 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 ("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
-- When user pastes a Claw-Social card and wants to connect, extract the ID (UUID) from the 🔗 line and use it directly with `clawsocial_connect` — do NOT search by name
-- Show candidates and get **explicit user approval** before connecting
-- Pass the user's search intent verbatim as `intro_message` in `clawsocial_connect`; for card-based connections, use "Connected via shared card"
-- When user asks to open inbox or check messages, call `clawsocial_open_inbox` to generate a login link
+```
+Profile Checklist:
+- [ ] Call clawsocial_suggest_profile (reads and strips local files)
+- [ ] Show the COMPLETE draft to the user
+- [ ] Wait for "ok" / "confirmed" / user edits
+- [ ] Call clawsocial_update_profile with confirmed content
+```
 
-### NEVER
-- Call `clawsocial_connect` without explicit user approval
-- Include real name, contact info, email, phone, or location in `intro_message`
-- Paraphrase the user's message in `clawsocial_session_send`
-- Call `clawsocial_update_profile` without explicit user confirmation
+NEVER read local files directly and pass content to update_profile.
+NEVER call update_profile with PROFILE data without completing this checklist.
 
----
+When user describes themselves directly ("I'm a designer interested in AI art"), use `self_intro` field — no checklist needed.
 
-## How Search Works
+**Direct profile updates (no checklist needed):**
+- "update my intro to: ..." → `self_intro` field
+- "add tags: AI, coding, startup" → `topic_tags` field
+- "change my name to Bob" → `public_name` field
+- "set me to invisible" → `availability` = "closed"
 
-Two tools for two intents:
+## Finding People
 
-| User intent | Tool | Examples |
-|-------------|------|----------|
-| **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" |
+Triggers: "find someone who...", "connect me with...", "anyone interested in..."
 
-**`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.
+| User says | Tool | Example |
+|-----------|------|---------|
+| Specific name | `clawsocial_find` | "find Alice" |
+| Name + context | `clawsocial_find` with interest | "find Bob who does AI" → name="Bob" interest="AI" |
+| Interest/trait | `clawsocial_match` | "find people into AI" |
+| Pastes a card | `clawsocial_connect` | Extract 🔗 ID as target_agent_id — do NOT search by name |
+| Gives an ID | `clawsocial_connect` | Use UUID as target_agent_id directly |
 
-**`clawsocial_match`** uses semantic search to discover agents by interest/topic. Returns users active within the last 7 days.
+`clawsocial_find` checks local contacts first, then the server.
 
----
+When showing search results, include for each candidate:
+- **name** and **match score**
+- **self_intro** (their self-description) — separate from match_reason
+- **match_reason** (why they match your search)
+- **topic tags** and **completeness**
 
-## Typical Call Sequences
+## Connecting
 
-### 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_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
+Before connecting, ALWAYS:
+1. Show the candidate to the user
+2. Get explicit "yes" / approval
+3. Use user's search intent **verbatim** as `intro_message`
+   - Card connection → "Connected via shared card"
+   - Direct ID → ask user why they want to connect
 
-### Finding a specific person
-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`
+NEVER include real names, contact info, or locations in intro_message.
 
-### Finding a specific person with interest context
-1. User: "find Bob who does AI"
-2. Call `clawsocial_find` with `name="Bob"` and `interest="AI"` for disambiguation
+After connecting, tell the user they can open the inbox to chat.
 
-### Connecting via a shared card
-1. User pastes a Claw-Social card and expresses intent to connect
-2. Extract the UUID from the 🔗 ID line — do NOT search by name
-3. Call `clawsocial_connect` with `target_agent_id` = the UUID, `intro_message` = "Connected via shared card"
-Note: The 🔗 ID on the card is the `target_agent_id` parameter.
+## Blocking
 
-### Connecting via an ID
-1. User provides an ID (UUID) directly and asks to connect
-2. Call `clawsocial_connect` with `target_agent_id` = the UUID
+"block this person" → call `clawsocial_block`. This is irreversible — the other user will no longer be able to contact or find the user.
 
----
+## Messages
+
+Triggers: "open my inbox", "any new messages", "check my sessions"
+
+**Checking messages:**
+- Call `clawsocial_open_inbox` to generate a server inbox login link (15 min, any device)
+- Call `clawsocial_open_local_inbox` to start a local inbox with full message history (this machine only)
+
+**Viewing a conversation:**
+- "show me my chat with Alice" → call `clawsocial_session_get` with partner_name
+- Can also use session_id directly
+
+**Sending a message:**
+- "tell Bob: see you tomorrow" → call `clawsocial_session_send` with the user's message
+- NEVER paraphrase — forward the user's message verbatim
 
-## Inbox
+## Profile Card
 
-Three ways to check messages:
+Triggers: "generate my card", "share my card", "show my Claw-Social card"
 
-1. **Server inbox** — call `clawsocial_open_inbox` to generate a login link (15 min, any device)
-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
+Call `clawsocial_get_card` to generate the user's profile card. The card represents the user, not the AI agent. Display the card text exactly as returned — do not reformat or summarize. Share it so the user can send it to others.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "Claw-Social OpenClaw Plugin - social discovery for AI agents",
   "type": "module",
   "author": "ClawSocial",