nmail — 韩国电子邮件 CLI 工具

面向韩国邮箱（Naver、Daum）的命令行工具，供智能体（Agent）读取与发送邮件使用。

前提条件

• nmail 二进制文件已加入 PATH（执行 go install github.com/harlock/nmail@latest）
• 账户配置已完成（运行 nmail config add）

配置

# 添加 Naver 账户（需应用专用密码）
nmail config add --provider naver --email  --password 

# 添加 Daum 账户
nmail config add --provider daum --email  --password 

# 查看当前配置
nmail config list

命令

查看收件箱

# 最近 20 封邮件（JSON 格式输出）
nmail inbox

# 指定数量
nmail inbox --limit 5

# 人类可读格式输出
nmail inbox --pretty

JSON 输出示例：

[
  {"id": 42, "from": "friend@naver.com", "subject": "안녕", "date": "2026-03-19T10:00:00+09:00", "is_read": false},
  {"id": 41, "from": "service@naver.com", "subject": "알림", "date": "2026-03-19T09:30:00+09:00", "is_read": true}
]

阅读邮件

# 根据 ID 读取正文（ID 可从 inbox 命令结果中获取）
nmail read 42

# 人类可读格式
nmail read 42 --pretty

发送邮件

# 直接指定正文内容
nmail send --to friend@naver.com --subject "제목" --body "내용"

# 从文件读取正文
nmail send --to friend@naver.com --subject "제목" --body-file ./message.txt

# 通过 stdin 输入正文
echo "파이프로 보내기" | nmail send --to friend@naver.com --subject "제목" --body-file -

搜索邮件

# 按发件人搜索
nmail search --from "socra"

# 组合条件搜索
nmail search --subject "코딩" --since 2026-03-01 --limit 10

# 仅搜索未读邮件
nmail search --unseen

# 全文搜索（主题 + 正文）
nmail search --text "키워드"

监控新邮件

# 轮询模式（每 5 秒检查一次）——输出 JSON 行格式
nmail watch --poll 5

# 人类可读格式
nmail watch --poll 5 --pretty
# 📬 New: [제목] from 보낸사람

⚠️ Naver IMAP 不支持 IDLE。必须使用 --poll 参数。

账户管理

nmail config list          # 列出所有账户
nmail config add ...       # 添加账户
nmail config remove --email   # 删除指定邮箱账户

智能体（Agent）使用模式

检查新邮件 → 生成摘要

nmail inbox --limit 5
# → 解析 JSON → 过滤 is_read: false 的邮件 → 使用 read 获取正文 → 生成摘要

邮件搜索

nmail search --from "socra" --since 2026-03-01
# → 解析 JSON → 定位目标邮件

实时监控（与 OpenClaw 集成）

# 将 watch 输出作为 openclaw system event 事件流处理
nmail watch --poll 10 | while IFS= read -r line; do
  subj=$(echo "$line" | jq -r '.subject')
  from=$(echo "$line" | jq -r '.from')
  openclaw system event --text "📬 새 메일: $subj (from: $from)" --mode now
done

回复邮件

# 1. 读取原始邮件
nmail read 42
# 2. 发送回复（收件人为原始发件人地址）
nmail send --to  --subject "Re: " --body "답장 내용"

注意事项

• 默认输出为 JSON 格式。--pretty 仅用于向人类展示时使用。
• 自动处理韩文主题/正文的编码转换（EUC-KR ↔ UTF-8）
• 应用专用密码保存在 ~/.nmail/config.yaml 中（仅限本地存储）
• 错误信息也以 JSON 格式返回：{"error": "message"}