ClawMail邮件API

技能简介

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

能做什么

• 轮询获取未读邮件并自动标记已读
• 发送纯文本或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仓库