可将dify智能助理接入钉钉群作为ai小秘书，员工@即可查制度、问流程、催日报；需配置钉钉自定义机器人（加签安全）、获取dify api密钥与app_id、部署dify-on-dingtalk桥接服务、配置钉钉开放平台事件订阅并验证，最后测试@响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
把Dify上配置好的智能助理直接变成钉钉群里的AI小秘书，员工在群里@它就能查制度、问流程、催日报，不用跳转网页、不需额外登录。
创建并配置钉钉自定义机器人
打开目标钉钉群 → 点击右上角齿轮图标「设置」→ 滑动到底部点「智能群助手」→ 「添加机器人」→ 选择「自定义机器人」。
填写机器人名称，例如「HR政策小助手」；安全设置【必须选“加签”】，不要用“自定义关键词”，否则后续无法通过Dify调用钉钉卡片流式接口。
点击完成，页面会立即显示 access_token 和加签密钥（sign）。这两个值要一次性复制保存，关闭页面后无法再次查看。
获取Dify应用的API访问凭证
登录Dify控制台 → 进入对应智能助理（类型为「聊天」或「Agent」）→ 左侧菜单点击「访问API」→ 右上角点「API密钥」→ 「创建新密钥」。
密钥名称建议填「dingtalk-prod」，创建后系统生成一串长字符——这就是你的 【DIFY_API_KEY】，仅显示一次，务必立刻复制。
同时记下该应用的唯一标识符：在应用详情页URL中找到类似 `/apps/abc123def456` 的路径段，其中 `abc123def456` 就是应用ID（app_id），后续配置必需。
部署轻量级桥接服务 dify-on-dingtalk
这一步不需要自己写代码，直接用开源项目 dify-on-dingtalk 启动一个中间服务，它负责把钉钉消息转发给Dify、再把Dify响应转成钉钉AI卡片。
在服务器上执行：git clone https://github.com/zfanswer/dify-on-dingtalk && cd dify-on-dingtalk
复制 .env.example 为 .env，用文本编辑器打开，填入以下三项：
• DINGTALK_APP_KEY=你在钉钉开放平台创建应用时拿到的 Client ID
• DINGTALK_APP_SECRET=对应的 Client Secret
• DIFY_API_KEY=刚在Dify里复制的密钥
• DIFY_APP_ID=刚记下的应用ID
• DINGTALK_WEBHOOK_TOKEN=从机器人页面复制的 access_token
• DINGTALK_WEBHOOK_SIGN=从同一页面复制的加签密钥
保存后运行：pip install -r requirements.txt && python main.py。服务启动后监听 8000 端口，控制台出现 “Bot is running…” 即表示就绪。
配置钉钉开放平台的事件接收地址
登录钉钉开放平台 → 进入你创建的自建应用 → 左侧「开发管理」→ 「事件订阅」→ 「启用事件订阅」。
在「消息接收地址」栏填写：https://你的服务器公网IP:8000/callback（若无域名，需确保服务器8000端口已放行且有HTTPS证书；推荐用 nginx 反向代理+Let’s Encrypt自动续签）。
点击「验证」按钮，系统会向该地址发起 GET 请求校验签名。如果 dify-on-dingtalk 正常运行，验证将自动通过并显示绿色对勾。
测试群内@响应
回到钉钉群，发送一条消息：@你的机器人名称 “年假怎么算？”
等待 2～5 秒，机器人应以AI卡片形式返回结构化回答，顶部带打字机动画，内容支持换行、emoji、加粗等富文本效果。
若未响应，检查 dify-on-dingtalk 控制台日志是否报错；若提示“签名错误”，说明 DINGTALK_WEBHOOK_SIGN 或时间戳不同步，重新复制密钥并确认服务器时间与NTP同步。
