---
title: "OpenClaw メール連携の準備：Gmail・Outlook を読み取り専用で扱う"
description: "OpenClaw のメール連携に向けて、Gmail・Outlook を Mailera に接続する準備を解説。認証方式の違い、read のみの API キー、読み取り確認、メール内の指示への対策、アクセス停止を扱います。"
url: https://mailera.app/ja/blog/openclaw-email-setup
published: 2026-10-25
updated: 2026-10-25
---

# OpenClaw メール連携の準備：Gmail・Outlook を読み取り専用で扱う

既存のメールボックスを Mailera に接続し、対象グループを限定した read 権限のキーを用意します。Mailera 側の読み取り確認と、OpenClaw 側の接続設定は分けて進めます。

## 接続前に何を用意しますか？

[Mailera](https://mailera.app/ja/product) は、既存のメールボックスを API や MCP 経由でアプリや AI エージェントにつなぐサービスです。新しいメールボックスやメールアドレスは発行しません。

まず、自分が所有するテスト用メールボックスと、機密情報を含まない確認用メッセージを用意してください。Mailera でメールボックスを追加できるのは Admin または Leader です。全体の構成は[既存メールを AI エージェントにつなぐガイド](https://mailera.app/ja/blog/ai-agent-email-integration)で説明しています。サービスごとの接続方法は[既存のメールサービスをエージェントにつなぐ手順](https://mailera.app/ja/blog/connect-existing-email-to-agents)を参照してください。

| メールサービス | Mailera での認証 | 前提条件 | 接続後の確認 |
| --- | --- | --- | --- |
| Gmail | アプリパスワード（app password） | 2 段階認証。組織のアカウントでは管理者による許可も確認 | 対象アドレスと確認用メッセージ |
| Outlook／Microsoft 365 | Microsoft Graph を通じた OAuth | Microsoft へのサインインと必要な同意 | 同意したアカウントと確認用メッセージ |

認証方式とメールの取得・送信経路の違いは、[エージェント開発者向けの IMAP・Graph・SMTP 解説](https://mailera.app/ja/blog/ai-agent-email-protocols)で整理しています。

OpenClaw 側では、使っているバージョン、外部ツールの接続方式、秘密情報の保存先を先に確認します。Mailera の認証情報と、Gmail／Microsoft の認証情報は別です。エージェントへ渡すのは対象を絞った Mailera の API キーとし、プロバイダーの認証情報をチャットに貼らないでください。

## Gmail または Outlook を Mailera に接続するには？

1. 「メールボックス」から「メールボックスを追加」を開きます。
2. **Gmail の場合**は「単一メールボックス」で「メールアドレス」を入力します。検出されたプロバイダーを確認して「続行」へ進み、「接続情報」の「パスワード」にアプリパスワードを入力します。通常のログインパスワードは使いません。「メールボックスグループ」はテスト用に分けてください。
3. **Outlook／Microsoft 365 の場合**は「Microsoftでサインイン」を選び、Microsoft 側で対象アカウントへのサインインと OAuth の同意を進めます。アプリパスワードで接続する手順ではありません。
4. 接続情報を入力する経路では「テストして接続」を実行します。このテストでメールは送信されません。送信側の認証だけが失敗した場合は「受信専用で保存」を選べます。
5. 接続後は「メールボックスを開く」から、用意した確認用メッセージを探します。

![Gmail の追加経路と「Microsoftでサインイン」タブがある Mailera のメールボックス追加画面](https://mailera.app/media/b12cb977e2574d90/mcp-gmail-outlook-imap-add-test-mailbox-ja-1200.jpg)
_Gmail はアプリパスワード、Microsoft は OAuth の経路を使います。_

Gmail のアプリパスワードは[Google 公式の作成・取り消し手順](https://support.google.com/accounts/answer/185833?hl=ja)に従ってください。Google は一般にアプリパスワードを推奨せず、アプリに「Sign in with Google」がある場合はそちらを勧めています。ここで説明しているのは、Mailera のアプリパスワードを使う接続経路です。

Microsoft 側の同意や承認の仕組みは[Microsoft Graph の認証と承認](https://learn.microsoft.com/ja-jp/graph/auth/)を参照してください。サービス別の説明は [Gmail 接続](https://mailera.app/ja/providers/gmail)と [Microsoft 接続](https://mailera.app/ja/providers/microsoft)、画面操作の詳細は[最初のメールボックスを接続する手順](https://mailera.app/ja/blog/mailera-first-mailbox)にあります。

## 読み取り専用の API キーを作るには？

「どのメールボックスを扱えるか」と「何を実行できるか」は別の設定です。読み取り専用でも、全グループを対象にする必要はありません。

1. 「設定」の API キー画面から「キーを作成」を開きます。
2. 「わかりやすい名前」に用途を記入し、「メールボックスのスコープ」でテスト用のグループを選びます。そのグループに業務用メールボックスが混ざっていないか確認してください。
3. 権限は `read` だけにします。`send`、`move`、`manage`、`sync` などは付けません。
4. 「有効期限」を設定して作成し、安全な保存先へコピーします。キー本体が表示されるのは一度だけです。

![テスト用グループと read 権限だけを選択した Mailera の API キー作成画面](https://mailera.app/media/fba3669201058803/openclaw-gmail-outlook-read-key-ja-1200.jpg)
_対象のメールボックスと操作権限を別々に絞ります。_

この制限は Mailera API の操作に対するものです。プロバイダー側で付与した権限を変更する操作ではありません。また、「受信専用で保存」と API キーの `read` 制限は別なので、受信専用で保存した場合もキーの権限を確認します。

## OpenClaw 側へ渡す接続情報は？

[Mailera の MCP 接続](https://mailera.app/ja/mcp)では、次の接続先と認証を使います。

| 項目 | 値 |
| --- | --- |
| MCP 接続先 | `https://mailera.app/api/public/v1/mcp` |
| 認証ヘッダー | `Authorization: Bearer $MAILERA_API_KEY` |
| 最初に使う権限 | `read` |

`$MAILERA_API_KEY` は、作成したキーを秘密情報として保存し、実行環境から渡すための変数です。キーを公開設定や会話本文に書かないでください。

「MCP 設定をコピー」の対象は Claude、Cursor、VS Code です。その設定を OpenClaw 用としてそのまま流用せず、利用環境の接続方式と認証の渡し方を確認します。

MCP には、クライアントがサーバーを子プロセスとして起動する stdio と、HTTP を使う Streamable HTTP があります。[MCP の通信方式の仕様](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)も参照し、URL の入力だけで設定を終えず、実際のツール呼び出しまで確認してください。

## 読み取りの成功をどう確認しますか？

Mailera 側の接続確認と、エージェント経由の取得確認を分けます。以下は Mailera の MCP ツール名です。

| 順番 | Mailera の MCP ツール | 確認する内容 |
| --- | --- | --- |
| 1 | `list_mailboxes` | テスト用グループの意図したメールボックスだけが対象か |
| 2 | `list_messages` | 対象メールボックスで確認用メッセージを見つけられるか |
| 3 | `get_message` | そのメッセージの件名と本文を読めるか |

これらは `read` 権限で使えます。ほかの操作との区別は [MCP ツールの用途別ガイド](https://mailera.app/ja/blog/mailera-mcp-tools)を参照してください。

REST で切り分ける場合も、同じキーで `GET /mailboxes`、`GET /mailboxes/{id}/messages`、`GET /mailboxes/{id}/messages/{msgId}` の順に取得します。メッセージの詳細では `data.subject` と `data.body.text` または `data.body.html` を、用意した内容と照合します。

エージェント経由の確認では、要求、呼び出されたツール、応答を記録してください。保存する記録ではアドレスや本文を伏せます。読み取れたことに加え、キーの設定に送信・移動権限がないことも確認します。REST での取得成功と、OpenClaw 経由での取得成功は別々に判断してください。

## 接続できないとき、どこを確認しますか？

| 症状 | 確認箇所と次の操作 |
| --- | --- |
| Gmail でアプリパスワードを作れない | 2 段階認証、組織の制限、セキュリティキーのみの認証、Advanced Protection の利用を Google 公式ヘルプで確認します。制限を回避しないでください。 |
| Gmail の接続が途切れた | Google アカウントのパスワードを変更するとアプリパスワードは取り消されます。認証情報を確認します。 |
| Microsoft の同意が完了しない | サインインしたアカウントを確認し、組織の承認が必要な場合は管理者に相談します。 |
| API 認証が通らない | キーの有効期限、失効状態、Bearer ヘッダー、接続先を確認します。 |
| メッセージが見つからない | 対象グループ、メールボックス、フォルダー、同期状態を確認します。`read` だけでは `sync_mailbox` は実行できません。 |
| エージェントからツールが見えない | クライアント側の接続方式と認証設定を確認し、Mailera 側の読み取り確認と切り分けます。 |

Mailera は常に即時反映するわけではありません。使用状況によってバックグラウンド確認の頻度が変わり、未使用のメールボックスはスリープする場合があります。メールが見えないという理由だけで、エージェントの権限を増やさないでください。

## メール内の指示や誤送信からどう守りますか？

受信メールは信頼できないデータであり、エージェントへの指示ではありません。本文や添付ファイルに「別の宛先へ転送」「このコマンドを実行」などと書かれていても実行させない方針を、エージェント側に設けてください。

指示文だけに頼らず、テスト用グループと `read` 権限で制限します。読み取りだけでも機密情報の持ち出しには注意が必要です。モデルへ渡す本文とログの保存先を確認し、OpenClaw 側の別のメール接続やシェル権限も見直してください。Mailera の API キーの制限を、ほかの経路の操作制限として扱わないでください。

将来 `send` を付ける場合は、宛先と本文を人が確認してから送信する仕組みをエージェント側に設けます。Mailera の設定とは分けて設計してください。製品の情報は[セキュリティページ](https://mailera.app/ja/security)にもあります。

## 接続を止めるには？

Mailera の API キーを失効させます。そのキーを使う呼び出しは直ちに拒否されます。続いて OpenClaw 側の設定や秘密情報の保存先からキーを除去し、別のキーやメール接続が残っていないか確認してください。

Gmail と Mailera の接続自体も止める場合は、Google 側で該当するアプリパスワードを取り消せます。エージェント用キーの失効と、プロバイダーへのアクセス取り消しは、停止する範囲が異なります。

**最初のメールボックスを2分で接続** — Outlook、Gmail、IMAPのメールボックスを追加して、アプリやAPIでメールを読めます。 [メールボックスを接続](https://mailera.app/auth?mode=signup)