Google Chat

​

इंस्टॉल करें

openclaw plugins install @openclaw/googlechat

openclaw plugins install ./path/to/local/googlechat-plugin

​

त्वरित सेटअप (शुरुआती उपयोगकर्ताओं के लिए)

1. एक Google Cloud प्रोजेक्ट बनाएँ और Google Chat API सक्षम करें।
   • यहाँ जाएँ: Google Chat API Credentials
   • यदि API पहले से सक्षम नहीं है, तो इसे सक्षम करें।
2. एक Service Account बनाएँ:
   • Create Credentials > Service Account दबाएँ।
   • इसे अपनी पसंद का कोई भी नाम दें (उदाहरण के लिए, openclaw-chat)।
   • अनुमतियाँ और प्रिंसिपल खाली छोड़ें (Continue, फिर Done)।
3. JSON key बनाएँ और डाउनलोड करें:
   • नए सर्विस अकाउंट पर क्लिक करें > Keys टैब > Add Key > Create new key > JSON > Create।
4. डाउनलोड की गई JSON फ़ाइल को अपने Gateway होस्ट पर संग्रहीत करें (उदाहरण के लिए, ~/.openclaw/googlechat-service-account.json)।
5. Google Cloud Console Chat Configuration में एक Google Chat ऐप बनाएँ:
   • Application info (ऐप का नाम, अवतार URL, विवरण) भरें।
   • Interactive features सक्षम करें।
   • Functionality के अंतर्गत, Join spaces and group conversations चुनें।
   • Connection settings के अंतर्गत, HTTP endpoint URL चुनें।
   • Triggers के अंतर्गत, Use a common HTTP endpoint URL for all triggers चुनें और इसे अपने सार्वजनिक Gateway URL के बाद /googlechat लगाकर सेट करें (सार्वजनिक URL देखें)।
   • Visibility के अंतर्गत, Make this Chat app available to specific people and groups in <Your Domain> चुनें और अपना ईमेल पता दर्ज करें।
   • Save पर क्लिक करें।
6. ऐप की स्थिति सक्षम करें: पृष्ठ रीफ़्रेश करें, App status ढूँढें, इसे Live - available to users पर सेट करें और फिर से Save करें।
7. OpenClaw को सर्विस अकाउंट और Webhook ऑडियंस के साथ कॉन्फ़िगर करें (यह Chat ऐप कॉन्फ़िगरेशन से मेल खाना चाहिए):
   • पर्यावरण चर: GOOGLE_CHAT_SERVICE_ACCOUNT_FILE=/path/to/service-account.json (केवल डिफ़ॉल्ट अकाउंट), या
   • कॉन्फ़िगरेशन: कॉन्फ़िगरेशन की मुख्य बातें देखें। openclaw channels add --channel googlechat में --audience-type, --audience, --webhook-path, और --webhook-url भी स्वीकार किए जाते हैं।
8. Gateway शुरू करें। Google Chat आपके Webhook पथ (डिफ़ॉल्ट /googlechat) पर POST करेगा।

​

Google Chat में जोड़ें

1. Google Chat पर जाएँ।
2. Direct Messages के बगल में स्थित + (प्लस) आइकन पर क्लिक करें।
3. Google Cloud Console में कॉन्फ़िगर किया गया App name खोजें।
   • बॉट Marketplace की ब्राउज़ सूची में नहीं दिखाई देता, क्योंकि यह एक निजी ऐप है; इसे नाम से खोजें।
4. बॉट चुनें, Add या Chat पर क्लिक करें और संदेश भेजें।

​

सार्वजनिक URL (केवल Webhook)

​

विकल्प A: Tailscale Funnel (अनुशंसित)

1. जाँचें कि आपका Gateway किस पते से बँधा है:
   ss -tlnp | grep 18789
   
   IP नोट करें (उदाहरण के लिए, 127.0.0.1, 0.0.0.0, या कोई Tailscale 100.x.x.x पता)।
2. डैशबोर्ड को केवल tailnet पर उपलब्ध कराएँ (पोर्ट 8443):
   # यदि localhost (127.0.0.1 या 0.0.0.0) से बँधा है:
   tailscale serve --bg --https 8443 http://127.0.0.1:18789
   
   # यदि केवल Tailscale IP से बँधा है:
   tailscale serve --bg --https 8443 http://100.x.x.x:18789
   
