国内应用接入
钉钉宜搭 MCP 接入：让 AI 助手查询表单实例
连接钉钉企业内部应用与宜搭专业版后，机器人可以按表单标识分页读取实例，并根据组件条件缩小结果范围；当前不会新建、更新或删除表单数据。
宜搭连接能解决什么问题？
业务数据常被收集在宜搭表单中，例如报修单、客户登记、巡检记录和审批输入。当前连接调用宜搭服务端开放 API，把指定表单的实例列表交给机器人做筛选、摘要和待办整理。
它不是完整的宜搭自动化平台。每次查询都要提供 AppType、SystemToken 和 FormUuid，并受宜搭版本、应用权限、页面数据权限和单页大小限制；当前工具只读，不发起流程或修改记录。
接入后可以做什么？
- 分页读取实例：按 FormUuid 查询指定表单的实例，单页最多读取 100 条并支持继续翻页。
- 按组件条件搜索：可传入 search_field_json，用表单组件唯一标识和值缩小查询范围。
- 整理业务记录：让机器人基于返回的结构化字段汇总数量、状态与异常项，不回写宜搭。
宜搭 AppKey、AppSecret 与表单标识怎么准备？
连接凭证是钉钉应用的 AppKey 和 AppSecret。实际查询还需要宜搭应用的 AppType、SystemToken 与目标页面 FormUuid，并且当前接口要求宜搭专业版及对应数据读取权限。
- 创建钉钉应用 — 在钉钉开放平台创建企业内部应用，复制应用凭证中的 AppKey 与 AppSecret。
- 申请宜搭读取权限 — 为应用添加宜搭表单数据读取权限，并确认组织拥有可调用服务端 API 的宜搭专业版能力。
- 找到三个查询标识 — 从宜搭应用和表单配置中记录 AppType、SystemToken 与 FormUuid；它们属于查询参数，不是 AppSecret。
- 连接钉钉宜搭 — 在国内应用列表选择钉钉宜搭，填写 AppKey 和 AppSecret 完成连接。
- 用小分页验证 — 先以 page_size 5 查询一个熟悉表单，核对字段权限和实例内容，再逐步增加范围。
连接后可以直接这样问
- “查询这个宜搭表单的前 20 条实例，并按创建时间整理”
- “只读搜索客户状态为“待跟进”的表单实例”
- “继续读取下一页宜搭记录，汇总重复项和缺失字段”
使用前必须知道的限制
当前只提供 form_instances 一个只读动作，需要宜搭专业版。page_size 为 1–100；搜索条件必须使用表单组件唯一标识。返回内容受应用权限和页面数据权限控制，不支持创建、更新、删除、审批或流程发起。
宜搭表单可能包含手机号、地址、身份证明和内部审批信息。只查询完成任务所需的表单与字段，避免把完整实例批量贴入聊天；敏感业务结论应由数据负责人复核。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接钉钉宜搭的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行维护钉钉应用、宜搭专业版授权、访问令牌、表单标识、组件查询格式、分页、限流与企业数据权限。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
钉钉宜搭接入常见问题
普通版宜搭可以使用吗？
当前连接标注为宜搭专业版官方 API；如果组织没有对应版本或接口能力，调用会失败。
连接后能修改表单或通过审批吗？
不能。当前只分页搜索表单实例，不提供新增、更新、删除或审批动作。
FormUuid 在哪里填写？
AppKey 和 AppSecret 填在连接表单；AppType、SystemToken 与 FormUuid 在每次查询参数中提供。
为什么能连接但查不到记录？
请检查 AppType、SystemToken、FormUuid、表单数据读取权限、页面数据权限和搜索组件标识是否属于同一个宜搭应用。