back
loading skill details...
Send Markdown-formatted messages with type and @mentions to DingTalk group chats via bot webhook with optional signature verification.
# skill: dingtalk-push
发送钉钉群聊机器人消息的技能。
## 触发条件
- 用户请求发送钉钉消息
- 定时任务需要推送通知到钉钉
- 需要集成钉钉群机器人到其他工作流
## 功能
- 发送 Markdown 格式消息到钉钉群
- 支持消息类型(success/warning/error/info)
- 支持 @指定人员和 @所有人
- 支持加签验证(安全)
## 使用方法
### 直接发送消息
在对话中直接使用:
```
发送钉钉消息 "定时任务完成"
发送钉钉 "服务器备份成功" --type success
通知钉钉群 "系统维护通知" --all
```
### 编程调用
```javascript
// 调用 skill 工具
const result = await tools.dingtalk_push({
message: "定时任务完成",
type: "success"
});
```
### 命令行调用
```bash
node skills/dingtalk-push/send.js -m "消息内容"
node skills/dingtalk-push/send.js -m "警告" --type warning
node skills/dingtalk-push/send.js -m "错误" --type error --all
```
## 配置
需要设置以下环境变量或配置文件:
- `DINGTALK_WEBHOOK` - 钉钉机器人Webhook地址
- `DINGTALK_SECRET` - 加签密钥(可选)
配置文件位置:`~/.config/dingtalk-push/config.json`
```json
{
"webhook": "https://oapi.dingtalk.com/robot/send?access_token=xxx",
"secret": "SEC_xxx"
}
```
## 消息类型
| 类型 | Emoji | 适用场景 |
|------|-------|----------|
| info | ℹ️ | 普通通知 |
| success | ✅ | 成功完成任务 |
| warning | ⚠️ | 警告、需要关注 |
| error | ❌ | 错误、异常 |
## 输出
返回发送结果:
```json
{
"success": true,
"messageId": "msg_xxx",
"timestamp": "2026-02-14T12:00:00Z"
}
```
## 依赖
- Node.js 16+
- axios (已内置在OpenClaw中)
don't have the plugin yet? install it then click "run inline in claude" again.