3. केवल Webhook पथ को सार्वजनिक रूप से उपलब्ध कराएँ:
   # यदि localhost (127.0.0.1 या 0.0.0.0) से बँधा है:
   tailscale funnel --bg --set-path /googlechat http://127.0.0.1:18789/googlechat
   
   # यदि केवल Tailscale IP से बँधा है:
   tailscale funnel --bg --set-path /googlechat http://100.x.x.x:18789/googlechat
   
4. यदि संकेत दिया जाए, तो इस Node के लिए Funnel सक्षम करने हेतु आउटपुट में दिखाए गए प्राधिकरण URL पर जाएँ।
5. सत्यापित करें:
   tailscale serve status
   tailscale funnel status
   

नोट: यह कॉन्फ़िगरेशन रीबूट के बाद भी बना रहता है। इसे बाद में tailscale funnel reset और tailscale serve reset से हटाएँ।

​

विकल्प B: रिवर्स प्रॉक्सी (Caddy)

your-domain.com {
    reverse_proxy /googlechat* localhost:18789
}

​

विकल्प C: Cloudflare Tunnel

• Path: /googlechat -> http://localhost:18789/googlechat
• Default rule: HTTP 404 (Not Found)

​

यह कैसे काम करता है

1. Google Chat Gateway Webhook पथ पर JSON POST करता है (केवल POST, JSON सामग्री प्रकार आवश्यक, प्रति-IP दर सीमित)।
2. OpenClaw प्रत्येक अनुरोध को भेजने से पहले प्रमाणित करता है:
   • Chat ऐप इवेंट में Authorization: Bearer <token> होता है; पूरा बॉडी पार्स करने से पहले टोकन सत्यापित किया जाता है।
   • Google Workspace ऐड-ऑन इवेंट में टोकन बॉडी (authorizationEventObject.systemIdToken) में होता है और सत्यापन से पहले इसे अधिक कड़े पूर्व-प्रमाणीकरण बजट (16 KB, 3 s) के अंतर्गत पढ़ा जाता है।
3. टोकन की जाँच audienceType + audience के विरुद्ध की जाती है:
   • audienceType: "app-url" → ऑडियंस आपका HTTPS Webhook URL है।
   • audienceType: "project-number" → ऑडियंस Cloud प्रोजेक्ट नंबर है।
   • app-url के अंतर्गत ऐड-ऑन टोकन के लिए अतिरिक्त रूप से appPrincipal को ऐप की संख्यात्मक OAuth 2.0 क्लाइंट ID (21 अंक, ईमेल नहीं) पर सेट करना आवश्यक है; अन्यथा लॉग चेतावनी के साथ सत्यापन विफल हो जाता है।
4. संदेश स्पेस के अनुसार रूट होते हैं:
   • स्पेस को प्रति-स्पेस सत्र agent:<agentId>:googlechat:group:<spaceId> मिलते हैं; उत्तर संदेश थ्रेड में जाते हैं।
   • डिफ़ॉल्ट रूप से DMs एजेंट के मुख्य सत्र में समाहित हो जाते हैं; प्रति-पीयर DM सत्रों के लिए session.dmScope सेट करें (सत्र देखें)।
5. DM एक्सेस डिफ़ॉल्ट रूप से पेयरिंग है। अज्ञात प्रेषकों को एक पेयरिंग कोड मिलता है; इससे स्वीकृत करें:
   • openclaw pairing approve googlechat <code>
6. ग्रुप स्पेस में डिफ़ॉल्ट रूप से @-उल्लेख आवश्यक है। उल्लेखों का पता ऐप को लक्षित करने वाली Chat USER_MENTION टिप्पणियों से लगाया जाता है; यदि पहचान के लिए ऐप के उपयोगकर्ता संसाधन नाम की आवश्यकता हो, तो botUser (उदाहरण के लिए, users/1234567890) सेट करें।
7. जब Google Chat से कोई exec या plugin अनुमोदन शुरू होता है और एक स्थिर users/<id> अनुमोदक कॉन्फ़िगर किया गया हो, तो OpenClaw मूल स्पेस या थ्रेड में एक नेटिव अनुमोदन कार्ड (cardsV2) पोस्ट करता है। कार्ड बटन में अपारदर्शी कॉलबैक टोकन होते हैं; मैन्युअल /approve <id> <decision> प्रॉम्प्ट केवल तब दिखाई देता है, जब नेटिव डिलीवरी उपलब्ध नहीं होती।

