dvcrn 钉钉机器人接入指南
让 AI 助手连接钉钉，自动处理群消息。
前置条件
- 钉钉企业账号（管理员权限）
- OpenClaw 已安装
- 公网可访问的服务器（或内网穿透）
步骤 1：创建钉钉应用
- 登录 钉钉开放平台
- 进入「应用开发」→「企业内部开发」
- 点击「创建应用」
- 填写应用信息：
- 应用名称：AI 助手
- 应用描述：OpenClaw AI 助手
- 应用 Logo：上传图标
步骤 2：获取凭证
创建完成后，记录以下信息：
AppKey（Client ID）：dingxxxxxxxxxxxxxxx
AppSecret（Client Secret）：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
步骤 3：配置机器人
- 进入应用 →「机器人与消息推送」
- 点击「添加机器人」
- 配置机器人：
- 机器人名称：AI 助手
- 机器人图标：上传
- 消息接收地址：
https://your-server.com/webhook/dingtalk
步骤 4：权限配置
在「权限管理」中开通：
- ✅ 企业会话消息读权限
- ✅ 企业会话消息写权限
- ✅ 通讯录只读权限
- ✅ 成员信息读权限
步骤 5：配置 OpenClaw
# 设置钉钉连接
openclaw connect dingtalk
# 输入凭证
Client ID: dingxxxxxxxxxxxxxxx
Client Secret: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
# 启动服务
openclaw start
步骤 6：测试机器人
在钉钉群中 @机器人 发送消息：
@AI助手 你好
机器人应该回复：
你好！我是 AI 助手，有什么可以帮助你的？
常见问题
Q: 消息接收地址填什么？
需要是公网可访问的 HTTPS 地址。如果没有公网服务器：
# 使用 ngrok 内网穿透
ngrok http 3000
# 将生成的 https://xxx.ngrok.io 填入
Q: 机器人不回复？
检查清单：
- 权限是否开通
- 服务是否启动
- 网络是否可达
- 日志是否有错误
# 查看日志
openclaw logs -f
Q: 如何支持图片消息？
需要在钉钉开放平台开通「图片消息」权限，并在 OpenClaw 配置中启用。
高级配置
多群支持
机器人默认支持所有群，可以通过配置限制：
# ~/.openclaw/config.yaml
dingtalk:
allowed_chats:
- chat_id_1
- chat_id_2
自定义欢迎语
dingtalk:
welcome_message: |
欢迎加入！我是 AI 助手。
有问题随时 @我
工作时间限制
dingtalk:
work_hours:
start: "09:00"
end: "18:00"
timezone: "Asia/Shanghai"
需要帮助？
- 📖 完整文档：https://docs.openclaw.ai
- 💬 技术支持：
- 基础接入：¥99
- 高级配置：¥299
- 企业定制：¥999
联系：微信 yang1002378395 或 Telegram @yangster151