by 详细分析 ▾
运行时依赖
版本
OpenClaw 钉钉通道插件——初始发布。 - 支持通过钉钉（钉钉）收发消息 - 同时支持内部应用与 webhook 机器人 - 可配置私聊/群聊策略与用户白名单 - 提供环境变量、配置文件或 webhook 三种设置方式 - 包含故障排查与凭据配置指南
安装命令
点击复制技能文档
# OpenClaw 钉钉频道插件 将 OpenClaw 连接至钉钉，实现企业级消息收发。 ## 功能特性 - 通过钉钉 API 收发消息 - 支持内部应用与 webhook 机器人 - 私聊与群聊策略 - 用户白名单支持 ## 配置 ### 方式 1：环境变量 ``bash export DINGTALK_CLIENT_ID="your-app-key" export DINGTALK_CLIENT_SECRET="your-app-secret" ` ### 方式 2：配置文件 `bash openclaw config --section channels # 选择 DingTalk 并按提示操作 ` 或手动编辑配置： `yaml channels: dingtalk: enabled: true clientId: "ding6kntxc33nvloty5z" clientSecret: "your-secret" dmPolicy: "allowlist" # 或 "open", "pairing" allowFrom: - "user001" - "user002" groupPolicy: "allowlist" # 或 "open", "disabled" groupAllowFrom: - "chat001" ` ### 方式 3：Webhook 机器人（群聊） 群机器人 webhook 配置： `yaml channels: dingtalk: enabled: true webhookUrl: "https://oapi.dingtalk.com/robot/send?access_token=xxxxx" webhookSecret: "SECxxxxx" # 可选，用于签名验证 ` ## 获取凭证 1. 访问 钉钉开放平台 2. 创建微应用或内部机器人 3. 复制 App Key 与 App Secret 4. 内部应用需确保拥有以下权限： - 通讯录管理（读取通讯录） - 工作通知（发送工作通知） ## 使用示例 ### 发送消息 `typescript await message({ channel: "dingtalk", target: "user-id", text: "Hello from OpenClaw!" }); ` ### 接收消息 将钉钉回调地址指向你的 OpenClaw Gateway： ` https://your-gateway/webhook/dingtalk `` ## API 参考 - 钉钉开放平台 - 群机器人 Webhook API ## 故障排查 错误："invalid timestamp" - 检查系统时间是否同步 错误："app not authorized" - 确保应用在钉钉管理后台已授予所需权限 错误："ip not in whitelist" - 将 OpenClaw Gateway 的 IP 加入钉钉应用 IP 白名单 ## 开发说明 本插件处于 beta 阶段。问题反馈地址： https://github.com/openclaw/openclaw ## 许可证 MIT