| name | dingtalk-file-sender |
| description | 用于通过钉钉API发送文件给指定用户。当用户需要将生成的文档、报告、图片等文件发送到钉钉时，使用此skill。
适用场景：
- 用户要求"把XX文件发送到钉钉"
- 用户需要"通过钉钉发送文件"
- 生成报告后需要分享给钉钉用户
- 任何需要将本地文件推送到钉钉的场景
此skill使用钉钉企业内部应用API（需要AgentID）或Webhook方式发送文件。
触发关键词：钉钉发送、发送到钉钉、dingtalk send、推送到钉钉、分享至钉钉
|
DingTalk File Sender Skill
用于通过钉钉API向指定用户发送文件的skill。
使用前提
- 钉钉应用配置：需要在
/root/.env 文件中配置以下环境变量：
DINGTALK_CLIENT_ID - 钉钉应用的Client IDDINGTALK_CLIENT_SECRET - 钉钉应用的Client SecretDINGTALK_AGENT_ID - 钉钉应用的Agent ID（用于企业内部应用方式）DINGTALK_OWNER_USERID - 默认接收用户的UserID
发送文件流程
方式一：企业内部应用（推荐）
适用于有钉钉企业内部应用权限的场景，支持发送文件、图片、语音等多种消息类型。
node /root/.config/opencode/skills/dingtalk-file-sender/scripts/send_file.js <文件路径> [用户ID]
参数说明：
<文件路径>：要发送的文件完整路径（必需）[用户ID]：接收者的钉钉UserID（可选，默认为env中的DINGTALK_OWNER_USERID）
示例：
node /root/.config/opencode/skills/dingtalk-file-sender/scripts/send_file.js /tmp/report.docx
node /root/.config/opencode/skills/dingtalk-file-sender/scripts/send_file.js /tmp/data.xlsx 1601434517956472
方式二：Webhook机器人（文本/链接）
钉钉Webhook机器人不支持直接发送文件，只能发送文本、Markdown或链接。
如需发送文件内容，可以：
- 将文件上传到云存储获取链接
- 发送Markdown格式的链接消息
支持的文件类型
- 文档：.docx, .doc, .pdf, .txt, .md
- 表格：.xlsx, .xls, .csv
- 图片：.jpg, .jpeg, .png, .gif, .bmp
- 其他：任意文件类型（通过file消息类型发送）
实现细节
发送流程
-
获取AccessToken
GET https://oapi.dingtalk.com/gettoken?appkey={CLIENT_ID}&appsecret={CLIENT_SECRET}
-
上传媒体文件
POST https://oapi.dingtalk.com/media/upload?access_token={ACCESS_TOKEN}&type=file
-
发送消息
POST https://oapi.dingtalk.com/message/send?access_token={ACCESS_TOKEN}
消息类型
file - 文件消息（本skill默认使用）image - 图片消息text - 文本消息markdown - Markdown消息
错误处理
常见错误码：
40012 - 缺少sender参数（使用了错误的API端点）41011 - 缺少agentid参数（需要在.env中配置DINGTALK_AGENT_ID）40014 - AccessToken失效或无效40035 - 媒体文件不存在或上传失败
环境变量示例
export DINGTALK_CLIENT_ID="dingxxxxxxxxx"
export DINGTALK_CLIENT_SECRET="xxxxxxxxxxxx"
export DINGTALK_AGENT_ID="123456789"
export DINGTALK_OWNER_USERID="1601434517956472"
脚本位置
主要脚本：/root/.config/opencode/skills/dingtalk-file-sender/scripts/send_file.js
使用方法详见脚本内注释。
