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