dingtalk-quickstart-cn（钉钉快速入门中文）

钉钉快速集成配置

目标：5 分钟内完成 OpenClaw + 钉钉集成，开始自动化办公。

🚀 快速开始（3 步）

第一步：创建钉钉机器人

1. 打开钉钉群 → 群设置 → 智能群助手 → 添加机器人
2. 选择「自定义」机器人
3. 填写信息：

- 机器人名称：OpenClaw Assistant - 机器人头像：自定义或默认

1. 安全设置（三选一）：

- 推荐：加签（Secret）— 最安全 - IP 地址（白名单） - 自定义关键词

1. 创建后记录：

- Webhook URL - Secret（如果选择了加签）

第二步：配置 OpenClaw

在 OpenClaw 配置文件 ~/.openclaw/config.yml 添加：

channels:
  dingtalk:
    enabled: true
    webhook: "https://oapi.dingtalk.com/robot/send?access_token=xxx"
    secret: "SECxxx"  # 可选，加签时需要

然后重启 OpenClaw：

openclaw gateway restart

第三步：测试发送

在 OpenClaw 对话中测试：

发送钉钉消息：测试成功，OpenClaw 已连接！

如果钉钉群收到消息，集成完成！

📋 常见使用场景

场景 1：自动发送每日简报

指令：

每天 8:00 发送钉钉消息：今日待办事项：[事项列表]

OpenClaw 会自动：

1. 读取待办事项
2. 生成简报
3. 定时发送到钉钉群

场景 2：监控告警通知

指令：

当服务器 CPU > 80% 时，发送钉钉告警消息

OpenClaw 会自动：

1. 监控服务器指标
2. 触发阈值时发送钉钉消息
3. 包含详细告警信息

场景 3：审批流程自动化

指令：

读取钉钉审批单 [单号]，自动处理并回复结果

OpenClaw 会自动：

1. 调用钉钉审批 API
2. 分析审批内容
3. 执行相应操作

🔧 高级配置

多机器人支持

如果需要管理多个钉钉群：

channels:
  dingtalk:
    enabled: true
    bots:
      - name: "开发群"
        webhook: "https://oapi.dingtalk.com/robot/send?access_token=xxx1"
        secret: "SECxxx1"
      - name: "运维群"
        webhook: "https://oapi.dingtalk.com/robot/send?access_token=xxx2"
        secret: "SECxxx2"

消息模板配置

创建自定义消息模板：

channels:
  dingtalk:
    templates:
      alert: |
        ### 🚨 告警通知
        **类型**：{type}
        **级别**：{level}
        **详情**：{detail}
        **时间**：{timestamp}
      daily: |
        ### 📅 每日简报
        **日期**：{date}
        **待办**：{todos}
        **提醒**：{reminders}

🐛 故障排查

问题 1：消息发送失败

错误：invalid webhook url

解决：

1. 检查 Webhook URL 格式
2. 确认机器人未被删除
3. 测试 URL 可达性：

   curl -X POST "YOUR_WEBHOOK_URL" \
     -H "Content-Type: application/json" \
     -d '{"msgtype":"text","text":{"content":"测试"}}'

问题 2：签名验证失败

错误：sign not match

解决：

1. 确认使用加签方式
2. 检查 Secret 是否正确
3. 确认时间戳在 1 小时内

问题 3：IP 白名单限制

错误：ip not in whitelist

解决：

1. 检查机器人 IP 白名单设置
2. 添加 OpenClaw 服务器 IP
3. 或改用加签方式（无需 IP 白名单）

📚 钉钉 API 参考

消息类型

文本消息：

{
  "msgtype": "text",
  "text": {
    "content": "这是一条文本消息"
  }
}

Markdown 消息：

{
  "msgtype": "markdown",
  "markdown": {
    "title": "Markdown 标题",
    "text": "### 标题\
**粗体**\
- 列表项"
  }
}

链接消息：

{
  "msgtype": "link",
  "link": {
    "title": "链接标题",
    "text": "链接描述",
    "messageUrl": "https://example.com",
    "picUrl": "https://example.com/icon.png"
  }
}

💰 定价参考

• 基础集成：¥99（机器人创建 + 消息发送）
• 企业定制：¥299（多机器人 + 模板 + 定时任务）
• 全托管服务：¥999/月（OpenClaw 托管 + 钉钉集成 + 技术支持）

🆘 获取帮助

• 钉钉开发文档：https://open.dingtalk.com/document
• OpenClaw 文档：https://docs.openclaw.ai
• OpenClaw 社区：https://discord.com/invite/clawd

创建时间：2026-03-21 作者：OpenClaw 中文生态 版本：1.0.0