前言¶
在 Agent 沙箱裏跑自動化時,常見需求是把執行結果、告警或確認鏈接發到真實郵箱。傳統做法往往要先註冊 SMTP、配置密鑰,或在環境裏裝一堆依賴;Python 系方案還可能碰到 cryptography 等原生模塊,在受限沙箱裏不好裝。下面介紹 SkillHub 社區 Skill TokenMail(@user_ecef03fe/tokenmail,當前版本 1.0.0):面向 AI Agent 的郵件通信,基於 Node.js CLI,官方說明強調不強制 npm install、不強制本地寫文件,並標註 requires_api_key=false,適合在辦公效率類工作流裏快速接上發信能力。
這是什麼¶
TokenMail 是 SkillHub 上的社區來源(community)Skill,發佈者爲 user_ecef03fe,分類爲 office-efficiency。
一句話定位:提供 AI 原生郵箱能力——免註冊、免費發郵件,供 Agent 通過 Skill 指引調用 Node.js CLI 完成郵件溝通;實現上不依賴 Python cryptography,並針對沙箱場景做了輕量化設計。
官方頁面與 API 入口:
- SkillHub 展示頁:https://www.skillhub.cn/skills/user_ecef03fe/tokenmail
- 官方地址:https://api.skillhub.cn/user_ecef03fe/tokenmail
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取元數據,未在資料中出現的 CLI 子命令或參數不在此列舉。
- Agent 發信:Skill 用於 AI Agent 的郵件通信,由 Agent 按 Skill 文檔(通用
SKILL.md格式)調用底層 CLI。 - 免註冊發信:簡介明確爲「免註冊、免費發郵件」,降低在自動化流程裏接入郵箱的門檻。
- Node.js CLI 實現:使用 Node.js 命令行工具,無 Python cryptography 依賴,減輕在混合語言環境中的安裝負擔。
- 沙箱友好:說明中寫明針對沙箱優化——無強制 npm install、無強制本地文件寫入,便於在權限與網絡受限的 Agent 運行環境中啓用。
- 無需 API Key 標籤:元數據標籤爲
requires_api_key=false,表示按 SkillHub 分類不需要單獨配置 API Key(具體發信配額與策略以 Skill 內文檔及服務端規則爲準,公開頁未給出細則)。
安裝與啓用¶
安裝流程以 SkillHub 官方安裝文檔爲準;Skill 頁給出的提示爲:根據 https://skillhub.cn/install/skillhub.md 安裝 @user_ecef03fe/tokenmail。
1、安裝 SkillHub CLI(若尚未安裝)¶
先確認本機是否已有 skillhub:
command -v skillhub && skillhub --version
未安裝時,可按 SkillHub 文檔執行完整安裝(CLI + 默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
若只需 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
沙箱或 CI 若限網,需在允許訪問外網的環境下執行上述命令。
2、將 Skill 裝到當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時使用 --dir 指向當前 Agent 實際讀取的 skills 目錄,否則默認落在 ./skills/ 可能不會被識別。常用路徑(摘自官方安裝文檔):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 中安裝 TokenMail 的示例(座標與 Skill 頁一致):
skillhub install @user_ecef03fe/tokenmail --dir ~/.cursor/skills/
也可將提示詞交給 Agent:「請根據 https://skillhub.cn/install/skillhub.md,安裝 @user_ecef03fe/tokenmail。」由 Agent 按文檔完成 CLI 檢查與 --dir 安裝。
經過上面的步驟,Skill 會以通用 SKILL.md 形式出現在對應目錄;重啓或刷新 Agent 後,對話中即可按 Skill 說明調用發信能力。公開資料未區分 Cursor、Codex CLI、Claude Code 在 TokenMail 內部的差異,三者差異主要在 skills 目錄路徑,安裝座標相同。
典型用法¶
公開 SkillHub 頁面未提供獨立的可複製 CLI 示例(如 send 子命令與參數表)。可復現的流程如下:
- 按上一節安裝
@user_ecef03fe/tokenmail到當前 Agent 的 skills 目錄。 - 在任務中明確發信需求(收件人、主題、正文或附件說明),讓 Agent 讀取已安裝的 TokenMail Skill 文檔並調用其描述的 Node.js CLI 完成發送。
- 在沙箱環境中優先依賴 Skill 所聲明的「無強制 npm install / 無強制本地寫文件」路徑;若執行失敗,再檢查 Node 運行時、網絡出站與 Skill 內最新說明。
這與「把發信交給 Agent + Skill」的設計一致:具體命令與參數以安裝包內 SKILL.md 爲準,本文不臆造未公開的接口名。
適用場景與注意¶
適合誰
- 需要在 OpenClaw / Cursor 等 Agent 工作流裏自動發通知、報告或驗證碼鏈接,又不想先搭完整 SMTP 或註冊第三方發信 API 的開發者。
- 運行環境對 Python 原生加密庫或 全局 npm 安裝敏感,希望用 Node CLI、儘量少寫本地文件的團隊。
限制與注意
- 來源爲 community,維護與合規責任在發佈者與使用者;生產環境發信前請自行評估內容與頻率。
- SkillHub 元數據顯示 下載約 2069、安裝約 2(統計隨平臺更新變化),僅作熱度參考,不代表服務質量承諾。
- 「免費發郵件」的具體額度、留存與濫用策略,公開摘要未寫明,以 TokenMail 服務與 Skill 正文爲準。
- 安裝後若 Agent 未識別 Skill,優先覈對
--dir是否指向正確 skills 目錄 以及是否需重啓客戶端。
結尾¶
TokenMail 把「Agent 要能發郵件」收斂成一條可安裝的 Skill:免註冊、Node.js CLI、沙箱向的輕量約束,並標明無需 API Key。若你正在 SkillHub 上找辦公效率類發信能力,可從官方頁查看說明並安裝 @user_ecef03fe/tokenmail:
https://www.skillhub.cn/skills/user_ecef03fe/tokenmail