---

name: gmail description: "Gmail APIでメールの取得・検索・送信を行う。受信トレイのチェック、未読メール確認、メール送信に使う。「メール確認」「未読メール」「メール送信」「Gmailチェック」などの作業に使う。" metadata: {"clawdbot":{"requires":{"bins":["node"]}}}

Gmail Skill

Gmail APIを使ったメール操作スキル。Google Calendar と同じOAuth認証を共有。

ツール

• ~/.openclaw/skills/gmail/gmail.js — メイン操作スクリプト
• ~/.openclaw/skills/gmail/auth.js — OAuth認証ヘルパー

アカウント

2つのGoogleアカウントを管理:

• ktlabworks — ktlabworks@gmail.com（デフォルト、競合NL取得用）
• k.sato.8710 — k.sato.8710@gmail.com

使い方

# 未読メール一覧（ktlabworks@、デフォルト）
node ~/.openclaw/skills/gmail/gmail.js list

# 件数指定
node ~/.openclaw/skills/gmail/gmail.js list 20

# k.sato.8710@ で操作
node ~/.openclaw/skills/gmail/gmail.js --account k.sato.8710 list

# メール検索
node ~/.openclaw/skills/gmail/gmail.js search "from:example@gmail.com"

# 特定メールの本文取得
node ~/.openclaw/skills/gmail/gmail.js read <messageId>

# 認証状態確認
node ~/.openclaw/skills/gmail/auth.js --list

# 再認証
node ~/.openclaw/skills/gmail/auth.js ktlabworks
node ~/.openclaw/skills/gmail/auth.js k.sato.8710

認証情報

~/.openclaw/google-credentials/
├── foropenclaw/          # ktlabworks@
│   ├── oauth-keys.json
│   └── tokens.json
└── clawdbot-integration/ # k.sato.8710@
    ├── oauth-keys.json
    └── tokens.json

⚠️ よくある落とし穴

• メール送信の無断実行: メール送信は必ずけいたに確認を取ってから実行すること。確認なしの送信は厳禁
• トークン期限切れ: tokens.json のリフレッシュトークンが失効すると認証エラーになる。node ~/.openclaw/skills/gmail/auth.js --list で状態を確認し、必要なら再認証する
• アカウント指定の漏れ: --account を省略すると ktlabworks がデフォルトで使われる。k.sato.8710 のメールを操作するつもりで指定を忘れると別アカウントを操作してしまう
• Gmail APIスコープ不足: 初回や権限変更後はOAuth認証フローが必要な場合がある。スコープ不足でエラーが出たら再認証を実行