​

इनबाउंड स्थायित्व

​

लक्ष्य

• सीधे संदेश: users/<userId> (अनुशंसित)।
• स्पेस: spaces/<spaceId>।
• रॉ ईमेल name@example.com परिवर्तनशील है और अनुमतिसूची मिलान के लिए केवल तब उपयोग होता है, जब channels.googlechat.dangerouslyAllowNameMatching: true।
• बहिष्कृत: users/<email> को उपयोगकर्ता ID माना जाता है, ईमेल अनुमतिसूची प्रविष्टि नहीं।
• उपसर्ग googlechat:, google-chat:, और gchat: स्वीकार करके हटा दिए जाते हैं।

​

कॉन्फ़िगरेशन की मुख्य बातें

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      // या serviceAccountRef: { source: "file", provider: "filemain", id: "/channels/googlechat/serviceAccount" }
      audienceType: "app-url",
      audience: "https://gateway.example.com/googlechat",
      appPrincipal: "123456789012345678901", // केवल ऐड-ऑन सत्यापन; संख्यात्मक OAuth क्लाइंट ID
      webhookPath: "/googlechat",
      botUser: "users/1234567890", // वैकल्पिक; उल्लेख पहचान में सहायता करता है
      allowBots: false,
      dmPolicy: "pairing",
      allowFrom: ["users/1234567890"],
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": {
          enabled: true,
          requireMention: true,
          users: ["users/1234567890"],
          systemPrompt: "केवल संक्षिप्त उत्तर।",
        },
      },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• सर्विस अकाउंट क्रेडेंशियल: serviceAccountFile (पथ), serviceAccount (इनलाइन JSON स्ट्रिंग या ऑब्जेक्ट), या serviceAccountRef (पर्यावरण चर/फ़ाइल SecretRef)। पर्यावरण चर GOOGLE_CHAT_SERVICE_ACCOUNT (इनलाइन JSON) और GOOGLE_CHAT_SERVICE_ACCOUNT_FILE (पथ) केवल डिफ़ॉल्ट अकाउंट पर लागू होते हैं। बहु-अकाउंट सेटअप समान कुंजियों के साथ channels.googlechat.accounts.<id> का उपयोग करते हैं, जिसमें प्रति-अकाउंट serviceAccountRef भी शामिल है।
