临时邮箱插件:一次性电子邮件管理 - Openclaw Skills

作者:互联网

2026-04-15

AI快讯

什么是 temp-mail?

temp-mail 插件是专为需要一次性电子邮件功能的开发人员和 AI 代理设计的专业工具。通过利用 Vortex API 后端,此 Openclaw Skills 集成允许无缝创建随机前缀地址、实时消息轮询和自动邮箱清理。对于在自动化测试或研究任务期间需要绕过个人电子邮件要求的开发人员来说,它特别有价值。

该插件提供了一个基于 Python 的界面来与托管的 Vortex 实例进行交互,确保用户无需人工干预即可处理验证码和魔术链接。作为 Openclaw Skills 更广泛生态系统的一部分,它提供了一种编程方式来管理临时收件箱从创建到删除的生命周期。

下载入口:https://github.com/openclaw/skills/tree/main/skills/techwithanirudh/temp-mail

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install temp-mail

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 temp-mail。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

temp-mail 应用场景

  • 在端到端测试环境中自动化用户注册和登录流程。
  • 接收并提取用于浏览器自动化的验证码或身份验证链接。
  • 在不占用生产收件箱的情况下测试电子邮件传递和内容格式。
  • 在 Openclaw Skills 工作流中通过为一次性服务交互使用唯一的一次性地址来增强隐私。
temp-mail 工作原理
  1. 用户或代理使用 create 命令生成一个新邮箱,该命令在指定域名下生成一个随机的前缀。
  2. 生成的地址提供给需要电子邮件输入的外部服务。
  3. 该插件使用 fetch 或 poll 命令查询 Vortex HTTP API 以获取传入消息。
  4. 如果使用轮询,脚本将等待直到消息到达或达到预定义的超时时间。
  5. 检索到必要的数据后,使用 clear 命令清除临时地址中的所有消息。

temp-mail 配置指南

要将此插件集成到您的 Openclaw Skills 环境中,请确保您已使用 Python 或 uv 包管理器安装了必要的依赖项。

# 通过 pip 安装依赖项
python -m pip install -r scripts/requirements.txt

# 或使用 uv 直接运行以获得临时环境
uv run scripts/temp_mail.py create

您可以通过分别设置 VORTEX_DOMAIN 和 VORTEX_URL 环境变量来覆盖默认域名或 API 端点。

temp-mail 数据架构与分类体系

temp-mail 插件通过 Vortex API 管理数据,侧重于邮箱元数据和邮件内容。下表描述了主要数据元素:

属性 描述
电子邮件地址 由随机前缀和选定域名组成的完整地址。
邮件列表 与特定地址关联的传入电子邮件数组。
API 端点 用于 GET 和 DELETE 请求的 Vortex 实例 URL。
超时 脚本在轮询操作期间等待的秒数。
name: temp-mail
description: Temporary email helper backed by Vortex (vortex.email). Use when needing disposable addresses for signup flows: create a mailbox (random localpart), poll for messages, fetch and clear mailboxes.
homepage: https://vortex.skyfall.dev
metadata: {"clawdis":{"emoji":"??","requires":{"bins":["curl"]}}}

temp-mail skill

This skill provides a Python CLI script to interact with the hosted Vortex API (GET /emails/{email}, DELETE /emails/{email}/clear).

Usage examples (scripts are in scripts/):

  • create: generates a random localpart and prints an address for the provided domain
  • fetch: queries the Vortex HTTP API to list messages for an address
  • poll: wait until messages arrive or timeout
  • clear: delete all messages for an address

Run with uv: uv run {baseDir}/scripts/temp_mail.py (script includes shebang and metadata header similar to the hn skill)

Examples:

# generate a random address
uv run {baseDir}/scripts/temp_mail.py create

# fetch messages for an address
uv run {baseDir}/scripts/temp_mail.py fetch alice@dash.dino.icu

# poll until messages arrive (timeout 60s)
uv run {baseDir}/scripts/temp_mail.py poll alice@dash.dino.icu --timeout 60

# clear mailbox
uv run {baseDir}/scripts/temp_mail.py clear alice@dash.dino.icu

Defaults:

  • VORTEX_URL: https://vtx-api.skyfall.dev
  • default domain: skyfall.dev (override with VORTEX_DOMAIN env var)

Install

# create a venv and install deps (unix)
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r scripts/requirements.txt

# or using uv which creates an ephemeral venv for you, e.g.
uv run {baseDir}/scripts/temp_mail.py create

Notes:

  • script uses httpx for requests; rich is optional and omitted from requirements
  • random username generation mirrors the frontend behavior (lowercase alphanumeric), attempted to replicate falso randUserName behavior
  • hosted instance includes multiple domains, e.g., dash.dino.icu, skyfall.dev, etc. When creating addresses, choose a domain from that list or let the script use the default

相关推荐