国内应用接入
网易云信 MCP 接入:批量查询 IM 用户名片
使用网易云信应用的 AppKey 与 AppSecret,让机器人按 accid 列表读取用户名片。OpenClaw Launch 将单次输入限制为 1–100 个账号,当前不修改用户资料。
网易云信连接适合哪些查询?
当客服、风控或社区运营已有一组云信 accid 时,可以批量获取官方用户名片,再让机器人按昵称、资料完整度或业务标记整理结果。
当前连接调用 getUinfos.action,并在服务端生成 Nonce、CurTime 和 SHA1 CheckSum。它只读取传入 accid 对应的资料,不提供模糊搜索、全量用户导出、资料更新或消息读取。
接入后可以做什么?
- 批量查询用户名片:一次提交 1–100 个 accid,读取云信服务端返回的用户资料。
- 整理资料完整度:让机器人比较返回字段、识别未找到账号或缺失资料,不更改上游数据。
- 服务端安全签名:每次调用自动生成 Nonce、秒级时间戳和 CheckSum,无需把 AppSecret 交给机器人。
网易云信 AppKey 与 AppSecret 怎么配置?
需要云信控制台同一个 IM 应用的 AppKey 和 AppSecret。不要使用客户端 Token、用户 Token 或其他网易产品的密钥替代。
- 创建或选择云信 IM 应用 — 登录网易云信控制台,确认要查询的用户属于哪个应用和环境。
- 复制应用凭证 — 从应用详情获取 AppKey 与 AppSecret,并确保两者来自同一个应用。
- 连接网易云信 — 在国内应用列表选择网易云信,填写 AppKey 和 AppSecret 完成连接。
- 准备准确的 accid — 从您的业务系统取得云信用户账号 ID;当前工具不按昵称搜索用户。
- 先查少量测试账号 — 先提交 1–3 个已知 accid,核对应用环境和返回资料,再扩大到最多 100 个。
连接后可以直接这样问
- “查询这 5 个云信 accid 的用户名片,并按 accid 对齐结果”
- “检查这批用户资料缺少哪些常用字段,只做读取”
- “把未查询到的 accid 单独列出,不要猜测用户信息”
使用前必须知道的限制
当前只有 users 一个只读动作,OpenClaw Launch 将单次 accids 数量限制为 1–100。它不支持昵称搜索、全量导出、修改用户名片、好友关系、群组、消息或禁言操作;字段与频控由网易云信控制。
用户名片可能包含昵称、头像、手机号、邮箱或自定义扩展字段。仅查询有合法业务依据的 accid,并限制结果的保存、转发和展示范围。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接网易云信的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行保护 AppSecret,生成 Nonce、CurTime 与 SHA1 CheckSum,维护用户查询、频控、错误码、批次拆分和个人信息访问权限。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
网易云信接入常见问题
一次最多查询多少个云信用户?
当前 OpenClaw Launch 连接每次接受 1–100 个 accid;更大的名单需要拆成多批。
可以按昵称搜索用户吗?
不可以。必须提供准确的 accid 列表,工具不会遍历或模糊搜索整个用户库。
连接会读取聊天记录吗?
不会。当前只调用用户名片查询接口,不读取消息、群组或好友关系。
为什么某个 accid 没有返回?
请确认账号属于同一个云信应用、accid 拼写正确且该用户存在;机器人不会为未找到账号生成资料。