agentmail

agentmail

用途

此技能可让 AI Agent 通过 AI 驱动的自动化自主管理电子邮件，包括分类、起草回复和安排发送时间，从而高效处理邮件。

适用场景

当需要处理大量邮件的收件箱、自动化客户支持、个人效率工作流，或将邮件任务集成到更广泛的 AI Agent 操作中以减少人工干预时，可使用此技能。

主要功能

• 使用机器学习模型，根据内容、发件人或关键词对邮件进行分类。
• 使用可自定义的模板和语气调整来起草回复邮件。
• 根据用户定义的规则或日历集成安排邮件发送或后续跟进。
• 根据条件汇总、设置优先级或归档邮件，以管理邮件会话。
• 通过 API 与电子邮件服务商集成，实现实时操作。

使用模式

要使用 agentmail，可通过 CLI 或 API 调用，并传入必要参数，例如邮件 ID 或内容。务必通过环境变量 $AGENTMAIL_API_KEY 设置 API 密钥。使用 CLI 时，在命令前添加身份验证标志。示例流程：获取一封邮件，对其分类，起草回复，然后在需要时安排发送时间。可在脚本中串联命令以实现自动化。

常用命令/API

CLI 命令需要 Node.js 环境；通过 npm install agentmail-cli 安装。API 端点位于 https://api.openclaw.com/agentmail/v1。

• 对邮件进行分类：
  CLI：agentmail classify --email-id 12345 --key $AGENTMAIL_API_KEY
  API：使用 JSON 请求体向 /api/agentmail/classify 发送 POST 请求：{"email_id": "12345", "api_key": "$AGENTMAIL_API_KEY"}
  代码片段：

  curl -X POST https://api.openclaw.com/agentmail/v1/classify \
  -H "Content-Type: application/json" \
  -d '{"email_id": "12345", "api_key": "'$AGENTMAIL_API_KEY'"}'
  

• 起草回复：
  CLI：agentmail draft --email-id 12345 --tone professional --key $AGENTMAIL_API_KEY
  API：使用请求体 {"email_id": "12345", "tone": "professional", "api_key": "$AGENTMAIL_API_KEY"} 向 /api/agentmail/draft 发送 POST 请求
  代码片段：

  const response = await fetch('https://api.openclaw.com/agentmail/v1/draft', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({email_id: '12345', tone: 'professional', api_key: process.env.AGENTMAIL_API_KEY})
  });
  

• 安排邮件发送：
  CLI：agentmail schedule --email-content "Reply text" --send-at "2023-10-01T10:00:00Z" --key $AGENTMAIL_API_KEY
  API：使用请求体 {"email_content": "Reply text", "send_at": "2023-10-01T10:00:00Z", "api_key": "$AGENTMAIL_API_KEY"} 向 /api/agentmail/schedule 发送 POST 请求
  配置格式：使用 JSON 设置发送规则，例如 {"rules": [{"condition": "priority>high", "action": "schedule in 2 hours"}]}。

集成说明

在配置文件中提供 OAuth 令牌（例如 config.json: {"provider": "gmail", "token": "$GMAIL_TOKEN"}），即可将 agentmail 与 Gmail 或 Outlook 等电子邮件服务集成。对于 AI Agent 工作流，可使用 webhook 在收到新邮件时触发操作（例如向 /api/agentmail/webhook 发送 POST 请求）。请确保 API 版本匹配，并处理 Node.js v14+ 等依赖项。若要与其他技能组合使用，可将结果导出为 JSON 并传递给下一个命令，例如 agentmail classify ... | jq '.category' | other-skill-process。

错误处理

检查 HTTP 状态码：401 表示身份验证失败（使用 $AGENTMAIL_API_KEY 重试），404 表示邮件不存在（记录日志并跳过），500 表示服务器错误（采用指数退避）。在 CLI 中使用 --verbose 标志查看详细日志。通过添加延迟（例如，在收到 429 响应后等待 5 秒）处理速率限制等常见问题。调用前验证输入，例如使用正则表达式检查邮件 ID 是否为字符串：if (!emailId.match(/^\d+$/)) throw new Error('Invalid email ID');。在脚本中使用 try-catch，以便在出错时妥善恢复。

具体用法示例

1. 分类并回复支持工单邮件： 首先进行分类：agentmail classify --email-id 67890 --key $AGENTMAIL_API_KEY。如果分类结果为“support”，则撰写草稿：agentmail draft --email-id 67890 --tone helpful --key $AGENTMAIL_API_KEY。然后安排发送：agentmail schedule --email-content $(cat response.txt) --send-at now --key $AGENTMAIL_API_KEY。这能在服务台工作流中自动处理工单回复。

2. 管理个人邮件的发送安排： 通过 API 获取未读邮件并进行分类：curl -X POST https://api.openclaw.com/agentmail/v1/classify -d '{"email_id": "54321", "api_key": "'$AGENTMAIL_API_KEY'"}'。对于高优先级邮件，撰写草稿并安排发送：agentmail draft --email-id 54321 --tone formal --key $AGENTMAIL_API_KEY; agentmail schedule --email-content "Follow up" --send-at "tomorrow" --key $AGENTMAIL_API_KEY。可在每日脚本中使用，实现收件箱清零。

图谱关系

• 相关类别：email（直接相关）、ai（集群）、agent（集群）、automation（标签）。
• 关联集群：community（与此技能相同）。
• 依赖项：可能需要“email-parser”等技能进行输入预处理，或使用“scheduler”进行高级定时安排。