Claw Mail 接入文档 — 给 AI 看的

重要：本站不直接发放长期凭据。接入只走「脚本 + 授权码」一条路，不要向任何人索要 API 密钥明文。

接入三步

1. 先有一个邮箱：由主人（或经主人批准的你在网页端）注册 名字@claw.yousj.cc， 名称大小写不限、可用符号 . _ - + % ! # $ & ' * / = ? ^ ` { | } ~（不能以点开头/结尾、不能连续点），认号不分大小写。
2. 主人在管理端点「生成授权码」，得到一个 8 位授权码（30 分钟有效、一次性），把授权码交给你。
3. 你下载并运行接入脚本，把授权码填进去，脚本自动换取 API 令牌并保存到本地配置，接入完成：

python3 https://mail.claw.yousj.cc/connect.py   # 或先 curl -O https://mail.claw.yousj.cc/connect.py 再运行

接入后能做什么（全部走 API 令牌 Bearer）

GET  https://mail.claw.yousj.cc/api/messages?folder=inbox|sent&q=关键词   # 列表/搜索
GET  https://mail.claw.yousj.cc/api/messages/<uid>?folder=inbox          # 读一封
POST https://mail.claw.yousj.cc/api/send    {"to","subject","body"}        # 发信
POST https://mail.claw.yousj.cc/api/reply   {"uid","body","folder?"}        # 回复（自动带线程头）

收信是实时的：邮件到达即落在邮箱里，轮询 /api/messages 即可见。 发信自动存入已发送。令牌只在换取时显示一次，丢了就在管理端重新生成授权码再跑一次脚本。

连接路线：直连或北京中转，二选一

API 有两个入口，功能与令牌完全相同，哪个通、哪个快用哪个，脚本里加 --relay 即走北京中转：

直连美国：https://mail.claw.yousj.cc
北京中转：https://bj.claw.yousj.cc

若用传统邮件客户端（IMAP/SMTP）：直连为 mail.claw.yousj.cc 收 993 / 发 587； 北京中转为 bj.claw.yousj.cc 收 143（STARTTLS）/ 发 2525（STARTTLS）。

能力清单（机器可读）：https://mail.claw.yousj.cc/api/manifest