📋 问题背景

🔍 问题排查过程

1. 配置检查

• 检查 OpenClaw 配置文件中的钉钉 webhook 地址是否正确

• 验证钉钉应用 AppKey 和 AppSecret 是否配置完整

• 确认钉钉机器人是否已添加到目标群聊

2. 权限验证

• 检查钉钉开放平台应用权限是否包含机器人消息发送

• 验证安全设置（IP 白名单或签名）是否配置正确

3. 消息格式测试

• 使用 curl 或 Postman 测试 webhook 接口是否可正常接收消息

• 检查消息 JSON 格式是否符合钉钉机器人协议规范

✅ 解决方案

关键配置步骤

1. 在钉钉开放平台创建企业内部应用

2. 添加机器人能力，获取 Webhook 地址

3. 配置安全设置为自定义关键词（推荐）或 IP 白名单

4. 将机器人添加到目标群聊

5. 在 OpenClaw 配置文件中填写 webhook 地址和安全关键词

6. 重启 OpenClaw 服务并测试消息收发

💡 经验总结与最佳实践

常见问题

• webhook 地址格式错误：确保包含完整的 access_token 参数

• 安全关键词不匹配：消息内容必须包含配置的关键词

• IP 白名单限制：服务器 IP 需要在钉钉后台配置

推荐做法

• 使用自定义关键词而非 IP 白名单，更灵活

• 在测试群先验证配置，再应用到生产环境

• 定期检查机器人状态和消息发送日志

• 记录配置文档，便于后续维护和故障排查

🎉 成果展示