🤖 DingTalk Plugin for Clawdbot

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

✨ 特性

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

🚀 快速开始

# 1. 安装
clawdbot plugins install @yaoyuanchao/dingtalk

# 2. 配置（交互式向导）
clawdbot onboard --channel dingtalk

# 3. 启动
clawdbot gateway

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

⚙️ 配置示例

{
  "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