• webhookPath सेट न होने पर डिफ़ॉल्ट Webhook पथ /googlechat होता है; इसके बजाय webhookUrl पथ प्रदान कर सकता है।
• ग्रुप कुंजियाँ स्थिर स्पेस ID (spaces/<spaceId>) होनी चाहिए। प्रदर्शन-नाम कुंजियाँ बहिष्कृत हैं और उसी रूप में लॉग की जाती हैं।
• dangerouslyAllowNameMatching अनुमतिसूचियों के लिए परिवर्तनशील ईमेल प्रिंसिपल मिलान को फिर से सक्षम करता है (आपातकालीन संगतता मोड); doctor ईमेल प्रविष्टियों के बारे में चेतावनी देता है।
• Google Chat प्रतिक्रिया क्रियाएँ उपलब्ध नहीं कराई जातीं। plugin सर्विस-अकाउंट प्रमाणीकरण का उपयोग करता है, जबकि Google Chat प्रतिक्रिया endpoints के लिए उपयोगकर्ता प्रमाणीकरण आवश्यक है। मौजूदा actions.reactions कॉन्फ़िगरेशन संगतता के लिए स्वीकार किया जाता है, लेकिन इसका कोई प्रभाव नहीं पड़ता।
• नेटिव अनुमोदन कार्ड प्रतिक्रिया इवेंट के बजाय Google Chat cardsV2 बटन क्लिक का उपयोग करते हैं। अनुमोदक allowFrom या defaultTo से आते हैं और वे स्थिर संख्यात्मक users/<id> मान होने चाहिए।
• संदेश क्रियाएँ केवल टेक्स्ट send उपलब्ध कराती हैं। Google Chat अटैचमेंट अपलोड के लिए उपयोगकर्ता प्रमाणीकरण आवश्यक है, जबकि यह plugin सर्विस-अकाउंट प्रमाणीकरण का उपयोग करता है, इसलिए आउटबाउंड फ़ाइल अपलोड उपलब्ध नहीं कराया जाता।
• typingIndicator: message (डिफ़ॉल्ट) एक _<Bot> is typing..._ प्लेसहोल्डर पोस्ट करता है और उसे पहले उत्तर में संपादित करता है; none इसे अक्षम करता है; reaction के लिए उपयोगकर्ता OAuth आवश्यक है और फ़िलहाल सर्विस-अकाउंट प्रमाणीकरण के अंतर्गत लॉग की गई त्रुटि के साथ message पर वापस जाता है।
• इनबाउंड अटैचमेंट (प्रति संदेश पहला अटैचमेंट) Chat API के माध्यम से मीडिया पाइपलाइन में डाउनलोड किए जाते हैं और mediaMaxMb (डिफ़ॉल्ट 20) द्वारा सीमित होते हैं।
• बॉट द्वारा लिखे गए संदेश डिफ़ॉल्ट रूप से अनदेखे किए जाते हैं। allowBots: true के साथ, स्वीकार किए गए बॉट संदेश साझा बॉट लूप सुरक्षा का उपयोग करते हैं: channels.defaults.botLoopProtection कॉन्फ़िगर करें, फिर channels.googlechat.botLoopProtection या channels.googlechat.groups.<space>.botLoopProtection से ओवरराइड करें।

​

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

​

405 Method Not Allowed

status code: 405, reason phrase: HTTP error response: HTTP/1.1 405 Method Not Allowed

1. चैनल कॉन्फ़िगर नहीं किया गया है: channels.googlechat अनुभाग मौजूद नहीं है। इससे सत्यापित करें:
   openclaw config get channels.googlechat
   
   यदि यह “Config path not found” लौटाता है, तो कॉन्फ़िगरेशन जोड़ें (कॉन्फ़िगरेशन की मुख्य बातें देखें)।
2. Plugin सक्षम नहीं है: Plugin की स्थिति जाँचें:
   openclaw plugins list | grep googlechat
   
   यदि यह “disabled” दिखाता है, तो अपने कॉन्फ़िगरेशन में plugins.entries.googlechat.enabled: true जोड़ें।
3. कॉन्फ़िगरेशन में बदलाव के बाद Gateway को पुनः आरंभ नहीं किया गया है:
   openclaw gateway restart
   

openclaw channels status
# यह दिखाई देना चाहिए: Google Chat default: enabled, configured, ...

​

अन्य समस्याएँ

• openclaw channels status --probe प्रमाणीकरण त्रुटियाँ और अनुपस्थित ऑडियंस कॉन्फ़िगरेशन दिखाता है (audience और audienceType दोनों आवश्यक हैं)।
• यदि कोई संदेश नहीं आता है, तो Chat ऐप के Webhook URL और ट्रिगर कॉन्फ़िगरेशन की पुष्टि करें।
• यदि मेंशन गेटिंग उत्तरों को अवरुद्ध करती है, तो botUser को ऐप के उपयोगकर्ता संसाधन नाम पर सेट करें और requireMention जाँचें।
• परीक्षण संदेश भेजते समय openclaw logs --follow यह दिखाता है कि अनुरोध Gateway तक पहुँच रहे हैं या नहीं।

​

संबंधित

• चैनलों का अवलोकन — सभी समर्थित चैनल
• चैनल रूटिंग — संदेशों के लिए सत्र रूटिंग
• Gateway कॉन्फ़िगरेशन
• समूह — समूह चैट का व्यवहार और मेंशन गेटिंग
• पेयरिंग — DM प्रमाणीकरण और पेयरिंग प्रवाह
• सुरक्षा — पहुँच मॉडल और सुदृढ़ीकरण