群聊与云端 Agent:让你的 AI 在「消息」里找你
在组件世界的「消息」里建群、拉联系人和你自己的云端 Agent;用 REST、MCP 或 Webhook 把 Claude Code、Codex、自建机器人接进来。纯人群端到端加密,Agent 会话经服务器中转并明确标注。
「消息」除了一对一,现在还能建群,也能添加云端 Agent——你名下的机器人联系人。你的 Claude Code、Codex 或自己写的机器人可以用它给你发消息(比如每天早上一条简报)、读你回给它的话,还能被你拉进群里一起讨论。
群聊
- 打开 消息,点左上角的「新建群聊」(两个人的图标)。
- 填群名,勾选要拉进来的人——只能是你的联系人(亲友空间成员、专注伙伴)和你自己的 Agent。
- 点「建群」。最多 50 人、5 个 Agent。
群里输入 @ 会弹出成员列表,选一个就能提及 TA;被 @ 的人即使开了免打扰也会收到提醒。群主可以改群名、设管理员;群主和管理员可以移出成员;任何人都可以随时退群(群主退出后自动交给管理员或最早的成员)。
加密:只有人的群是端到端加密的——每条消息分别加密给每位成员的每台设备,服务器只临时保管密文(最长 7 天,送达即删)。群名和成员名单是服务器看得到的。群里有 Agent 时,标题旁会显示「含 Agent」:@ 了 Agent 的消息(或者你把它设为「全部可见」后的所有消息)会由服务器解开交给它,其它消息仍然端到端加密。在群资料里可以随时把自己的 Agent 改成「只看 @」或「全部可见」。
群聊和 Agent 会话里暂时只能发文字和图片;文件直连只在一对一里可用。
新建云端 Agent
- 「消息」左栏切到 Agent 标签,点「新建 Agent」。
- 起个名字(比如「每日简报」),写一句描述,点「新建并生成令牌」。
- 复制弹出的令牌(
wsp_开头)。它只显示这一次;丢了可以点「换一个」,旧的立即失效。
这个令牌只能以这个 Agent 的身份收发消息,碰不到你的组件、主页、数据或其它任何东西,也不会出现在「设置 → API 与 AI 连接」的令牌列表里。每人最多 5 个 Agent;每个 Agent 每天最多发 500 条、每分钟 20 条。
用 REST 接入(curl)
给你自己发一条消息:
curl -X POST https://widgetstore.net/widget/api/v1/chat/bot/send \
-H "Authorization: Bearer <令牌>" \
-H "Content-Type: application/json" \
-d '{"text":"早上好!今天有 3 件事要做"}'
读你发给它的消息(after 填上次返回的 cursor,只取更新的):
curl "https://widgetstore.net/widget/api/v1/chat/bot/messages?after=<cursor>" \
-H "Authorization: Bearer <令牌>"
发到群里:先用 GET /widget/api/v1/chat/bot/conversations 查到群的会话 ID(g: 开头),发送时带上 "conversation":"g:…"。
用 MCP 接入(Claude Code 等)
在 Claude Code 里一行命令:
claude mcp add --transport http widgetstore-chat https://widgetstore.net/mcp \
--header "Authorization: Bearer <令牌>"
接好后它只有三个工具:chat_send(发消息)、chat_read(读消息)、chat_conversations(它在哪些会话里)。其它支持 MCP 的客户端填同样的地址和请求头即可。
Webhook:有人找它时马上通知
在 Agent 管理页的「Webhook」里填一个 https 地址。你发给 Agent 的消息(以及群里 @ 它的消息)会马上以 JSON POST 过去,失败最多重试 3 次;连续失败太多会自动暂停,重新保存地址即可恢复。每次推送都带签名头:
X-WidgetStore-Signature: t=<秒>,v1=<HMAC-SHA256(签名密钥, t + "." + 正文)>
请用管理页里的签名密钥(whsec_ 开头)校验后再处理。地址只能是公网 https 域名(不能是 IP、本机或内网地址)。
示例:每日简报 Agent(示例)
一个最简单的做法:每天 8 点用 cron 跑一段脚本,让你的 AI 汇总今天的日程和待办,再调上面的 send 接口发给你;你在「消息」里回复「把第一件挪到下午」,Webhook 收到后交给 AI 处理并回复。
老版本
旧的页面或旧版 App 收不到群和 Agent 的消息——它们会在服务器上保留最多 7 天,刷新页面或更新 App 后自动送到。
最后更新:2026年11月16日