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