मुख्य सामग्री पर जाएं

​
Gmail Pub/Sub -> OpenClaw

लक्ष्य: Gmail watch -> Pub/Sub push -> gog gmail watch serve -> OpenClaw webhook।

​
पूर्वापेक्षाएँ

  • gcloud इंस्टॉल और लॉग इन (install guide).
  • gog (gogcli) इंस्टॉल और Gmail खाते के लिए अधिकृत (gogcli.sh).
  • OpenClaw hooks सक्षम (देखें Webhooks).
  • tailscale logged in (tailscale.com)। Supported setup public HTTPS endpoint के लिए Tailscale Funnel का उपयोग करता है। अन्य tunnel services काम कर सकती हैं, लेकिन वे DIY/unsupported हैं और manual wiring की आवश्यकता होती है। अभी के लिए, Tailscale ही वह है जिसे हम सपोर्ट करते हैं।
उदाहरण hook config (Gmail preset mapping सक्षम करें): 
{
  hooks: {
    enabled: true,
    token: "OPENCLAW_HOOK_TOKEN",
    path: "/hooks",
    presets: ["gmail"],
  },
}
Gmail सारांश को किसी चैट सतह पर पहुँचाने के लिए, preset को ऐसे mapping से ओवरराइड करें जो deliver + वैकल्पिक channel/to सेट करता हो: 
{
  hooks: {
    enabled: true,
    token: "OPENCLAW_HOOK_TOKEN",
    presets: ["gmail"],
    mappings: [
      {
        match: { path: "gmail" },
        action: "agent",
        wakeMode: "now",
        name: "Gmail",
        sessionKey: "hook:gmail:{{messages[0].id}}",
        messageTemplate: "New email from {{messages[0].from}}\nSubject: {{messages[0].subject}}\n{{messages[0].snippet}}\n{{messages[0].body}}",
        model: "openai/gpt-5.2-mini",
        deliver: true,
        channel: "last",
        // to: "+15551234567"
      },
    ],
  },
}
यदि आप एक fixed channel चाहते हैं, तो channel + to सेट करें। अन्यथा channel: "last" last delivery route का उपयोग करता है (WhatsApp पर fallback करता है)। Gmail runs के लिए सस्ता model force करने हेतु mapping में model सेट करें (provider/model या alias)। यदि आप agents.defaults.models enforce करते हैं, तो इसे वहाँ शामिल करें। Gmail hooks के लिए विशेष रूप से डिफ़ॉल्ट मॉडल और थिंकिंग लेवल सेट करने हेतु, अपने config में hooks.gmail.model / hooks.gmail.thinking जोड़ें: 
{
  hooks: {
    gmail: {
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}
नोट्स:
  • mapping में प्रति-hook model/thinking अभी भी इन डिफ़ॉल्ट्स को ओवरराइड करता है।
  • फॉलबैक क्रम: hooks.gmail.model → agents.defaults.model.fallbacks → प्राथमिक (auth/rate-limit/timeouts)।
  • यदि agents.defaults.models सेट है, तो Gmail मॉडल allowlist में होना चाहिए।
  • Gmail hook content डिफ़ॉल्ट रूप से external-content safety boundaries के साथ wrap किया जाता है। Disable करने के लिए (खतरनाक), hooks.gmail.allowUnsafeExternalContent: true सेट करें।
पेलोड हैंडलिंग को और अनुकूलित करने के लिए, hooks.mappings जोड़ें या hooks.transformsDir के अंतर्गत JS/TS ट्रांसफ़ॉर्म मॉड्यूल जोड़ें (देखें Webhooks)।

​
विज़ार्ड (अनुशंसित)

सब कुछ एक साथ वायर करने के लिए OpenClaw हेल्पर का उपयोग करें (macOS पर brew के माध्यम से deps इंस्टॉल करता है): 
openclaw webhooks gmail setup \
  --account [email protected]
डिफ़ॉल्ट्स:
  • सार्वजनिक पुश एंडपॉइंट के लिए Tailscale Funnel का उपयोग करता है।
  • openclaw webhooks gmail run के लिए hooks.gmail config लिखता है।
  • Gmail hook preset (hooks.presets: ["gmail"]) सक्षम करता है।
Path note: जब tailscale.mode enabled हो, OpenClaw अपने आप hooks.gmail.serve.path को / पर सेट करता है और public path को hooks.gmail.tailscale.path (डिफ़ॉल्ट /gmail-pubsub) पर रखता है क्योंकि Tailscale proxying से पहले set-path prefix को strip कर देता है। यदि आपको backend को prefixed path प्राप्त करने की आवश्यकता है, तो hooks.gmail.tailscale.target (या --tailscale-target) को http://127.0.0.1:8788/gmail-pubsub जैसे full URL पर सेट करें और hooks.gmail.serve.path से match करें। क्या आपको एक कस्टम एंडपॉइंट चाहिए? --push-endpoint <url> या --tailscale off का उपयोग करें। प्लैटफ़ॉर्म नोट: macOS पर विज़ार्ड gcloud, gogcli, और tailscale Homebrew के माध्यम से इंस्टॉल करता है; Linux पर इन्हें पहले मैन्युअली इंस्टॉल करें। Gateway ऑटो-स्टार्ट (अनुशंसित):
  • जब hooks.enabled=true और hooks.gmail.account सेट होता है, तो Gateway बूट पर gog gmail watch serve शुरू करता है और watch को स्वतः नवीनीकृत करता है।
  • ऑप्ट आउट करने के लिए OPENCLAW_SKIP_GMAIL_WATCHER=1 सेट करें (उपयोगी यदि आप डेमन स्वयं चलाते हैं)।
  • मैन्युअल डेमन को एक ही समय पर न चलाएँ, अन्यथा listen tcp 127.0.0.1:8788: bind: address already in use का सामना करेंगे।
मैन्युअल डेमन ( gog gmail watch serve शुरू करता है + ऑटो-रिन्यू): 
openclaw webhooks gmail run

​
एक-बार का सेटअप

  1. उस GCP प्रोजेक्ट का चयन करें जो OAuth क्लाइंट का स्वामी है जिसका उपयोग gog करता है।
gcloud auth login
gcloud config set project <project-id>
नोट: Gmail watch के लिए Pub/Sub टॉपिक उसी प्रोजेक्ट में होना आवश्यक है जिसमें OAuth क्लाइंट है।
  1. APIs सक्षम करें:
gcloud services enable gmail.googleapis.com pubsub.googleapis.com
  1. एक टॉपिक बनाएँ:
gcloud pubsub topics create gog-gmail-watch
  1. Gmail push को प्रकाशित करने की अनुमति दें:
gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
  --member=serviceAccount:[email protected] \
  --role=roles/pubsub.publisher

​
watch शुरू करें

gog gmail watch start \
  --account [email protected] \
  --label INBOX \
  --topic projects/<project-id>/topics/gog-gmail-watch
आउटपुट से history_id सहेजें (डिबगिंग के लिए)।

​
पुश हैंडलर चलाएँ

लोकल उदाहरण (shared token auth): 
gog gmail watch serve \
  --account [email protected] \
  --bind 127.0.0.1 \
  --port 8788 \
  --path /gmail-pubsub \
  --token <shared> \
  --hook-url http://127.0.0.1:18789/hooks/gmail \
  --hook-token OPENCLAW_HOOK_TOKEN \
  --include-body \
  --max-bytes 20000
नोट्स:
  • --token पुश एंडपॉइंट (x-gog-token या ?token=) की सुरक्षा करता है।
  • --hook-url OpenClaw /hooks/gmail की ओर इशारा करता है (मैप्ड; आइसोलेटेड रन + मुख्य को सारांश)।
  • --include-body और --max-bytes OpenClaw को भेजे जाने वाले बॉडी स्निपेट को नियंत्रित करते हैं।
अनुशंसित: openclaw webhooks gmail run उसी फ़्लो को रैप करता है और watch को स्वतः नवीनीकृत करता है।

​
हैंडलर को एक्सपोज़ करें (उन्नत, असमर्थित)

यदि आपको non-Tailscale टनल की आवश्यकता है, तो इसे मैन्युअली वायर करें और पुश सब्सक्रिप्शन में सार्वजनिक URL का उपयोग करें (असमर्थित, बिना गार्डरेल्स): 
cloudflared tunnel --url http://127.0.0.1:8788 --no-autoupdate
जेनरेटेड URL को पुश एंडपॉइंट के रूप में उपयोग करें: 
gcloud pubsub subscriptions create gog-gmail-watch-push \
  --topic gog-gmail-watch \
  --push-endpoint "https://<public-url>/gmail-pubsub?token=<shared>"
प्रोडक्शन: एक स्थिर HTTPS एंडपॉइंट का उपयोग करें और Pub/Sub OIDC JWT कॉन्फ़िगर करें, फिर चलाएँ: 
gog gmail watch serve --verify-oidc --oidc-email <svc@...>

​
परीक्षण

वॉच किए गए इनबॉक्स पर एक संदेश भेजें: 
gog gmail send \
  --account [email protected] \
  --to [email protected] \
  --subject "watch test" \
  --body "ping"
watch स्थिति और इतिहास जाँचें: 
gog gmail watch status --account [email protected]
gog gmail history --account [email protected] --since <historyId>

​
समस्या-निवारण

  • Invalid topicName: प्रोजेक्ट मिसमैच (टॉपिक OAuth क्लाइंट प्रोजेक्ट में नहीं है)।
  • User not authorized: टॉपिक पर roles/pubsub.publisher अनुपस्थित।
  • खाली संदेश: Gmail push केवल historyId प्रदान करता है; gog gmail history के माध्यम से फ़ेच करें।

​
सफ़ाई

gog gmail watch stop --account [email protected]
gcloud pubsub subscriptions delete gog-gmail-watch-push
gcloud pubsub topics delete gog-gmail-watch