国内应用接入
环信 MCP 接入：按用户名查询 IM 用户资料
使用环信应用级服务端凭证，让机器人按一个 username 读取该用户的属性。当前连接不发送消息、不列出全部用户，也不会修改用户资料。
环信连接的实际能力边界
当客服或运营手里已有环信 username 时，可以让机器人调用用户属性接口，读取该账号在环信返回的元数据，再结合工单或内部记录进行核对。
当前连接只封装一个只读动作：查询指定用户属性。它会先使用 Client ID 与 Client Secret 获取 App Token，再根据您选择的数据中心、OrgName 和 AppName访问对应的官方 REST API。
接入后可以做什么？
- 按用户名定位：输入一个环信 username，读取该账号由官方接口返回的用户属性。
- 适配多个数据中心：连接时明确选择 cn1、cn1_new、sg、us、de 或 id，避免请求发往错误区域。
- 只读资料核对：让机器人整理上游返回字段用于客服排查或账号核验，不更新用户或发送消息。
环信服务端凭证需要哪些字段？
需要数据中心 Region、应用标识中的 OrgName 与 AppName，以及应用的 Client ID 和 Client Secret。这些字段必须来自同一个环信应用与环境。
- 确认应用所在数据中心 — 在环信控制台确认应用区域，并映射为 cn1、cn1_new、sg、us、de 或 id。
- 复制应用标识 — 从应用详情记录 OrgName 和 AppName，注意大小写与环境不要混用。
- 获取服务端凭证 — 在应用详情的 App Key 区域获取 Client ID 与 Client Secret，并按密钥管理要求保存。
- 连接环信 — 在国内应用列表填写五个字段，完成服务端凭证校验。
- 查询已知测试用户 — 先用一个熟悉且非敏感的 username 查询，核对区域、应用与返回属性是否正确。
连接后可以直接这样问
- “查询环信用户 user_001 的资料，只返回官方接口已有字段”
- “读取这个 username 的用户属性并指出缺失字段”
- “核对这三个工单中的 username；请逐个查询，不要修改用户”
使用前必须知道的限制
当前只有 user 一个只读动作，每次查询一个 username。它不支持列出或搜索全部用户、注册用户、修改属性、发送消息、读取聊天记录或管理群组。用户属性功能、字段和调用频率受环信应用套餐与官方规则限制。
用户属性可能包含昵称、联系方式或业务自定义信息。只查询有业务依据的账号，不要批量枚举 username；返回内容应按企业隐私和客服权限制度处理。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接环信的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行维护多区域 API 主机、App Token 获取与刷新、应用标识、用户属性接口、限流、凭证轮换和隐私访问控制。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
环信接入常见问题
可以用环信 App Key 直接连接吗？
当前连接需要 Region、OrgName、AppName、Client ID 和 Client Secret，不能只填一个 App Key 字符串。
连接后可以发送 IM 消息吗？
不可以。当前只按 username 查询用户属性，不开放消息发送或聊天记录读取。
Region 填错会怎样？
请求会发往错误的数据中心，通常表现为授权失败、应用不存在或找不到用户。请以环信控制台的应用区域为准。
为什么返回没有某个资料字段？
连接只返回环信官方用户属性接口对该账号提供的内容；未设置、无权限或未开通的字段不会由机器人补造。