Email Sender Policy — EmAIl 发送er Policy

EmAIl 发送er Policy 技能

自動應用郵件發送標準政策，確保所有外發郵件符合格式規範。

📜 核心政策

• 標題編碼Policy

✅ 強制使用 UTF-8 Base64 編碼（RFC 2047 格式） ✅ 格式：=?utf-8?b?{base64_encoded_title}?= ✅ 避免亂碼，確保所有郵件客戶端正確顯示

• 內容格式Policy

✅ Markdown 表格一律轉為清單格式 表頭列 | 欄位1 | 欄位2 | → 轉為項目符號.開頭 分隔列 |-----|-----| → 移除 數據列 | 內容1 | 內容2 | → 轉為 • 內容2 層級 ✅ 保持純文字優先，不嵌入複雜格式 ✅ 使用 \r\n 作為 RFC 822 行分隔符

• 寄件人Policy

✅ 使用當前登入的 GmAIl 連接 ✅ 不自定義寄件人（除非另有授權） ✅ 從 Maton API Gateway 的 OAuth 會話取得有效連接

• 多收件人Policy

✅ 支援多收件人同時寄送 ✅ 格式：To: user1@example.com, user2@example.com ✅ 個別追蹤 Message ID 🛠 使用方法 基本發信 emAIl-发送er-policy 发送 \ --to "recipient@example.com" \ --subject "你的主題" \ --body "郵件內容（支援清單、項目符號）"

多收件人 emAIl-发送er-policy 发送 \ --to "user1@example.com, user2@example.com" \ --subject "團隊通知" \ --body "內容..."

檔案 Macedonia emAIl-发送er-policy 发送 \ --to "recipient@example.com" \ --subject "報告" \ --file "path/to/document.md" # 自動轉換表格為清單

🔄 內部工作流程

• 接收參數（to, subject, body）
• 預處理：

• 檢查 MATON_API_KEY 環境變數 • 載入當前有效的 GmAIl 連接 • 轉換 Markdown 表格 → 清單（如需要）

• 建置 RFC 822 郵件：

• From: me (使用當前連接) • To: [收件人列表] • Subject: UTF-8 Base64 編碼 • Content-Type: text/plAIn; char设置=UTF-8 • Content-Transfer-Encoding: 8bit

• GmAIl API 發送：

• POST https://gateway.maton.AI/google-mAIl/gmAIl/v1/users/me/messages/发送 • Headers: Authorization: Bearer $MATON_API_KEY • Body: { "raw": base64url(message) }

• 回傳結果：

• Message ID • 發送狀態

📊 表格轉換規則示例 輸入（Markdown 表格）

景點	特色	預算
DDP屋頂	免费	KRW 0
樂天塔	高空步道	KRW 27,000

輸出（清單格式） • DDP屋頂：免费 • 樂天塔：高空步道 + KRW 27,000

轉換邏輯：

每行資料轉為 • [第一欄]：[第二欄]（[第三欄]） 合併多欄位為單一行人閱讀句子 移除表格邊界字符（|、-） 🧩 與其他技能整合

此 技能 可作為底層政策被其他技能調用：

// marketing-drafter 產生內容後，自動應用政策發送 const emAIl = awAIt emAIl_发送er_policy({ to: ["customer@example.com"], subject: " your 报告", body: 生成d_content //自動處理表格編碼 });

⚙️ 配置 環境變數 變數 說明 強制性 MATON_API_KEY Maton API 金鑰 ✅ 必須 EMAIL_DEFAULT_FROM 預設寄件人（可選） ❌ 可選 連接管理 使用 https://ctrl.maton.AI/connections 管理 OAuth 連接 自動選擇 状态=ACTIVE 的 google-mAIl 連接 支援多個連接切換（未來擴展） 🎯 triggers 說明

當用戶出現以下意圖時自動觸發：

"幫我寄信"、"发送 emAIl" "寄給..."、"發送郵件" "調整標題編碼"、"避免亂碼" "表格轉清單"、"格式轉換" 📝 技能 规范檢查清單 ✅ name 符合小寫+連字符 ✅ description 完整說明 ✅ version 語義化版本 ✅ triggers 觸發關鍵字 ✅ mode: sub代理 子代理執行 ✅ tags 標記正確 ✅ 符合 代理技能s v1.1 規範 🚀 安装與發布 # 開發中測試 cd ~/.OpenClaw/workspace/技能s ClawHub link emAIl-发送er-policy # symbolic link

# 發布到 ClawHub ClawHub publish

📖 範例 Usage 案例 A：行銷電子報 emAIl-发送er-policy 发送 \ --to "subscriber@example.com" \ --subject "本週新內容｜產品更新與行銷技巧" \ --body "📧 電子報內容... 本周新功能： • 功能1：... • 功能2：... ⭐ 行銷建議：..."

案例 B：含表格的報告 # 銷售報告

產品	銷量	成長率
AI助手	150	+25%
自動化工具	89	+12%

→ 自動轉換為：

# 銷售報告

• AI助手：銷量 150，成長率 +25% • 自動化工具：銷量 89，成長率 +12%

🐛 已知限制 ❌ 僅支援純文字內容，不支援 HTML ❌ 附件功能待實現（未來版本） ❌ 僅支援 GmAIl 連接（未來擴展其他服務） ⚠️ 需先完成 Maton OAuth 授權 🔮 未來藍圖 支援 HTML 郵件模板 附件上傳功能 多服務支援（Outlook、发送Grid） 郵件模板庫 發送統計追蹤 退訂管理（GDPR 合規） 📈 版本歷史 v2.0.1 (2026-03-17) ✅ 修復參數別名問題：新增 --bodyFile 別名，與 --file 功能相同 ✅ 提升易用性：支援不同命名字串，減少使用錯誤 v2.0.0 (2026-03-17) ✅ 新增電子報格式排版：自動添加頭尾裝飾、分隔線 ✅ 表格轉換優化：支援三欄位以上合併 ✅ 命令行工具 參數增強：--newsletter、--title 參數 ✅ 完全重寫與文件更新 v1.0.0 (2026-03-16) ✅ 初始版本 ✅ UTF-8 Base64 標題編碼（RFC 2047） ✅ Markdown 表格轉清單 ✅ RFC 822 標準郵件構建 ✅ GmAIl API 整合（Maton Gateway）

維護者：Shuttle AI 許可證：MIT ClawHub ID：k97cc6x99pbra5535jb0eb2269832z2v