Dingtalk Push

What This Skill Does

The Dingtalk Push skill is a powerful automation tool designed for OpenClaw agents to interface seamlessly with Dingtalk group robots. It acts as a bridge between your automated workflows and real-time team communication. By utilizing Dingtalk's Webhook API, this skill allows users to trigger notifications, alerts, and system status updates directly from the command line, scripts, or natural language prompts within OpenClaw. It handles Markdown rendering for rich text, supports advanced security through message signing (Secret keys), and includes native support for tagging specific users or broadcasting to all members, ensuring that critical messages reach the intended audience promptly.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/andrewqumm/dingtalk-push

Once installed, ensure you configure your credentials to enable secure communication. Navigate to your configuration file at ~/.config/dingtalk-push/config.json and provide your DINGTALK_WEBHOOK URL and the corresponding DINGTALK_SECRET if your group robot requires security verification. This setup ensures that your agent can authenticate successfully with the Dingtalk servers.

Use Cases

• DevOps Alerts: Automatically send deployment success or failure logs to your team's DevOps channel.
• Automated Reporting: Schedule daily data summaries or business KPIs to be pushed to leadership groups.
• System Monitoring: Receive instant notifications when a background task fails, a server experiences high load, or a critical security event is detected.
• Workflow Notifications: Use it as a callback mechanism in complex automation chains, notifying users when an agent completes a long-running process like data scraping or file processing.

Example Prompts

• "Send a Dingtalk message to the team saying the nightly database backup has been completed successfully, use the success type."
• "Alert the team in the Dingtalk group with a warning message: The server CPU usage has exceeded 90%."
• "Notify everyone in the Dingtalk group that the system maintenance window is scheduled for tonight at 10 PM."

Tips & Limitations

• Security: Always use the DINGTALK_SECRET for production environments to prevent unauthorized message spoofing in your groups.
• Formatting: Since the skill supports Markdown, you can include links, bold text, and code blocks to make your notifications more readable.
• Rate Limiting: Be mindful of Dingtalk's API rate limits. Sending too many messages in a short burst may trigger a temporary block from the robot provider. If you have high-frequency logs, consider implementing a local queue or aggregation strategy.
• Environment Variables: If you are running multiple robots, you may need to override the configuration path or switch profiles using environment variables.