dingtalk-message

钉钉消息发送技能

概述

支持两种接入方式：

• Webhook 自定义机器人：通过 access_token 向群聊发送消息，接入简单
• 企业内部机器人：通过 app_key/app_secret 发送单聊、群聊消息，功能更全

支持多机器人管理，只有一个时自动使用，多个时按优先级自动选择。

环境要求

• Python 3.7+
• pip install requests

首次配置

引导流程

首次使用此技能时，必须按以下流程引导用户完成配置：

1. 询问用户的机器人类型和凭证信息：

   • Webhook 机器人：需要 access_token（和可选的加签密钥 secret）
   • 企业内部机器人：需要 app_key、app_secret、robot_code（和可选的 agent_id）

2. 执行配置命令：python scripts/dingtalk.py robot-add --name "机器人名" --type webhook ...

3. 验证配置：python scripts/dingtalk.py config --show

配置文件路径

配置统一存储在系统配置目录，所有 AI agent 共享，无需重复配置：

平台	配置文件	状态文件
macOS / Linux	~/.config/dingtalk/config.json	~/.config/dingtalk/state.json
Windows	%APPDATA%\dingtalk\config.json	%APPDATA%\dingtalk\state.json

手动编辑配置文件

也可直接编辑配置文件，每个机器人用 name 标识（建议用群名、用途等有意义的名称），description 描述用途，方便智能匹配：

{
    "default_robot": "技术告警群",
    "robots": [
        {
            "name": "技术告警群",
            "type": "webhook",
            "description": "发送技术告警到后端技术群",
            "webhook_token": "你的access_token",
            "webhook_secret": ""
        },
        {
            "name": "内部通知机器人",
            "type": "app",
            "description": "企业内部机器人，支持单聊和群聊",
            "app_key": "你的AppKey",
            "app_secret": "你的AppSecret",
            "robot_code": "你的机器人编号",
            "agent_id": ""
        }
    ]
}

webhook_token 填 access_token 即可，脚本自动拼接完整 URL。

通过命令行添加

# 添加 Webhook 机器人
python scripts/dingtalk.py robot-add --name "技术告警群" --type webhook --webhook-token "access_token_xxx" --desc "发送告警到后端技术群"

# 添加企业内部机器人
python scripts/dingtalk.py robot-add --name "内部通知" --type app --app-key dingxxx --app-secret xxx --robot-code robot-xxx --desc "支持单聊群聊"

验证配置

python scripts/dingtalk.py config --show

机器人管理

选择逻辑

• 只配置一个机器人时，自动使用
• 多个机器人时：--robot 指定 > default_robot > 最近使用过的 > 第一个可用的
• 用户未明确指定时，可根据机器人的 description 和最近消息记录智能匹配，或询问用户

管理命令