Data Agent 支持接入钉钉机器人，配置完成后，可通过钉钉群聊或私聊直接与 Data Agent 实例交互，随时获取数据分析结果。
功能概述
Data Agent 是 DataWorks 平台的 AI 智能体，内置数据集成、数据开发、数据治理、数据安全等 Skills，支持通过自然语言完成数据同步任务创建、SQL 生成与调试、数据质量排查、血缘关系查询等操作。IM 频道功能将 Data Agent 实例以机器人形式接入钉钉、飞书、企业微信等即时通讯工具。接入后，用户无需登录 DataWorks 控制台，直接在日常沟通工具中 @机器人 即可调用 Data Agent 的全部能力，在对话中完成数据开发与治理任务。
前提条件
已创建 Data Agent 实例，且实例处于运行状态。
Data Agent 实例已绑定资源组（测试网络连通性的前提条件）。
拥有钉钉开放平台开发者权限。如需获取权限，请联系组织管理员，具体操作请参见获取开发者权限。
步骤一：创建钉钉应用
登录钉钉开放平台，创建应用并获取凭证，用于建立 Data Agent 与钉钉的连接。
选择或创建组织
访问钉钉开放平台，选择拥有开发者权限的组织。
若无可用组织，使用钉钉移动端扫描以下二维码创建新组织（钉钉移动客户端版本需 ≥ 6.5.45）。
创建应用并配置机器人
进入开发者后台，单击创建应用，填写应用名称和应用描述，上传应用图标后保存。
进入应用详情，单击左侧添加应用能力，选择添加机器人。
进入机器人详情页，配置机器人信息（名称、图标、简介、描述）。消息接收模式必须选择 Stream 模式。配置完成后单击发布。
单击左侧权限管理，确保应用至少具备以下权限：
权限标识
说明
snsapi_base
调用 SNS API 时需要具备的基本权限
qyapi_base
调用企业 API 时需要具备的基本权限
qyapi_robot_sendmsg
企业内机器人发消息权限
Card.Instance.Write
互动卡片实例写权限
Card.Streaming.Write
AI 卡片流式更新权限
单击左侧事件订阅，将订阅管理的推送方式设置为 Stream 模式。
确认应用的安全设置未配置 IP 白名单。设置 IP 白名单会导致消息推送被拦截，机器人无法正常响应。
单击左侧版本管理与发布，创建版本并发布应用。
发布成功后，单击左侧导航栏凭证与基础信息，复制并保存 Client ID（即 AppKey）和 Client Secret（即 AppSecret）。
除上述手动配置方式外，钉钉开放平台还提供一键式应用初始化服务，您可访问钉钉开放平台，在开发者后台的钉钉应用列表中，点击一键自动创建OpenClaw机器人应用，开启智能协作之旅处的立即创建openclaw机器人。
步骤二：测试网络连通性
配置钉钉 IM 频道前，需先确保 Data Agent 实例与钉钉之间的网络已连通。
登录DataWorks 控制台，单击左侧导航栏Data Agent，进入 Data Agent 应用后，打开目标实例。
单击左侧导航栏IM 频道。
IM 频道页面展示钉钉、飞书、企业微信三个通道卡片，每张卡片显示当前的配置状态、网络状态和启用状态。
钉钉通道卡片上，单击测试网络连通性，验证 Data Agent 与钉钉之间的网络连接。
若通道卡片显示已连通状态，表示网络已就绪，可直接进入下一步配置 IM 频道。
若通道卡片显示未连通状态，需继续执行下一步开启通道网络。
（仅在连通性测试失败时执行）单击开启通道网络。
Data Agent 提供最小化打通（推荐）方案：仅为未联通的通道配置 PrivateZone 和私网连接（PrivateLink），影响范围最小。
说明最小化打通属于 VPC 级网络变更：打通后，同一 VPC 下的其他实例也将具备访问对应通道域名的网络能力。执行前请确认该 VPC 内的实例可以共享此网络访问范围。
在交换机可用区下拉框中为各可用区选择对应的交换机（vSwitch），然后单击一键打通。系统将自动配置 PrivateZone 解析和私网连接，等待约 1～5 分钟完成网络打通。
若需更精细地控制网络配置，可单击处理网络跳转至资源组网络配置页面手动操作。单击重新检测可随时重新测试各通道的连通性。
执行完成后，系统自动重测连通性。确认通道卡片显示已连通状态后，进入下一步配置 IM 频道。
步骤三：配置 Data Agent 钉钉 IM 频道
网络连通后，配置钉钉应用凭证以建立 Data Agent 与钉钉的连接。
钉钉通道卡片上，单击配置，在弹出的 IM 频道配置对话框中填写以下参数：
参数
说明
AppKey
填写钉钉开放平台应用的 AppKey（步骤一获取）。
AppSecret
填写钉钉开放平台应用的 AppSecret（步骤一获取）。
单击高级配置展开更多设置项，按需配置以下参数：
类别
参数
说明
会话管理
会话隔离方式
控制不同用户或群聊之间的对话上下文是否隔离。可选值：
按用户隔离：每个用户拥有独立的对话上下文，互不影响。
按群/话题隔离：同一群聊或话题内的消息进入同一个对话，适合群内协作场景。
全部共享：所有用户共享同一个对话上下文。
权限管理
用户访问权限
控制哪些用户可以与机器人交互。可选值：
所有人可用：组织内所有成员均可使用。
仅允许名单：仅允许名单中的用户使用。
配对：未配对的用户首次向机器人发消息时会收到一个配对码，管理员批准后该用户即可使用；已在允许名单中的用户无需配对。
允许群聊
开启后，机器人仅在群聊中被 @ 或收到回复时响应。开启后可进一步配置可响应的群聊范围：
所有群聊：机器人可在所有群聊中响应。
指定群聊：仅在指定的群聊中响应。
消息处理
忙碌时处理方式
当机器人正在处理消息时收到新消息的处理策略。可选值：
打断重定向：收到新消息时取消当前任务，并按新消息继续。
收集合并：将新消息与当前任务合并处理。
排队处理：新消息排队等待，按顺序逐条处理。
群聊上下文回填
填写正整数后，未 @ 机器人的授权群消息会缓存到下一次触发时作为上下文回填。留空或填写 0 表示关闭此功能。
边生成边发送
开启后，机器人在回复过程中按段落发送多条短消息，而不是等待最终长回复。适用于需要快速反馈的场景。默认关闭。
配置完成后，单击保存。
步骤四：测试机器人
配置完成后，通过钉钉添加机器人进行对话测试。
群聊测试
进入钉钉群群设置页面，单击机器人，打开机器人管理页面后单击添加机器人。
搜索框输入目标机器人名称，选中要添加的机器人，单击添加，完成后单击完成添加。
钉钉群内 @机器人 发送消息。机器人正常响应时，将以流式卡片形式返回数据分析结果。若机器人未响应，检查通道卡片的启用状态和网络连通性，并确认应用权限配置是否完整。
私聊测试
通过钉钉上方搜索框搜索创建的机器人名称，单击机器人头像进入私聊页面。
直接向机器人发送消息即可开始对话。机器人正常响应时，将以流式卡片形式返回数据分析结果。若机器人未响应，检查通道卡片的启用状态和网络连通性，并确认应用权限配置是否完整。