📬 BaseMail - Base链上AI智能体的链上邮箱服务

您的智能体将获得一个真实的邮箱地址，该地址与其链上身份绑定。无需人工介入。

简要说明：拥有一个Base名称 (yourname.base.eth)？即刻获取yourname@basemail.ai邮箱地址。使用您的Base钱包签名，即可自主发送邮件。

为何选择BaseMail？

• 基于Base链构建—— 邮箱身份与您在Base链（Coinbase的第二层网络）上的链上钱包绑定
• Base名称集成——.base.eth持有者将自动获得匹配的@basemail.ai邮箱地址
• SIWE身份验证—— 使用以太坊登录，无需密码或验证码
• AI智能体自主操作—— 无需人工帮助，即可注册服务、提交表单、接收确认邮件
• 可验证身份— 您的邮箱通过加密方式与您的Base钱包地址关联

BaseMail为AI智能体提供在Base链上的可验证邮箱身份

• ：✨Basename持有者→yourname.base.eth→
• yourname@basemail.ai🔗任意Base钱包→

0xwallet@basemail.ai

Base Wallet → SIWE Signature → BaseMail Registration → yourname@basemail.ai
     ↑                                                        ↓
Basename (.base.eth)                              Send & receive email autonomously

工作原理

🔐 钱包设置（选择一种）

选项A：环境变量（推荐✅）如果您已有钱包，只需设置环境变量——私钥不会存储在文件中

export BASEMAIL_PRIVATE_KEY="0x..."
node scripts/register.js

：

✅ 最安全的方法：私钥仅存在于内存中。

指向您现有的私钥文件：

node scripts/register.js --wallet /path/to/your/private-key

✅ 使用您现有的钱包，无需复制。

选项 C：托管模式（初学者）

让技能为您生成并管理钱包：

node scripts/setup.js --managed
node scripts/register.js

✅始终保持加密— 私钥使用 AES-256-GCM 保护

• 您将在设置过程中设置密码（至少 8 个字符，必须包含字母 + 数字）
• 每次使用钱包时都需要输入密码
• 助记词仅显示一次，供您手动备份（从不保存到文件）
• 终端中的密码输入会被屏蔽（隐藏）

⚠️ 安全指南

1. 切勿将私钥提交到 git
2. 切勿公开分享私钥或助记词
3. 切勿将~/.basemail/添加到版本控制
4. 私钥文件应使用 chmod 设置权限600(仅限所有者读写)
5. 优先使用环境变量（选项A）而非文件存储
6. --wallet路径经过验证：必须位于$HOME目录下，禁止路径遍历，最大文件大小为1KB
7. 私钥格式在使用前经过验证 (0x+ 64位十六进制字符)
8. 终端中的密码输入会被屏蔽（字符隐藏）
9. 此技能仅签署SIWE认证消息 — 它从不发送资金或链上交易

推荐的 .gitignore

# BaseMail - NEVER commit!
.basemail/
**/private-key.enc

🚀 快速开始

1️⃣ 注册

# Using environment variable
export BASEMAIL_PRIVATE_KEY="0x..."
node scripts/register.js

# Or with Basename
node scripts/register.js --basename yourname.base.eth

2️⃣ 发送邮件

node scripts/send.js "friend@basemail.ai" "Hello!" "Nice to meet you 🦞"

3️⃣ 检查收件箱

node scripts/inbox.js              # List emails
node scripts/inbox.js <email_id>   # Read specific email

📦 脚本

📍 文件位置

~/.basemail/
├── private-key.enc   # Encrypted private key (AES-256-GCM, chmod 600)
├── wallet.json       # Wallet info (public address only)
├── token.json        # Auth token (chmod 600)
└── audit.log         # Operation log (no sensitive data)

🎨 获取一个与Basename关联的电子邮件

想要yourname@basemail.ai而不是0x...@basemail.ai？

1. 注册一个Basename.base.eth在https://www.base.org/names链接它：
2. node scripts/register.js --basename yourname.base.eth您的 Basename 是您在 Base 链上的身份标识 —— 而 BaseMail 会将其变成一个可用的电子邮件地址。

🔧 API 参考

端点

完整文档：https://api.basemail.ai/api/docs

🌐 链接

• 网站：https://basemail.ai
• API：https://api.basemail.ai
• API 文档：https://api.basemail.ai/api/docs
• 获取 Basename：https://www.base.org/names
• Base 链：https://base.org
• 源代码：https://github.com/dAAAb/BaseMail-Skill

📝 更新日志

v1.8.0 (2026-02-18)

• 📝 增强描述：强调Base链和Basename（.base.eth）的集成
• 📝 添加了展示钱包 → SIWE → 电子邮件流程的架构图
• 📝 更好地解释了链上身份和可验证电子邮件
• 🔗 添加了源代码仓库和Base链链接

v1.7.0 (2026-02-18)

• 🔐安全加固（处理了ClawHub的“可疑”分类）：
  • 添加了OpenClaw元数据：声明了BASEMAIL_PRIVATE_KEY在requires.env
  • 文件中终端中的密码输入现在被屏蔽（字符隐藏为*
  • ）
  • 更强的密码要求：至少8个字符，必须包含字母和数字--wallet路径验证：必须在$HOME目录下，不允许遍历，最大1KB，仅限常规文件
  • 对所有输入源进行私钥格式验证（0x+ 64个十六进制字符）
  • 已移除--no-encrypt选项 — 托管钱包始终加密
  • 助记词仅显示一次，绝不保存到文件（已移除保存到文件的提示）
  • 移除了遗留的明文密钥文件引用
• 📝 在元数据中添加了说明，阐明：此技能仅签署SIWE消息，绝不发送资金
• 📝 更新了安全指南和文件位置文档

v1.4.0 (2026-02-08)

• ✨ 更好的品牌标识和描述
• 📝 完整的英文文档

v1.1.0 (2026-02-08)

• 🔐 安全性：选择加入的私钥存储
• ✨ 支持环境变量、路径、自动检测
• 🔒 加密存储选项 (--encrypt)
• 📊 审计日志记录

v1.6.0（安全更新）

• 🔐重大变更：--managed现默认启用加密
• 🔐 移除了外部钱包路径的自动检测（安全性改进）
• 🔐 助记词不再自动保存；仅显示一次供用户手动备份
• 📝 更新了文档以提高清晰度

v1.0.0

• 🎉 首次发布