2.6 连接第一个渠道:钉钉(图文版)
通过本文你将全面了解连接第一个渠道:钉钉(图文版)的核心概念、实际应用方法和最佳实践。
概述
一、为什么要接入钉钉
钉钉是企业常用的办公通讯工具,接入后可以在钉钉群里或私聊中和 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 对话了!🎉