国内应用接入
融云 MCP 接入：按 user_id 查询 IM 用户资料
使用融云应用的 App Key 和 App Secret，让机器人读取一个指定 user_id 的官方用户资料。当前不会注册用户、签发 Token、发送消息或读取聊天记录。
融云连接的用途与边界
如果客服或业务系统已有融云 user_id，可以让机器人查询该账号的官方资料，用于核对账号映射、整理工单上下文或识别资料缺失。
每次请求由服务端生成新的 Nonce、毫秒时间戳和 SHA1 Signature，再调用融云 user/info 接口。当前只有单用户只读查询，不会枚举用户或访问消息内容。
接入后可以做什么？
- 查询单个用户：按准确的 user_id 读取融云官方接口返回的用户资料。
- 核对账号映射：让机器人把 user_id 与上游返回字段整理成客服或运营可复核的摘要。
- 自动完成请求签名：服务端为每次请求生成 Nonce、Timestamp、Signature 和 X-Request-ID。
融云 App Key 与 App Secret 怎么获取？
需要融云控制台同一个应用和环境的 App Key 与 App Secret。App Secret 只用于服务端签名，不要在客户端代码或聊天中公开。
- 选择正确的融云应用 — 登录融云控制台，确认目标用户所在的应用以及生产或开发环境。
- 复制服务端凭证 — 从应用设置获取 App Key 和对应 App Secret，避免混用不同应用的凭证。
- 连接融云 — 在国内应用列表填写 App Key 与 App Secret，凭证会加密保存在服务端。
- 准备准确 user_id — 从自己的用户系统取得融云 user_id；当前连接不能按昵称搜索。
- 查询一个测试账号 — 先读取已知测试用户并核对资料，再用于真实客服或运营任务。
连接后可以直接这样问
- “查询融云用户 user_1 的资料，只返回上游实际字段”
- “核对这个工单里的 user_id 是否有对应融云用户资料”
- “读取该用户资料并列出缺失字段，不要进行任何写操作”
使用前必须知道的限制
当前只有 user 一个只读动作，每次查询一个 user_id。它不支持用户列表、昵称搜索、用户注册、Token 签发、资料修改、消息、群组或聊天记录；可见字段、API 域名和频率受融云应用配置与官方规则限制。
即使只读，用户资料也可能属于个人信息。查询前确认工单或业务授权，不要尝试枚举 user_id；对外分享结果时应去除无关字段。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接融云的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行维护 App Key/App Secret、毫秒时间戳、Nonce、SHA1 Signature、API 域名、错误码、限流与隐私访问控制。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
融云接入常见问题
融云连接可以生成用户 Token 吗？
不可以。当前只调用用户资料查询接口，不注册用户或签发 Token。
可以读取融云聊天记录吗？
不能。连接没有消息、历史记录、群组或聊天室相关动作。
为什么查不到某个 user_id？
请确认 user_id 拼写、应用与环境是否正确；来自另一应用或环境的 user_id 不会出现在当前凭证下。
App Secret 会发送给机器人吗？
不会。它只在 OpenClaw Launch 服务端用于请求签名，不写入机器人容器。