dingtalk-message

What This Skill Does

The dingtalk-message skill is a powerful automation tool designed to bridge OpenClaw AI agents with the DingTalk enterprise communication ecosystem. It serves as a unified gateway for all DingTalk-related messaging operations, enabling users to send, manage, and monitor communications programmatically. The skill abstracts the complexity of multiple API channels, allowing the agent to intelligently route requests between Webhook robots, enterprise internal application bots, and the formal 'Work Notification' system. It supports advanced features such as Markdown formatting, ActionCard interactions, @-mentioning colleagues, message withdrawal, and read-status tracking.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/breath57/dingtalk-message

Ensure that you have your relevant DingTalk developer credentials ready, as the skill will prompt you to configure necessary keys and tokens upon the first execution. It is designed to cache these securely within your environment to optimize performance and minimize redundant authentication requests.

Use Cases

• Automated Alerts: Send instant notifications to project groups whenever a CI/CD build fails or a critical system error is logged.
• Workplace Productivity: Push task assignments or approval requests directly to employees' 'Work Notification' center via enterprise internal apps.
• Interactive Communication: Utilize ActionCard messages in group chats to gather team feedback or prompt users to click through to internal company URLs.
• Message Lifecycle Management: Automatically withdraw sensitive information posted by mistake or monitor read receipts to ensure team members have acknowledged urgent broadcasts.

Example Prompts

1. "钉钉消息：请在项目群里提醒 @张三 查看最新的技术规格文档，并附上链接 https://doc.example.com。"
2. "发一条工作通知给财务部门，内容是：请于本周五前完成财务报表核对。"
3. "撤回刚才在部门群里发的那条包含错误数据的机器人消息。"

Tips & Limitations

• Security: Always prefer using the 'Secret' signing mode for Webhook robots to ensure the integrity of your incoming payloads.
• Authentication: The skill caches your Access Tokens locally in ~/.dingtalk-skills/config to adhere to DingTalk's rate limits; ensure this file's permissions are properly restricted.
• Execution: For complex message payloads, the skill utilizes bash script templates to handle variables safely. Avoid trying to trigger multi-line commands through simple string inputs to prevent truncation issues.
• Missing Content: If you trigger the skill without specifying content, the agent will prompt you for input rather than sending a blank message or generating unsolicited test data.