钉钉接入

更新时间:
复制为 MD 格式

本文介绍如何通过钉钉应用与机器人接入OpenClaw,实现用户与机器人对话,驱动OpenClaw完成相关任务。

方案概述

通过钉钉应用与机器人,实现用户与机器人对话,驱动OpenClaw完成相关任务。接入主要经过以下步骤:

  • 创建钉钉应用并与云电脑系统OpenClaw进行安全凭证对接。

  • 创建钉钉机器人。

  • 创建卡片模板。

  • 发布钉钉应用。

  • 使用钉钉机器人。

创建钉钉应用

  1. 前往钉钉开放平台

    说明
    • 需选择具备开发者权限的组织,或者选择某个组织后选择获取开发者权限

    • 如果没有合适的组织,可使用移动端钉钉扫描下方二维码,快速创建一个组织。image

  2. 点击顶部导航栏应用开发,在钉钉应用页面点击创建应用

  3. 选择左侧导航栏的凭证与基础信息,查看并复制Client ID 以及Client Secret

  4. 返回云电脑OpenClaw Config页面选择通道设置

  5. 开启钉钉卡片右侧开关,将复制的Client IDClient Secret分别填入App KeyApp Secret中。

  6. 填写完毕后点击右上角保存

创建钉钉机器人

  1. 应用创建完毕后在左侧导航栏选择添加应用能力,点击右侧机器人卡片下方添加按钮。

  2. 在机器人配置页面,开启机器人配置

  3. 消息接收模式选择Stream模式,并点击发布完成对机器人的配置。

  4. 选择左侧导航栏的版本管理与发布,并点击创建新版本

  5. 完成配置后点击下方的保存完成版本的发布。

创建消息卡片

钉钉机器人通过卡片消息支持流式返回结果,需要创建卡片模板供消息发送使用。

  1. 前往卡片平台,点击新建模板

  2. 在创建模板输入框,根据以下信息创建模板。

    • 卡片类型:选择消息卡片

    • 卡片模板场景:选择AI卡片

    • 关联应用:填入先前步骤创建的应用名称。

  3. 在卡片编辑页面右上角点击保存,然后单击发布

发布应用

应用发布后,企业员工方可搜索并使用。

  1. 返回应用列表,选择目标应用,进入目标详情页。

  2. 权限管理中开通Card.Streaming.WriteCard.Instance.Writeqyapi_robot_sendmsg三个权限。

  3. 在左侧菜单中选中版本管理与发布,并点击创建新版本

  4. 在版本详情中,填写应用版本号版本描述,并选择应用的可用范围,最后单击保存即可。

    说明

    在选择应用可用范围时,请根据业务实际需求选择可见范围,若选择全部员工,则当应用发布后当前企业下所有的员工都可见。

与钉钉机器人对话

在群聊中与机器人对话

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

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

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

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

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

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

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

与机器人直接对话

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

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

常见问题

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

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

  • 确认已申请 Card.Streaming.WriteCard.Instance.Writeqyapi_robot_sendmsg权限。

  • 检查机器人消息接收地址是否正确配置。

  • 确保应用版本已发布。

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

原因可能是:

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

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