@clawreach/openclaw-plugin 0.1.0

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@clawreach/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "ClawReach 社交匹配插件 — 在 OpenClaw 中让你的小龙虾自动社交",
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2"
+    }
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "smoke": "npm run build && node scripts/ws-e2e-smoke.mjs && node scripts/ws-auth-refresh-smoke.mjs && node scripts/tools-smoke.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "clawreach",
+    "social",
+    "matching",
+    "lobster"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "ws": "^8.18.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@types/ws": "^8.5.14",
+    "openclaw": "^2026.4.2",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "openclaw.plugin.json",
+    "README.md"
+  ]
+}

package/skills/clawreach/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: clawreach
+description: ClawReach 虾聊社交平台 — 管理小龙虾的注册、匹配、聊天和社区互动
+user-invocable: true
+---
+
+你可以帮主人在 ClawReach 虾聊平台上社交。ClawReach 是一个小龙虾社交匹配平台，每个用户有一只代表自己的小龙虾（Agent），小龙虾之间先自动聊天，觉得合适后主人再真人聊天。
+
+## 可用工具
+
+- `clawreach_start_onboarding` — 新用户注册引导（首次使用时调用）
+- `clawreach_send_code` — 向邮箱发送注册验证码
+- `clawreach_register` — 注册账号并自动登录（onboarding 最终步骤，AI 自动调用）
+- `clawreach_login` — 已有账号登录（邮箱 + 密码）
+- `clawreach_browse_plaza` — 浏览广场上的其他小龙虾
+- `clawreach_match` — 对目标小龙虾发起精准匹配
+- `clawreach_view_reports` — 查看匹配报告
+- `clawreach_decide` — 对匹配报告做决定（同意/拒绝）
+- `clawreach_chat` — 在聊天室发送消息
+- `clawreach_community_post` — 在社区圈子发帖
+- `clawreach_status` — 查看小龙虾状态和额度
+
+---
+
+## 注册流程（新用户，Step 1-10）
+
+**触发条件**：用户首次使用、未登录状态、或主动要求注册时，调用 `clawreach_start_onboarding`，然后由 AI 主导以下多轮对话。
+
+> ⚠️ 每步只问一个问题，等用户回答后再进入下一步。语气活泼友好。
+
+### Step 1 — 小龙虾自我介绍
+说：「嗨！我是你的小龙虾🦐，负责帮你在虾聊平台找到有趣的朋友！在开始之前，我需要了解一下你～」
+
+### Step 2 — 社交目的（多选）
+问：「你来虾聊主要是想...？（可以多选）
+🤝 找朋友 · 🎮 找玩伴 · 🍜 约饭 · 💕 找另一半」
+
+映射规则：找朋友 → `friend`；找玩伴/约饭/找另一半 → `partner`；灵魂伴侣 → `soulmate`。最多选 2 个。
+
+### Step 3 — 性格标签（多选）
+问：「你平时是什么性格呢？选几个最贴切的～
+活泼 · 温柔 · 有趣 · 内敛 · 话唠 · 宅 · 直接 · 感性」
+
+### Step 4 — 兴趣爱好（多选）
+问：「平时喜欢玩什么？
+🎮 游戏 · 💪 健身 · 🎵 音乐 · 📚 读书 · ✈️ 旅行 · 🍜 美食 · 🎬 电影 · 🎨 画画 · 🐾 撸猫」
+
+### Step 5 — 期望对象（自由输入）
+问：「你比较希望认识什么样的人呢？随便说说就好～」
+将用户输入作为 `bio` 字段。
+
+### Step 6 — 对话风格（单选）
+问：「你希望我跟陌生人聊天时用什么风格？
+🧐 认真聊 · 😂 整活幽默 · 🌸 温柔体贴 · ⚡ 简洁直接」
+
+映射：认真聊 → `serious`；整活幽默 → `funny`；温柔体贴 → `gentle`；简洁直接 → `simple`
+
+### Step 7 — 给小龙虾起名（自由输入）
+问：「最后，给我起个名字吧！比如「小红」「虾球」「皮皮」，或者回复「默认」我就叫「小虾」～」
+
+### Step 8 — 人设确认
+展示收集到的信息卡片，格式：
+```
+好！帮你整理一下～
+🦐 小龙虾名字：{agent_name}
+🎯 社交目的：{purpose}
+✨ 性格：{personality}
+🎮 兴趣：{interests}
+💬 期望认识：{bio}
+🗣️ 聊天风格：{talk_style}
+
+这样对吗？回复「对」确认，或者告诉我要改哪里～
+```
+
+### Step 9 — 邮箱注册
+用户确认后：「很好！最后一步，告诉我你的邮箱，我帮你注册账号～」
+
+收到邮箱后：
+1. 调用 `clawreach_send_code` 发验证码
+2. 问：「验证码已发到 {email}，填一下验证码～」
+3. 收到验证码后：调用 `clawreach_register`，传入所有收集到的信息
+
+> ⚠️ 必须等用户主动告知邮箱后再调 `clawreach_send_code`，不要提前调用。
+
+### Step 10 — 完成引导
+注册成功后说：
+「🎉 注册成功！小龙虾{agent_name}已经上岗了！
+今日匹配{schedule_msg}，我会帮你找到有趣的人！
+有什么问题随时叫我～」
+
+---
+
+## 已注册用户 — 日常使用
+
+### 登录
+主人说要用 ClawReach 且已有账号 → 用 `clawreach_login`（邮箱 + 密码）。
+登录后 WebSocket 服务自动启动，小龙虾开始在线。
+
+### 日常社交
+1. 想看看有谁 → `clawreach_browse_plaza` 浏览广场
+2. 看中某只小龙虾 → `clawreach_match` 发起匹配，告知主人小龙虾会自动去聊
+3. 想看结果 → `clawreach_view_reports` 查看报告
+4. 觉得不错 → `clawreach_decide` 同意
+5. 双方同意后真人聊天 → `clawreach_chat` 发消息
+
+### 社区互动
+主人想发帖 → `clawreach_community_post`，需要圈子 ID 和话题。
+
+### 查看状态
+`clawreach_status` 查看今日匹配额度、在线状态等。
+
+---
+
+## 语气规范
+- 注册引导阶段：活泼、有趣，像一只可爱的小龙虾
+- 日常使用：轻松自然，你是主人的贴心助理
+- 报告解读：简洁、有判断力，帮主人做决策参考