メールの設定

Hermes は標準の IMAP と SMTP を使ってメールを受け取り、返信できます。エージェント用のアドレスにメールを送ると、同じスレッドの中で返事が返ってきます。専用のクライアントやボット用 API は要りません。Gmail、Outlook、Yahoo、Fastmail など、IMAP/SMTP に対応した提供元ならどこでも使えます。

これは同梱の Himalaya メールスキル とは別ものです。あちらはエージェントが端末のコマンドからメールを操作するためのもので、外部の himalaya CLI と Himalaya の設定ファイルが必要になります。

事前に必要なもの

• Hermes のエージェント専用のメールアカウント（個人用のメールは使わないでください）
• アカウントで IMAP が有効になっていること
• Gmail など二要素認証を使う提供元なら アプリパスワード

Gmail の設定

1. Google アカウントで二要素認証を有効にします
2. App Passwords を開きます
3. 新しいアプリパスワードを作ります（「メール」か「その他」を選びます）
4. 表示された 16 文字のパスワードを控えます。通常のパスワードの代わりにこれを使います

Outlook / Microsoft 365

1. Security Settings を開きます
2. 二要素認証が未設定なら有効にします
3. 「セキュリティ情報の追加」からアプリパスワードを作ります
4. IMAP のホストは outlook.office365.com、SMTP のホストは smtp.office365.com です

そのほかの提供元

たいていのメール提供元は IMAP/SMTP に対応しています。次の点を提供元のドキュメントで確認してください。

• IMAP のホストとポート（多くは SSL のポート 993）
• SMTP のホストとポート（多くは STARTTLS のポート 587）
• アプリパスワードが必要かどうか

ステップ 1: Hermes を設定する

いちばん簡単なやり方は次のとおりです。

hermes gateway setup

プラットフォームの一覧から Email を選びます。ウィザードがメールアドレス、パスワード、IMAP/SMTP のホスト、許可する送信者を順に聞いてきます。

手作業での設定

~/.hermes/.env に次を書き足します。

# Required
EMAIL_ADDRESS=hermes@gmail.com
EMAIL_PASSWORD=abcd efgh ijkl mnop    # App password (not your regular password)
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com

# Security (recommended)
EMAIL_ALLOWED_USERS=your@email.com,colleague@work.com

# Optional
EMAIL_IMAP_PORT=993                    # Default: 993 (IMAP SSL)
EMAIL_SMTP_PORT=587                    # Default: 587 (SMTP STARTTLS)
EMAIL_POLL_INTERVAL=15                 # Seconds between inbox checks (default: 15)
EMAIL_HOME_ADDRESS=your@email.com      # Default delivery target for cron jobs

ステップ 2: ゲートウェイを起動する

hermes gateway              # Run in foreground
hermes gateway install      # Install as a user service
sudo hermes gateway install --system   # Linux only: boot-time system service

起動したとき、アダプターは次の順に動きます。

1. IMAP と SMTP の接続を確かめます
2. 受信箱にすでにあるメールをすべて「既読」にします（新しいメールだけを処理するためです）
3. 新しいメールの取得を始めます

動きのしくみ

メールを受け取る

アダプターは IMAP の受信箱を一定の間隔（初期値は 15 秒）で見に行き、未読のメールを拾います。新しいメールごとに次のように扱われます。

• 件名 が文脈として渡されます（たとえば [Subject: Deploy to production]）
• 返信メール（件名が Re: で始まるもの）では件名の前置きを省きます。スレッドの流れがすでに伝わっているためです
• 添付ファイル は手元に保存されます。
  • 画像（JPEG、PNG、GIF、WebP）→ 画像認識ツールから使えます
  • 書類（PDF、ZIP など）→ ファイルとして読めます
• HTML だけのメール はタグを取り除いて本文だけを取り出します
• 自分あてのメール は返信の無限ループを防ぐため除外されます
• 自動送信や noreply の送信者 は黙って無視されます。noreply@、mailer-daemon@、bounce@、no-reply@ のほか、Auto-Submitted、Precedence: bulk、List-Unsubscribe のヘッダーが付いたメールが対象です

返信を送る

返信は SMTP で送られ、スレッドが正しくつながるようになっています。

• In-Reply-To と References のヘッダーでスレッドを保ちます
• 件名 は Re: を付けて引き継ぎます（Re: Re: と重ねません）
• Message-ID はエージェントのドメインで作られます
• 本文はプレーンテキスト（UTF-8）で送られます

ファイルの添付

エージェントは返信にファイルを添付できます。応答の中に MEDIA:/path/to/file と書けば、そのファイルが送信するメールに添付されます。

添付を読み飛ばす

届いた添付をすべて無視したいとき（マルウェア対策や通信量の節約など）は、config.yaml に次を書き足します。

platforms:
  email:
    skip_attachments: true

有効にすると、添付と本文に埋め込まれたパートが、中身を取り出す前に読み飛ばされます。メール本文のテキストはこれまでどおり処理されます。

アクセスの制御

メールのアクセス制御は、チャット系のプラットフォームより初期状態が厳しめです。

1. EMAIL_ALLOWED_USERS を設定している → そのアドレスから来たメールだけを処理します
2. 許可リストがない → 知らない送信者は黙って無視されます
3. EMAIL_ALLOW_ALL_USERS=true → どの送信者も受け付けます（扱いには注意してください）
4. platforms.email.unauthorized_dm_behavior: pair → 知らない送信者にペアリング用のコードを返します

困ったときは

セキュリティ

• 主パスワードではなく アプリパスワード を使います（Gmail で二要素認証を使う場合は必須です）
• EMAIL_ALLOWED_USERS を設定して、エージェントとやり取りできる相手を絞ります
• パスワードは ~/.hermes/.env に保存されます。このファイルは守ってください（chmod 600）
• IMAP は SSL（ポート 993）、SMTP は STARTTLS（ポート 587）が初期値です。通信は暗号化されます

環境変数の一覧