概述


一、为什么要接入钉钉

钉钉是企业常用的办公通讯工具,接入后可以在钉钉群里或私聊中和 AI 对话。


二、整体流程

第一步:在钉钉开放平台创建应用
    ↓
第二步:获取 App Key 和 App Secret
    ↓
第三步:添加机器人能力
    ↓
第四步:配置消息接收模式
    ↓
第五步:在 OpenClaw 中配置钉钉渠道
    ↓
第六步:验证连接成功

三、Step 1:在钉钉开放平台创建应用

3.1 访问钉钉开放平台

浏览器打开:

https://open.dingtalk.com

登录(建议用管理员账号)。

3.2 创建应用

1. 点击左侧"应用开发" 2. 点击"企业内部开发" 3. 点击"创建应用" 4. 填写信息: - 应用名称AI助手 - 应用描述智能运营助手 5. 点击"创建"


四、Step 2:获取 App Key 和 App Secret

创建成功后,进入应用详情页。

"基础信息"中找到:

AppKey:ding_xxxxxxxxxxxxxxx
AppSecret:点击获取

复制 AppKey,点击获取 AppSecret并复制。


五、Step 3:添加机器人能力

5.1 添加入口

在左侧菜单找到"应用能力",点击。

5.2 添加机器人

找到"机器人"卡片,点击"添加能力"

5.3 配置机器人

机器人能力添加后,点击"机器人配置",填写:

  • 机器人名称:AI助手
  • 机器人描述:智能运营助手
  • 消息接收模式:选择"Stream 模式"(推荐,更稳定)

六、Step 4:配置消息接收

4.1 配置消息接收模式

在机器人配置页面,找到"消息接收模式"

选择 "Stream 模式"

  • 优点:配置简单,不需要公网地址
  • 适合:个人开发者或小团队

4.2 配置权限

在左侧"权限管理"中,开通以下权限:

权限名称说明
企业内机器人发送消息发送消息
企业内机器人获取用户信息获取用户信息

七、Step 5:在 OpenClaw 中配置钉钉渠道

5.1 运行配置命令

openclaw configure

5.2 选择钉钉

请选择要配置的项目:
1. AI 模型
2. 飞书渠道
3. 钉钉渠道
4. 企业微信渠道
5. 完成配置

请输入:3

5.3 输入 App Key 和 App Secret

钉钉配置:
App Key:ding_xxxxxxxxxxxxxxx
App Secret:________________

5.4 保存配置

✅ 钉钉渠道配置成功!

八、Step 6:验证连接

6.1 打开钉钉

找到你的机器人(在"工作台"或搜索应用名)。

6.2 发送测试消息

你好

6.3 成功标志

  • ✅ AI 回复了你的消息
  • ✅ 回复内容符合问题

九、常见问题

Q: 钉钉机器人找不到
A:

解决:在"工作台"找到"AI助手"应用,点击进入。

Q: 消息发送成功但机器人不回复
A: 检查:
  • OpenClaw 是否在运行
  • App Key/Secret 是否正确
  • 钉钉应用是否已发布

问题:Stream 模式报错 解决:切换到 HTTP 模式,但需要公网地址。

Q: 钉钉机器人在群内看不到?
A: 在群设置中添加机器人,找到对应的自定义机器人并添加。
Q: 钉钉回调地址怎么填?
A: 格式:https://your-domain.com/feishu/webhook,需要 HTTPS。
Q: 钉钉需要哪些权限?
A: 需要「企业机器人」权限和「消息」权限。

十、下一步学什么

  • 2.5 连接第一个渠道:飞书(图文版) → 如果你也需要飞书
  • 2.7 发送第一条消息:Hello World → 验证安装成功
  • 2.8 快速检查:确认一切正常运行 → 系统性检查

钉钉配置同样有一定难度,配置成功后就可以在钉钉里和 AI 对话了!🎉