Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

zh platform dingtalk

github-actions[bot] edited this page May 15, 2026 · 2 revisions

接入钉钉 DingTalk

支持的基本消息类型

版本 v4.15.0。

消息类型 是否支持接收 是否支持发送 备注
文本
图片
语音
视频
文件

主动消息推送:支持。

创建和配置应用

钉钉支持两种创建方式:在 AstrBot 中扫码一键创建,或在钉钉开放平台手动创建应用。

方式一:扫码一键创建

需要 AstrBot 版本 >= v4.25.0。

打开 AstrBot 管理面板 -> 机器人 -> + 创建机器人,选择 钉钉(DingTalk)

选择创建方式 中选择 扫码一键创建,使用手机钉钉扫描页面中的二维码,并在钉钉页面中创建或绑定机器人。创建成功后,AstrBot 会自动写入 ClientIDClientSecret,此时点击 保存 即可。

扫码创建完成后,仍建议检查后文的事件订阅、版本发布和拉入群组步骤。

方式二:手动创建

前往 钉钉开放平台,点击创建应用:

image

创建好之后,添加应用能力,选择机器人:

image

点击机器人配置,填写填写机器人相关信息:

image

确认无误后,点击下面的发布按钮。

点击凭证与基础信息,将 ClientIDClientSecret 复制下来。

开始连接

打开 AstrBot 管理面板 -> 机器人 -> + 创建机器人,创建一个钉钉适配器。

如果使用扫码一键创建,选择 扫码一键创建 并完成扫码;如果使用自己创建的钉钉应用,选择 手动创建,将刚刚复制的 ClientIDClientSecret 填入。点击保存后,AstrBot 将会自动向钉钉开放平台请求。

回到钉钉开放平台,点击事件订阅,选择 Stream 模式推送,点击保存,如果没有意外情况,将会看到 连接接入成功 字样。

image

点击保存即可。

发布版本

点击边栏的 版本管理与发布,创建一个新版本。

填写应用版本号、版本描述、应用可见范围(选择全部员工或者按照您的需求),点击保存,确认发布。

alt text

找到一个钉钉群聊,点击右上角的设置:

image

下拉找到添加机器人,然后找到刚刚创建的机器人,点击添加即可:

image

🎉 大功告成

在群聊中 @ 机器人后附带 /help 指令,如果机器人回复了,那么说明接入成功。

Chinese

English

Clone this wiki locally

Morty Proxy This is a proxified and sanitized view of the page, visit original site.