aliyun-mail

What This Skill Does

The aliyun-mail skill is a specialized communication tool designed for OpenClaw agents to interface directly with Aliyun enterprise email services. Unlike generic email scripts, this skill provides a robust pipeline for content transformation. It allows the agent to take raw data—such as reports, logs, or code snippets—and format them into professional emails. The core engine supports plain text, HTML, and rich Markdown, automatically rendering syntax highlighting for technical documentation. By utilizing SMTP, it ensures reliable delivery through Aliyun infrastructure while incorporating built-in retry logic to manage transient network failures, making it ideal for automated notification workflows.

Installation

To install this skill, use the ClawHub command: clawhub install openclaw/skills/skills/jixsonwang/aliyun-mail. Once installed, navigate to your OpenClaw configuration directory at /root/.openclaw/ and create a aliyun-mail-config.json file. Populate this file with your SMTP credentials, including the server address (smtp.mxhichina.com), port (465), and your secure app password. Crucially, secure this file immediately by running chmod 600 /root/.openclaw/aliyun-mail-config.json to ensure that only the owner has read and write access, protecting your credentials from unauthorized access on the local machine.

Use Cases

This skill is perfectly suited for automated reporting, system alerts, and collaborative workflows. Developers can use it to push build logs or debugging summaries directly from their terminal to a team email. Project managers can automate the delivery of generated reports or data-driven insights by attaching files created during previous agent steps. It bridges the gap between machine-generated analysis and human-readable communication, allowing for seamless distribution of intelligence across a project team.

Example Prompts

1. "OpenClaw, please email the latest performance report to [email protected] with the subject 'Weekly API Health Report' and attach the file /data/reports/weekly_stats.pdf."
2. "Send a follow-up email to the engineering team containing the following code fix, ensuring the Markdown format is preserved: [paste code here]."
3. "Summarize the recent server error logs and email them to the dev-ops alias with a high-priority flag and technical formatting."

Tips & Limitations

To maximize the utility of aliyun-mail, always use app-specific passwords generated in your email security settings rather than your primary login credentials. Note that the skill relies on the presence of the local configuration file; if the file is missing or contains invalid credentials, the skill will fail immediately. When sending large attachments, be mindful of your email service's individual file size limits, as the skill does not currently perform automatic compression or chunking of files. Always verify that your network environment allows outbound SMTP traffic on port 465 to ensure reliable connection to the Aliyun servers.