Skillppx logo

Dingtalk

将 OpenClaw 与钉钉连接，实现消息收发与自动化通信。

已扫描
适合谁
企业IT管理员、自动化流程开发者
不适合谁
个人用户日常使用、无钉钉企业账号者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @chayjan/dingtalk
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

钉钉频道插件（DingTalk Channel Plugin for OpenClaw）

将 OpenClaw 连接到钉钉（DingTalk），实现企业级消息通信。

功能特性

  • 通过钉钉 API 发送和接收消息
  • 支持内部应用及 webhook 机器人
  • 支持私聊与群聊策略配置
  • 支持用户白名单机制

配置方式

方法一：环境变量

export DINGTALK_CLIENT_ID="your-app-key"
export DINGTALK_CLIENT_SECRET="your-app-secret"

方法二：配置文件

openclaw config --section channels
# 选择钉钉并按提示操作

或手动编辑配置文件：

channels:
  dingtalk:
    enabled: true
    clientId: "ding6kntxc33nvloty5z"
    clientSecret: "your-secret"
    dmPolicy: "allowlist"  # 可选值："allowlist"、"open"、"pairing"
    allowFrom:
      - "user001"
      - "user002"
    groupPolicy: "allowlist"  # 可选值："allowlist"、"open"、"disabled"
    groupAllowFrom:
      - "chat001"

方法三：Webhook 机器人（群聊使用）

适用于群机器人 webhook 场景：

channels:
  dingtalk:
    enabled: true
    webhookUrl: "https://oapi.dingtalk.com/robot/send?access_token=xxxxx"
    webhookSecret: "SECxxxxx"  # 可选，用于签名验证

获取凭证

  1. 访问 [钉钉开放平台](https://open.dingtalk.com)
  2. 创建微应用或内部机器人
  3. 复制 App Key 和 App Secret
  4. 对于内部应用，请确保已开启以下权限：

- 通讯录读取（联系人管理）

- 工作通知发送（消息通知）

使用说明

发送消息

await message({
  channel: "dingtalk",
  target: "user-id",
  text: "Hello from OpenClaw!"
});

接收消息

需将钉钉回调地址指向你的 OpenClaw 网关：

https://your-gateway/webhook/dingtalk

API 参考文档

  • [钉钉开放平台 API 概览](https://open.dingtalk.com/document/isv/server-api-overview)
  • [机器人 Webhook API](https://open.dingtalk.com/document/isv/group-robot)

常见问题排查

**错误：invalid timestamp**

  • 检查系统时间是否同步

**错误：app not authorized**

  • 确保应用已在钉钉管理后台中具备所需权限

**错误：ip not in whitelist**

  • 将 OpenClaw 网关的 IP 地址添加至钉钉应用的 IP 白名单中

开发说明

本插件处于测试阶段（beta）。如遇问题，请提交至：https://github.com/openclaw/openclaw

许可证

MIT

C
@chayjan

已收录 1 个 Skill

相关推荐