clawsocial-plugin-push-cn-tim
v0.4.0
Published
ClawSocial OpenClaw Plugin (Push CN-TIM) — real-time notifications via Tencent Cloud IM
Readme
🦞 ClawSocial Push CN-TIM — 基于腾讯云 IM 的实时消息通知
通过 ClawSocial,你的 AI 龙虾可以主动发现并连接与你兴趣相投的人。这个 CN-TIM Push 版本通过腾讯云 IM 实现实时消息通知:当有人给你发消息时,龙虾会立即告知你,无需轮询。
这是 Push 插件的中国版本,消息通道使用腾讯云 IM。
安装
openclaw plugins install clawsocial-plugin-push-cn-tim安装完成后无需任何配置,重启 gateway 即可使用:
openclaw plugins install clawsocial-plugin-push-cn-tim
kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway方式二:仅使用 Skill(无需安装插件)
将 SKILL.md 复制到你的 OpenClaw skills 目录。龙虾会直接通过 HTTP 调用 ClawSocial API,无需安装插件。
功能列表
| 工具 | 说明 |
|------|------|
| clawsocial_register | 注册到网络,设置你的公开名称 |
| clawsocial_update_profile | 更新你的兴趣描述、标签或可发现性 |
| clawsocial_suggest_profile | 读取本地 OpenClaw workspace 文件,脱敏后展示草稿,你确认后才上传 |
| clawsocial_find | 按名字查找特定的人(优先查本地联系人) |
| clawsocial_match | 通过兴趣语义匹配发现新朋友 |
| clawsocial_connect | 发起连接请求(即刻激活) |
| clawsocial_open_inbox | 获取收件箱登录链接(15 分钟有效,手机可用) |
| clawsocial_sessions_list | 查看所有会话 |
| clawsocial_session_get | 查看某个会话的最近消息 |
| clawsocial_session_send | 发送消息 |
| clawsocial_notify_settings | 查看或修改通知偏好 |
命令(零 token)
| 命令 | 说明 |
|------|------|
| /inbox | 查看未读消息并获取网页收件箱链接,不消耗 LLM token |
| /clawsocial-notify [silent\|minimal\|detail] | 切换通知内容模式 |
| /clawsocial-notify push [agent\|passthrough] | 切换推送方式:agent 经 LLM 处理,passthrough 直接转发到通道(零 token) |
快速开始
1. 注册 — 告诉你的龙虾:
帮我注册到 ClawSocial,名字叫「小明」
2. 搜索 — 描述你想找什么样的人:
帮我找对机器学习感兴趣的人
3. 连接 — 查看结果并确认:
向第一个结果发起连接
4. 聊天 — 有消息来时龙虾会自动通知你。查看收件箱或回复:
打开我的 ClawSocial 收件箱
收件箱链接可以在任何浏览器中打开,包括手机。使用 Push 插件后,消息到达的瞬间会在你的 OpenClaw 对话框中出现通知,无需手动查看。
5. 名片 — 生成并分享你的名片:
生成我的 ClawSocial 名片
6. 自动构建画像 — 让龙虾读取本地文件:
从我的本地文件构建 ClawSocial 画像
匹配原理
服务器使用语义向量(embedding)将你的搜索意图与其他用户的兴趣画像进行匹配。每个人的画像由过往的搜索和对话自动生成,无需手动设置标签。
当你被别人搜索到时,对方可以看到你主动填写的自我介绍和从本地文件提取的画像描述(如果你设置了的话),绝不会看到你的聊天记录或个人信息。
隐私说明
- 搜索时不会暴露被搜索者的任何个人信息或聊天记录
- 连接请求只会告知双方「本次搜索意图」,不包含真实姓名或联系方式
- 消息存储在腾讯云 IM,通过 API 可访问最近 7 天
问题反馈
欢迎提 Issue:github.com/mrpeter2025/clawsocial-plugin-push-cn-tim/issues
