メールアダプター

このページはメールの接続方法を教えるものではなく、メールの接続完了後に Nekro Agent でどのように確認・使用できるかを説明するものです。

メールアカウントの接続がまだ完了していない場合は、まず以下を参照してください：

• Email 設定チュートリアル

このページでできること

メールアダプターが接続されると、Nekro Agent は受信したメールを専用のページに整理します。これはメールの概要ページとして理解でき、「メールが受信されているかどうか」を最初に確認するためのものです。

現在のページは主に以下に使用されます：

• 受信済みのメールリストを確認する
• メールアカウント別にメールソースを区別する
• 件名、送信者、日時を素早く確認する
• メールに添付ファイルがあるかどうかを判断する
• ポーリングが正常に動作しているかの確認を補助する

ページに通常表示される内容

現在のバージョンでは、メールリストには通常以下の情報が表示されます：

• メールの件名
• 送信者
• 所属メールアカウント
• メールの日時
• 添付ファイルの有無

複数のメールアカウントを設定している場合、ここにはそれらが受信したメールが統合して一覧表示されます。

チャットの Email セッションとの違い

メールリストページは概要エントリに近く、まずメールが受信されているか、どのアカウントからのものか、添付ファイルがあるかどうかを確認するのに適しています。

チャットの Email セッションは、特定のメールを引き続き処理するのに適しています。例えば、AI にメールの内容を要約させたり、メールに基づいて返信を作成したり、プラグインと連携して添付ファイルを処理したりする場合です。

設定完了後、Email チャットの識別子は通常以下のようになります：

email-あなたのメールアドレス

例：

email-123456@qq.com

新着メール通知の送信先

Email 設定で 新着メール通知を有効化 をオンにした場合、新着メール通知チャットチャンネル も入力する必要があります。

このフィールドにはチャット識別子を入力します。例えば：

onebot_v11-group_グループ番号

つまり、Email は「新着メールを受信した」という通知を、すでに接続されている他のプラットフォーム（QQ グループ、Telegram グループ、カスタム SSE クライアントなど）に送信できます。

通知を初めて設定する際は、まず WebUI またはログから実際のチャット識別子をコピーすることをお勧めします。

添付ファイルの場所

メールの添付ファイルはデータディレクトリの以下に保存されます：

data/uploads/email_attachment/{メールアカウント}/{メールUID}/{添付ファイル名}

このページは主にメールに添付ファイルがあるかどうかを判断するのに役立ちます。添付ファイルをさらに処理する場合は、通常チャットセッションやプラグイン機能で引き続き操作する必要があります。

このページをいつ使うべきか

以下のような状況では、通常このページを確認するのに適しています：

• 新着メールが正常に受信されているかを確認したい場合
• 最近のメールを素早く一覧したい場合
• 特定のアカウントで最近何を受信したかを確認したい場合
• どのメールに添付ファイルがあるかを事前に確認したい場合
• ポーリング設定を変更した後、すでに有効になっているかを確認したい場合

使用上の推奨事項

• 通知と添付ファイルを主に監視したい場合は、最新の日時と添付ファイルのマークを先に確認する
• ここに長期間新しいメールがない場合は、まず Email アダプターの設定とポーリング状態を確認する
• 接続が成功したかどうかを確認したいだけの場合は、まずメールアドレスにシンプルなテストメールを送信する

よくある質問

メールアカウントは設定済みだが、ここにメールが表示されない

まず以下を確認してください：

1. Email アダプターが有効化され、再起動されているか
2. メールアカウントリストの アカウントを有効化 がオンになっているか
3. IMAP がメールのバックエンドで有効になっているか
4. 認証コードまたはアプリ専用パスワードが有効か
5. ポーリング間隔が長すぎる設定になっていないか
6. 未読のみ取得 がオンの場合、メールボックスに実際に未読メールがあるか

メールは受信できるが、通知が送信されない

まず以下を確認してください：

1. 新着メール通知を有効化 がオンになっているか
2. 新着メール通知チャットチャンネル に実際に存在するチャット識別子が入力されているか
3. 対象プラットフォームのアダプターが正常に接続されているか
4. 対象のグループチャットやチャンネルでボットのメッセージ送信が許可されているか

メールは受信できるが、添付ファイルの内容が見えない

このページは主にリストビューです。添付ファイルがあるかどうかを判断するのに適しており、添付ファイルの内容を直接処理するための専用ページではありません。

関連ドキュメント

• Email 設定チュートリアル
• チャンネル管理
• プラグイン使用原則