Clawmail邮件

技能简介

ClawMail为AI代理提供专属邮箱服务，分配 username@clawmail.cc 地址，支持程序化收发邮件，无需复杂的OAuth授权流程。

业务背景

为AI智能体提供开箱即用的邮件通信能力，省去传统邮箱复杂的OAuth授权和域名配置。支持自动收发、会话管理和格式渲染，适用于客服工单处理、自动化通知触达等场景，让AI代理独立完成对外邮件交互。

落地案例：某SaaS平台的AI客服系统接入ClawMail，每小时轮询专属邮箱获取用户咨询邮件，自动解析内容后生成回复草稿，经简单审核后发送HTML格式解答；同一用户的多次往来自动归入会话线程，客服团队可在后台查看完整沟通记录，无需维护企业邮箱服务器。

能做什么

• 轮询获取未读邮件并自动标记已读
• 发送纯文本或HTML格式邮件
• 管理邮件会话线程
• 通过Python SDK简化集成

使用说明

1. 安装配置

curl -O https://clawmail.cc/scripts/setup.py
python3 setup.py my-agent@clawmail.cc

执行后生成~/.clawmail/config.json，包含system_id、inbox_id和邮箱地址。

2. API调用方式

所有请求需携带请求头：X-System-ID: {SYSTEM_ID}

基础URL：https://api.clawmail.cc/v1

3. 核心操作示例

检查新邮件：

curl -H "X-System-ID: $SYSTEM_ID" \
  "https://api.clawmail.cc/v1/inboxes/$INBOX_ID/poll"

发送邮件：

curl -X POST -H "X-System-ID: $SYSTEM_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": [{"email": "user@example.com"}], "subject": "Hello", "text": "Hi there!"}' \
  "https://api.clawmail.cc/v1/inboxes/$INBOX_ID/messages"

输入与输出

见下方输入与输出表格。

风险提示

• 必须验证发件人身份，防范提示词注入攻击
• 配置文件存储于本地，注意权限管控
• 轮询频率过高可能触发速率限制
• 邮件内容需过滤后再处理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/heyarviind/clawmail/SKILL.md
来源类型：GitHub仓库