🤖 DingTalk Plugin for Clawdbot


让你的 AI 助手住进钉钉。无需公网域名，3 分钟搞定。

✨ 特性

- 🚀 Stream 模式 — 无需公网域名，内网即可用
- 💬 私聊 + 群聊 — 完整的消息收发支持
- 🖼️ 富媒体 — 图片、语音、视频、文件接收
- ⏳ 思考中提示 — 自动显示处理状态，完成后消失
- 🔒 访问控制 — 灵活的用户/群组白名单

🚀 快速开始

``bash

1. 安装

clawdbot plugins install @yaoyuanchao/dingtalk

2. 配置（交互式向导）

clawdbot onboard --channel dingtalk

3. 启动

clawdbot gateway
`

完事！去钉钉找机器人聊天吧。

⚙️ 配置示例

`json
{
"channels": {
"dingtalk": {
"enabled": true,
"clientId": "dingXXXXXXXXXXXX",
"clientSecret": "YOUR_SECRET",
"dm": {
"policy": "pairing",
"allowFrom": ["YOUR_STAFF_ID"]
}
}
}
}
`



📋 完整配置项

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| clientId | 钉钉应用 AppKey | - |
| clientSecret | 钉钉应用 AppSecret | - |
| dm.policy | 私聊策略: pairing/open/disabled | pairing |
| dm.allowFrom | 允许私聊的 staffId 列表 | [] |
| groupPolicy | 群聊策略: allowlist/open/disabled | allowlist |
| groupAllowlist | 允许的群 conversationId 列表 | [] |
| requireMention | 群聊是否需要 @机器人 | true |
| messageFormat | 消息格式: text/markdown/auto | auto |
| typingIndicator | 显示"思考中"提示 | true |
| longTextMode | 长文本处理: chunk/file | chunk |



🔑 获取凭证

1. 打开 钉钉开发者平台
2. 创建企业内部应用 → 添加机器人能力
3. 消息接收模式选 Stream 模式
4. 复制 AppKey (clientId) 和 AppSecret (clientSecret)
5. 发布应用

💡 获取 staffId

首次私聊机器人时会返回：
`
Access denied. Your staffId: 050914XXXXXXXXX
`
把这个 ID 加到 dm.allowFrom` 里，重启 gateway 即可。

📝 更新日志

v1.5.0 — 新增 Typing Indicator（思考中提示，自动撤回）

v1.4.x — 媒体消息支持、长文本文件发送

查看完整 CHANGELOG

📄 License

MIT