钉钉接入
本文介绍如何通过钉钉应用与机器人接入OpenClaw,实现用户与机器人对话,驱动OpenClaw完成相关任务。
方案概述
通过钉钉应用与机器人,实现用户与机器人对话,驱动OpenClaw完成相关任务。接入主要经过以下步骤:
创建钉钉应用并与云电脑系统OpenClaw进行安全凭证对接。
创建钉钉机器人。
创建卡片模板。
发布钉钉应用。
使用钉钉机器人。
创建钉钉应用
创建钉钉机器人
应用创建完毕后在左侧导航栏选择添加应用能力,点击右侧机器人卡片下方添加按钮。
在机器人配置页面,开启机器人配置。
消息接收模式选择Stream模式,并点击发布完成对机器人的配置。
选择左侧导航栏的版本管理与发布,并点击创建新版本。
完成配置后点击下方的保存完成版本的发布。
创建消息卡片
钉钉机器人通过卡片消息支持流式返回结果,需要创建卡片模板供消息发送使用。
前往卡片平台,点击新建模板。
在创建模板输入框,根据以下信息创建模板。
卡片类型:选择消息卡片。
卡片模板场景:选择AI卡片。
关联应用:填入先前步骤创建的应用名称。
在卡片编辑页面右上角点击保存,然后单击发布。
发布应用
应用发布后,企业员工方可搜索并使用。
返回应用列表,选择目标应用,进入目标详情页。
在权限管理中开通
Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg三个权限。在左侧菜单中选中版本管理与发布,并点击创建新版本。
在版本详情中,填写应用版本号和版本描述,并选择应用的可用范围,最后单击保存即可。
说明在选择应用可用范围时,请根据业务实际需求选择可见范围,若选择全部员工,则当应用发布后当前企业下所有的员工都可见。
与钉钉机器人对话
在群聊中与机器人对话
打开钉钉客户端,进入任意群聊。
如果已有群聊,需要确保群归属组织与创建机器人时的组织相同。
创建新的群聊,请确保创建时候选择的归属组织与创建机器人时的组织相同。
单击群设置(右上角),进入群设置,然后选择机器人。
在机器人管理模块下,选择添加机器人。
在添加机器人界面,通过搜索已经创建并发布的机器人,点击机器人进行添加即可。
机器人添加成功后,通过@机器人,实现自动回复。
与机器人直接对话
在钉钉顶部搜索框中搜索已创建机器人名称直接使用。
发送消息与机器人进行单独对话。
常见问题
钉钉机器人配置后无法收到消息
检查 Client ID 和 Client Secret 配置是否正确。
确认已申请
Card.Streaming.Write、Card.Instance.Write和qyapi_robot_sendmsg权限。检查机器人消息接收地址是否正确配置。
确保应用版本已发布。
群添加机器人时找不到创建的机器人
原因可能是:
该群聊的归属组织与创建机器人时的组织不同。请选择或重新创建一个正确的群聊。
群聊归属组织正确,但不是内部群,需转换为内部群。
