帮助中心
操作
OpenClaw部署
钉钉接入

钉钉接入

重要

无影OpenClaw镜像最新版本为：个人版——OpenClaw-SE-0307/企业版——3月7日更新版本，本文档基于此版本编制

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

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

  • 创建钉钉机器人

  • 创建卡片模板

  • 发布钉钉应用

  • 使用钉钉机器人

注意

创建钉钉应用需要您的钉钉账号有开发者权限。可以联系组织管理员获取钉钉开放平台的开发权限，具体操作请参见获取开发者权限。

参考资料：钉钉关于OpenClaw接入的文档

步骤一：申请钉钉机器人

  1. 打开 钉钉开放平台
  2. 在开发者后台，点击应用开发，并点击创建应用。

  1. 在右侧展示应用创建页，根据内容填写应用的基本信息（包括应用名称和应用描述），最后单击保存即可。

创建成功后，在应用列表会显示已创建的应用，如下图所示：

  1. 在应用详情页中的凭证与基础信息模块内，获取应用的Client ID和Client Secret。

  1. 【回到云电脑中】将上一步的Client ID和Client Secret分别填入APP KEY及APP SECRET中。填写完毕后点击保存配置。

步骤二：创建钉钉机器人

  1. 选择目标应用，进入目标详情页。

  1. 在左侧菜单中选中添加应用能力，并添加机器人能力。

  1. 在配置页面开启机器人配置功能，并填写机器人名称等必填项，最后单击发布即可。
注意

在配置机器人信息时，默认消息接收模式为Stream模式。

步骤三：创建卡片模板

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

1.访问卡片平台，点击新建模板。

  1. 在创建模板输入框，填入模板信息，单击创建。
    • 卡片类型：选择消息卡片。
    • 卡片模板场景：选择AI 卡片。
    • 关联应用：填入刚刚创建的应用名称。

  1. 点击创建后，会出现卡片编辑页，不需要进行任何额外操作，直接保存并发布模板。然后点击返回模板列表页面。

步骤四：发布钉钉应用

  1. 【回到应用开发页面】选择目标应用，进入目标详情页。

  1. 在权限管理中依次添加Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg三个权限点。

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

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

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

步骤五：使用钉钉机器人

场景一：群聊中使用机器人

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

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

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

  2. 单击群设置（右上角），进入群设置，然后选择机器人。

  1. 在机器人管理模块下，选择添加机器人。

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

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

场景二：单聊中使用机器人

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

  1. 通过发送消息，实现机器人单聊回复，如下图所示：

常见问题

钉钉机器人配置后无法收到消息怎么办？

请检查以下几点：

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

  2. 确认已申请 Card.Streaming.Write、Card.Instance.Write和qyapi_robot_sendmsg权限。

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

  4. 确保应用版本已发布。

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

原因可能是：

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

  2. 群聊归属组织正确，但不是内部群，需转换为内部群。