钉钉接入

更新时间:
复制 MD 格式

本文介绍如何通过钉钉接入 Agent,提供极速配对(扫码即用,无需建应用)和关联已有机器人两种方式。

前提条件

  • 已在 Agent 管理中心创建 Agent。

通道配置

  1. 前往Agent 管理中心

  2. 在左侧导航栏,选择您的 Agent 类型,例如 JVS Computer

  3. 单击通道配置

  4. 单击目标 Agent 操作列中的查看/配置通道

  5. 在钉钉卡片上,单击立即配置

在弹出的页面,选择以下任一方式完成机器人接入:

极速配对

说明

要求云电脑镜像版本满足:Windows 3.2.18 及以上,Linux 3.0.10 及以上。如需更新,可重启云电脑。

  1. 单击立即发送。系统会向授权用户下发包含访问链接的短信或邮件。

  2. 授权用户通过短信或邮件中的 URL 访问绑定页面获取二维码(您也可在控制台直接获取该 URL)。

  3. 使用钉钉扫描二维码,完成机器人绑定。

  4. 在钉钉中与机器人对话,验证连接成功。

说明

如已绑定其他机器人,扫码后将被替换。

关联已有机器人

创建钉钉应用

说明

您所在的钉钉组织需具备开发者权限。如所在组织暂无该权限,请参见获取开发者权限。如果没有合适的组织,可使用移动端钉钉扫描下方二维码,快速创建一个组织。image

  1. 登录钉钉开放平台开发者后台。

  2. 在顶部导航栏单击应用开发,在应用开发页面单击立即创建,可一键创建 OpenClaw 机器人应用。

  3. 在创建 OpenClaw 页面,填写机器人名称、简介和图标等基本信息;如无特殊要求,也可保持默认配置,然后单击确定完成创建。

  4. 创建成功后,页面会自动展示该应用的 Client IDClient Secret,请及时复制并妥善保存,后续在 Agent 管理中心配置钉钉通道时需要使用。

    说明

    Client ID 与 Client Secret 是访问应用数据的核心凭证,请妥善保管,切勿泄露给他人。

填写凭证完成关联

  1. 回到 Agent 管理中心,输入钉钉应用的 Client IDClient Secret,然后单击确认

  2. 在钉钉中与机器人对话,验证连接成功。

与钉钉机器人对话

在群聊中与机器人对话

  1. 打开钉钉客户端,进入任意群聊。

    • 如果已有群聊,需要确保群归属组织与创建机器人时的组织相同。

    • 创建新的群聊,请确保创建时候选择的归属组织与创建机器人时的组织相同。

  2. 点击群设置(右上角),进入群设置,然后选择机器人

  3. 在机器人管理模块下,选择添加机器人

  4. 在添加机器人界面,通过搜索已经创建并发布的机器人,点击机器人进行添加即可。

  5. 机器人添加成功后,通过@机器人,实现自动回复。

与机器人直接对话

  1. 在钉钉顶部搜索框中搜索已创建机器人名称直接使用。

  2. 发送消息与机器人进行单独对话。

常见问题

钉钉机器人配置后无法收到消息

  • 检查 Client ID 和 Client Secret 配置是否正确。

  • 确保应用版本已发布。

群添加机器人时找不到创建的机器人

原因可能是:

  • 该群聊的归属组织与创建机器人时的组织不同。请选择或重新创建一个正确的群聊。

  • 群聊归属组织正确,但不是内部群,需转换为内部群。