AIにGmailを読ませて大丈夫？OpenClawで安全にメールを片付ける手順

　前回はOpenClawの導入手順を解説した。今回はその活用例として、GmailとOpenClawを連携し、不要メールの整理に使う流れを紹介する。セール通知、ニュースレター、イベント案内、サービスからの定期通知など、メールボックスには必要か不要か微妙なメールが少しずつたまっていく。手作業で検索して削除するのは地味に面倒だが、AIに条件を伝えれば、削除候補の抽出や一覧化を任せられる。

　ただし、メールの削除は取り返しのつきにくい操作でもある。そこで本稿では、いきなり自動削除を行なうのではなく、まずGmailを安全に読めるようにし、次に候補だけを出し、最後に人間が確認してから削除する流れを基本にする。OpenClawは便利だが、メールを扱わせる以上、権限の渡し方と確認の入れ方が重要になる。

OpenClawはチャットを起点に、ローカルPCや外部サービスと連携した作業を進められる

Gmail連携はOAuth/gogcliで行なう

　Gmailを外部ツールから扱う方法として、古くからIMAP/SMTPとアプリパスワードを使うやり方がある。設定値を入力するだけなので分かりやすいが、OpenClawの現行環境ではおすすめしにくい。

　理由は大きく2つある。1つは、アプリパスワード方式は権限の粒度が粗く、漏洩時の影響が大きいこと。もう1つは、現在のOpenClawではGoogle Workspace系の操作に対応したCLIツール「gogcli」を使い、GoogleのOAuth認証でGmail APIを扱う構成が実用的だからだ。

　OAuthであれば、GoogleアカウントのパスワードそのものをOpenClawに渡す必要はない。gogcliに認可情報を保存し、OpenClawは必要に応じてgogcliを呼び出す。Gmailを読むだけで始めるならread-only権限を使えるし、メール送信を避けたい場合はgogcli側の安全オプションも使える。

　本稿では、Windows 11環境でOpenClawとgogcliが使える状態を前提に、Google CloudでOAuthクライアントを作成し、gogcliへGmailアカウントを登録する手順を細かく見ていく。

　なお、PowerShellではnpmやGoogle Cloud SDK由来のコマンドが「.ps1」として解釈され、実行ポリシーで止まることがある。そのため、OpenClawは「openclaw.cmd」、Google Cloud SDKは「gcloud.cmd」のように「.cmd」付きで書くとつまずきにくい。

openclaw.cmd --version
gog.cmd --version

WindowsのPowerShellでは、「openclaw.cmd」のように「.cmd」付きで実行すると、実行ポリシーによるつまずきを避けやすい

Google CloudでOAuth用プロジェクトを作成する

