钉钉机器人接入指南

让 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

dingtalk-connector-guide

Safety Notice

Copy this and send it to your AI assistant to learn