本文介绍如何通过钉钉接入 Agent,提供极速配对(扫码即用,无需建应用)和关联已有机器人两种方式。
前提条件
已在 Agent 管理中心创建 Agent。
通道配置
前往Agent 管理中心。
在左侧导航栏,选择您的 Agent 类型,例如 JVS Computer。
单击通道配置。
单击目标 Agent 操作列中的查看/配置通道。
在钉钉卡片上,单击立即配置。
在弹出的页面,选择以下任一方式完成机器人接入:
极速配对
要求云电脑镜像版本满足:Windows 3.2.18 及以上,Linux 3.0.10 及以上。如需更新,可重启云电脑。
单击立即发送。系统会向授权用户下发包含访问链接的短信或邮件。
授权用户通过短信或邮件中的 URL 访问绑定页面获取二维码(您也可在控制台直接获取该 URL)。
使用钉钉扫描二维码,完成机器人绑定。
在钉钉中与机器人对话,验证连接成功。
如已绑定其他机器人,扫码后将被替换。
关联已有机器人
创建钉钉应用
您所在的钉钉组织需具备开发者权限。如所在组织暂无该权限,请参见获取开发者权限。如果没有合适的组织,可使用移动端钉钉扫描下方二维码,快速创建一个组织。
登录钉钉开放平台开发者后台。
在顶部导航栏单击应用开发,在应用开发页面单击立即创建,可一键创建 OpenClaw 机器人应用。
在创建 OpenClaw 页面,填写机器人名称、简介和图标等基本信息;如无特殊要求,也可保持默认配置,然后单击确定完成创建。
创建成功后,页面会自动展示该应用的 Client ID 和 Client Secret,请及时复制并妥善保存,后续在 Agent 管理中心配置钉钉通道时需要使用。
说明Client ID 与 Client Secret 是访问应用数据的核心凭证,请妥善保管,切勿泄露给他人。
填写凭证完成关联
回到 Agent 管理中心,输入钉钉应用的 Client ID 和 Client Secret,然后单击确认。
在钉钉中与机器人对话,验证连接成功。
与钉钉机器人对话
在群聊中与机器人对话
打开钉钉客户端,进入任意群聊。
如果已有群聊,需要确保群归属组织与创建机器人时的组织相同。
创建新的群聊,请确保创建时候选择的归属组织与创建机器人时的组织相同。
点击群设置(右上角),进入群设置,然后选择机器人。
在机器人管理模块下,选择添加机器人。
在添加机器人界面,通过搜索已经创建并发布的机器人,点击机器人进行添加即可。
机器人添加成功后,通过@机器人,实现自动回复。
与机器人直接对话
在钉钉顶部搜索框中搜索已创建机器人名称直接使用。
发送消息与机器人进行单独对话。
常见问题
钉钉机器人配置后无法收到消息
检查 Client ID 和 Client Secret 配置是否正确。
确保应用版本已发布。
群添加机器人时找不到创建的机器人
原因可能是:
该群聊的归属组织与创建机器人时的组织不同。请选择或重新创建一个正确的群聊。
群聊归属组织正确,但不是内部群,需转换为内部群。