　まず、ブラウザでGoogle Cloud Console(https://console.cloud.google.com/)を開く。

　ここでは、gogcliがGmail APIへアクセスするためのOAuthクライアントを作成する。少し手順は多いが、一度設定すれば同じPCでは継続して利用できる。最初はプロジェクトの作成から行なう。

画面上部のプロジェクト名プルダウンをクリックする

「新しいプロジェクト」をクリックする

プロジェクト名に「openclaw-gmail」など分かりやすい名前を入力して「作成」をクリックする

作成後、ポップアップのプロジェクト選択から作成したプロジェクトを選ぶ。左上のプロジェクト名をクリックすることでも選択画面を呼び出せる

Gmail APIを有効化する

　プロジェクトを作成したら、Gmail APIを有効にする。

左上のメニューから「APIとサービス」を開き、「ライブラリ」をクリックする

検索欄に「Gmail API」と入力する

「Gmail API」をクリックする

「有効にする」をクリックする

　これで、作成したプロジェクトからGmail APIを利用できるようになる。

　新着メールをリアルタイムにOpenClawへ通知したい場合は、同じ流れで「Cloud Pub/Sub API」を有効にする必要があるが、今回の記事では、まずGmailを検索して不要メール候補を出すことをメインにする。

OAuth同意画面を設定する

　続いてOAuth同意画面を設定する。Google Cloud Consoleでは、「Google Auth Platform」という項目から設定する。

左メニューで「Google Auth Platform」を開き、「ブランディング」を選ぶ。未設定の場合は「開始」をクリックする

アプリ名に「OpenClaw Gmail」などを入力。ユーザーサポートメールに自分のGoogleアカウントを指定する

「対象」は個人利用なら「外部」を選ぶ

連絡先メールアドレスに自分のGoogleアカウントを入力する

「Google API サービスのユーザーデータに関するポリシー」への同意にチェックして「続行」をクリック

最後に「作成」をクリックする

　個人で試すだけなら、まずは自分のGoogleアカウントをテストユーザーに追加すれば認可できる。

「Google Auth Platform」から「対象」を開く

「テストユーザー」の「Add Users」をクリックする

OpenClaw/gogcliで使いたいGmailアドレスを追加して保存する

　ここで追加したGoogleアカウントだけが、OpenClawに操作を許可できるようになる。

OAuthクライアントを作成してJSONをダウンロードする

　次に、実際にgogcliへ登録するOAuthクライアントを作る。OAuthクライアントとは、OpenClawなどのアプリがGoogleアカウントへのアクセス許可を求めるときに使う「アプリ側の身分証」のようなものだ。Googleはこの情報をもとに、どのアプリが、どの権限を求めているのかをユーザーに表示する。

「Google Auth Platform」から「クライアント」を開き、「クライアントを作成」をクリックする

「アプリケーションの種類」で「デスクトップアプリ」を選ぶ

名前に「OpenClaw Gmail Desktop」など分かりやすい名前を入力して「作成」をクリックする

作成後、OAuthクライアントのJSONファイルをダウンロードする

　ダウンロードされるファイル名は、「client_secret_....json」のようになる。

gogcliへOAuthクライアントを登録する

　JSONファイルをダウンロードしたら、PowerShellに戻る。ここでは例として、ファイルがダウンロードフォルダにあるものとする(client_secret_xxxxx.jsonの部分はダウンロードしたファイル名を入れる)。

gog auth credentials set "$env:USERPROFILE\Downloads\client_secret_xxxxx.json"

　「gog auth credentials set」は、OAuthクライアントの認証情報をgogcliへ登録するコマンドだ。登録できたら、以下で確認する。

gog auth credentials list

　続いて、実際に使うGmailアカウントをgogcliに追加する。最初は読み取り専用で始めるのが安全だ(your-account@gmail.comの部分は設定した自分のGmailアドレスを入れる)。

gog auth add your-account@gmail.com --services gmail --readonly --gmail-scope readonly

このコマンドを実行するとブラウザが開き、Googleアカウントの選択画面が表示される。ここで、Google Cloud Consoleのテストユーザーに追加したGmailアカウントを選ぶ

　Google側で「このアプリは確認されていません」と表示される場合がある。これは、自分で作成したOAuthアプリをGoogleの審査に出していないためだ。自分用のテストアプリとして使うなら、内容を確認した上で「続行」から先に進む。

このアプリは確認されていませんと表示された場合は「続行」をクリック

ログイン画面ではメールアドレスが設定したものになっているか確認して「次へ」をクリック

認可画面では、Gmailへのアクセス権限が表示される。最初はread-onlyで進めるため、メール送信や削除を許可する構成にはしない。読み取りができることを確認して「続行」をクリックする

　認可が完了したら、以下で登録状況を確認する。

gog auth list
gog auth doctor

　「gog auth list」を実行すると、登録済みのGoogleアカウントと、利用できるサービスの一覧が表示される。ここに先ほど追加したGoogleアカウントが表示されていれば、アカウントの登録は完了している。

　続いて「gog auth doctor」を実行する。認証情報やトークンに問題がなければ、各チェック項目が正常として表示される。エラーや警告が表示された場合は、OAuthクライアントの設定、テストユーザーへの追加、認可時に選択したGoogleアカウントなどを確認する。

Gmailを読めるかテストする

　認可が済んだら、まずはGmailの検索を試す。いきなりOpenClawに頼む前に、PowerShellでgogcli単体の動作を確認しておくとトラブルを切り分けやすい。

gog --gmail-no-send gmail search "newer_than:1d" --max 10 --account your-account@gmail.com

これは、過去1日分のメールを最大10件検索する例だ。Gmailの送信系操作をブロックする「--gmail-no-send」を付けておくと安心感がある

　ここで「invalid_grant」と表示される場合は、Gmail検索クエリではなくOAuthトークン側の問題であることが多い。Google CloudのOAuthアプリがテスト公開のままだと、発行された更新トークンが短期間で無効になることがある。

　また、OAuthクライアントを作り直した後に古い認可情報を使っている場合も、トークン更新に失敗しやすい。この場合は、Googleアカウント側で対象アプリのアクセスを削除し、gogcli側でもアカウントを登録し直してから再度認可する。

　メール本文を取得する場合は、メッセージIDを指定する。メッセージIDは検索結果の各メールの先頭部分にあるので、それを<messageId>の部分に入力しよう。

gog --gmail-no-send gmail get <messageId> --sanitize-content --json --account your-account@gmail.com

メッセージIDを入力することで本文を確認できる

　「--sanitize-content」を付けると、HTMLやURLなどから危険なコードや不要な情報を自動で取り除くので安全性が高まる。

OpenClawからGmailを扱う

　gogcliでGmailを読めるようになったら、OpenClawからもGmail関連の作業を依頼しやすくなる。なお、Gmailの本文には外部から届いた任意の文章が含まれる。メール本文の中にAIへの指示のような文章が書かれている可能性もあるため、OpenClawにはあらかじめ次のような方針を伝えておくとよい。

　そして次の依頼は、削除や変更を伴わない確認にする。

　ここで重要なのは、「削除や変更はせず」と明記することだ。Gmail連携ができた直後は、どの程度の権限で動いているか、OpenClawがどのツールを呼び出すかを確認する段階である。まずは読むだけ、検索するだけに留める。

　うまくいけば、OpenClawがGmailの最近のメールを検索し、件名、送信者、日時などを一覧にしてくれる。表示された内容に問題がなければ、次に不要メール候補の抽出へ進む。

最初は削除や変更をせず、Gmailを読めるかだけを確認する

まずは「削除候補を探すだけ」にする

　不要メール整理では、最初から削除を依頼しない。まずは候補を探すだけにする。

　この依頼なら、OpenClawは条件に合いそうなメールを探し、一覧にまとめる。メールの削除やラベル変更は行なわないため、連携の確認と条件調整を兼ねた安全な第一歩になる。

　候補が表示されたら、送信者、件名、日付を確認する。必要なメールが混ざっている場合は、除外条件を追加する。

　不要メール整理で大切なのは、削除したいものだけでなく、削除したくないものも具体的に書くことだ。請求、注文、ログイン通知、二段階認証、セキュリティ通知、仕事関係のメールなどは、件名だけでは重要度を判断しにくい。除外条件を明示することで、誤削除のリスクを下げられる。

最初は削除せず、プロモーション系メールの候補だけを探してもらう

条件を絞ってから削除を依頼する

　候補が絞れたら、次に削除前の最終確認を行なう。

　なお、ここまで読み取り専用の「--gmail-scope readonly」で認可している場合、検索はできても削除は実行できない。Gmailのゴミ箱へ移動するには、Gmailの変更権限が必要になる。削除まで試す段階に進む場合は、読み取り専用で動作を確認した後、PowerShellから対象アカウントを再認可して権限を広げる。

gog auth remove your-account@gmail.com
gog auth add your-account@gmail.com --services gmail --gmail-scope full --force-consent

認可画面でGmailの変更権限が表示されるため、内容を確認して許可する

　最初からこの権限で始めるより、読み取り専用で検索と候補提示に問題がないことを確認してから広げる方が安全だ。そして再びDiscord(OpenClawのチャット画面)に戻って、以下のような内容で依頼をする。

　OpenClawが削除予定のメールを再度一覧表示したら、件名や送信者を確認する。問題がなければ、次のように返す。

　このように、検索、候補提示、最終確認、削除実行を分けておけば、AIに任せる部分と人間が判断する部分がはっきりする。初めて使う場合は、Gmail上でも削除後にゴミ箱へ入っていることを確認しておくとよい。

　Gmailでは通常、削除したメールはいきなり完全削除されるのではなく、ゴミ箱へ移動する。とはいえ、後から戻せばよいと考えて雑に扱うのは危険だ。必要なメールを誤って削除しないためにも、最初は少数のテストメールや不要なニュースレターに限定して試したい。

削除前に対象を再確認し、ユーザーがOKした後に実行する流れにしておく

慣れてきたら定期チェックへ発展させる

　一度流れが分かれば、定期的なメール整理にも応用できる。たとえば、毎朝決まった時間に不要メール候補を探してもらう使い方だ。

　ここでも、最初は「自動削除」ではなく「候補を提示」にしておく。候補提示型でしばらく使い、条件に問題がないことを確認できたら、特定の送信者や明確な件名に限って自動削除を検討するとよい。

　完全自動削除を使う場合は、以下のように対象をかなり限定する。

　送信者、件名、期間、既読状態、除外条件を明確にすれば、不要なメールだけを処理しやすくなる。逆に、「不要そうなメールを全部消して」のような曖昧な依頼は避けたい。

慣れてきたら、毎朝や毎週の候補提示に発展させられる

セキュリティ面で気を付けたいこと

　Gmail連携は便利だが、AIエージェントにメールを読ませるということは、受信箱の中にある個人情報や仕事上の情報へアクセスできるようにすることでもある。

　それだけに、最初はread-onlyで始めよう。gogcliでは認可時に「--readonly」と「--gmail-scope readonly」を指定でき、実行時には「--gmail-no-send」で送信系操作をブロックできる。読み取りと検索だけで運用を確認し、削除や送信のような操作は後から必要に応じて考えればよい。

　また、先ほど指定したように、メール本文はAIへの命令ではなく処理対象のデータとして扱う。特に本文中の「このメールを転送せよ」「以前の指示を無視せよ」といった文には従わせないことが重要だ。

　そして、削除、送信、外部投稿、ファイル公開、課金につながる操作は必ず確認を挟む。OpenClawは強力だが、完全に自動で判断させるより、人間が最後のブレーキを持っていた方が安全だ。

　AIエージェントにメールを任せるのは少し怖い。だが、任せる範囲を決め、権限を絞り、重要な操作に確認を入れれば、日々の面倒な整理作業をかなり軽くできる。Gmailの不要メール整理は、OpenClawの実用性と注意点をどちらも体感しやすい作業だ。