​

Google Chat (Chat API)

​

त्वरित सेटअप (शुरुआती)

1. एक Google Cloud प्रोजेक्ट बनाएँ और Google Chat API सक्षम करें।
   • यहाँ जाएँ: Google Chat API Credentials
   • यदि API पहले से सक्षम नहीं है तो उसे सक्षम करें।
2. एक Service Account बनाएँ:
   • Create Credentials > Service Account पर क्लिक करें।
   • इसे कोई भी नाम दें (उदाहरण: openclaw-chat)।
   • अनुमतियाँ खाली छोड़ दें (Continue दबाएँ)।
   • पहुँच वाले principals खाली छोड़ दें (Done दबाएँ)।
3. JSON Key बनाएँ और डाउनलोड करें:
   • Service accounts की सूची में, अभी बनाए गए खाते पर क्लिक करें।
   • 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 भरें:
     • App name: (उदाहरण: OpenClaw)
     • Avatar URL: (उदाहरण: https://openclaw.ai/logo.png)
     • Description: (उदाहरण: Personal AI Assistant)
   • 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 जोड़कर सेट करें।
     • सुझाव: अपने Gateway का सार्वजनिक URL खोजने के लिए openclaw status चलाएँ।
   • Visibility के अंतर्गत Make this Chat app available to specific people and groups in <Your Domain> चुनें।
   • टेक्स्ट बॉक्स में अपना ईमेल पता दर्ज करें (उदाहरण: [email protected])।
   • नीचे Save पर क्लिक करें।
6. ऐप स्थिति सक्षम करें:
   • सहेजने के बाद, पृष्ठ को रीफ़्रेश करें।
   • App status अनुभाग खोजें (आमतौर पर सहेजने के बाद ऊपर या नीचे होता है)।
   • स्थिति को Live - available to users में बदलें।
   • फिर से Save पर क्लिक करें।
7. Service account पथ + webhook audience के साथ OpenClaw को विन्यस्त करें:
   • Env: GOOGLE_CHAT_SERVICE_ACCOUNT_FILE=/path/to/service-account.json
   • या config: channels.googlechat.serviceAccountFile: "/path/to/service-account.json"।
8. webhook audience प्रकार + मान सेट करें (जो आपके Chat ऐप विन्यास से मेल खाता हो)।
9. Gateway प्रारंभ करें। Google Chat will POST to your webhook path.

​

Google Chat में जोड़ें

1. Google Chat पर जाएँ।
2. Direct Messages के पास + (प्लस) आइकन पर क्लिक करें।
3. खोज बार में (जहाँ आप सामान्यतः लोगों को जोड़ते हैं), Google Cloud Console में विन्यस्त किया गया App name टाइप करें।
   • Note: The bot will not appear in the “Marketplace” browse list because it is a private app. You must search for it by name.
4. परिणामों में से अपने बॉट का चयन करें।
5. 1:1 बातचीत शुरू करने के लिए Add या Chat पर क्लिक करें।
6. सहायक को ट्रिगर करने के लिए “Hello” भेजें!

​

सार्वजनिक URL (केवल वेबहुक)

​

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

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

Note: This configuration persists across reboots. To remove it later, run tailscale funnel reset and 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 sends webhook POSTs to the gateway. Each request includes an Authorization: Bearer <token> header.
2. OpenClaw टोकन को विन्यस्त audienceType + audience के विरुद्ध सत्यापित करता है:
   • audienceType: "app-url" → audience आपका HTTPS वेबहुक URL होता है।
   • audienceType: "project-number" → audience Cloud प्रोजेक्ट नंबर होता है।
3. संदेश space के अनुसार रूट किए जाते हैं:
   • DMs सत्र कुंजी agent:<agentId>:googlechat:dm:<spaceId> का उपयोग करते हैं।
   • Spaces सत्र कुंजी agent:<agentId>:googlechat:group:<spaceId> का उपयोग करते हैं।
4. DM access is pairing by default. Unknown senders receive a pairing code; approve with:
   • openclaw pairing approve googlechat <code>
5. Group spaces require @-mention by default. Use botUser if mention detection needs the app’s user name.

​

लक्ष्य

• Direct messages: users/<userId> या users/<email> (ईमेल पते स्वीकार्य हैं)।
• Spaces: spaces/<spaceId>।
• Spaces: spaces/<spaceId>।

​

विन्यास के मुख्य बिंदु

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url",
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890", // optional; helps mention detection
      dm: {
        policy: "pairing",
        allowFrom: ["users/1234567890", "[email protected]"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": {
          allow: true,
          requireMention: true,
          users: ["users/1234567890"],
          systemPrompt: "Short answers only.",
        },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• Service account क्रेडेंशियल्स को serviceAccount (JSON स्ट्रिंग) के साथ inline भी पास किया जा सकता है।
• यदि webhookPath सेट नहीं है, तो डिफ़ॉल्ट वेबहुक पथ /googlechat होता है।
• Reactions reactions टूल और channels action के माध्यम से उपलब्ध हैं जब actions.reactions सक्षम हो।
• typingIndicator none, message (डिफ़ॉल्ट), और reaction का समर्थन करता है (reaction के लिए user OAuth आवश्यक है)।
• Attachments Chat API के माध्यम से डाउनलोड किए जाते हैं और media pipeline में संग्रहीत होते हैं (आकार सीमा mediaMaxMb द्वारा निर्धारित)।

​

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

​

405 Method Not Allowed

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

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

openclaw channels status
# Should show: Google Chat default: enabled, configured, ...

​

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

• प्रमाणीकरण त्रुटियों या missing audience config के लिए openclaw channels status --probe जाँचें।
• यदि कोई संदेश नहीं पहुँचता, तो Chat ऐप के वेबहुक URL + event subscriptions की पुष्टि करें।
• यदि mention gating उत्तरों को रोकता है, तो botUser को ऐप के user resource name पर सेट करें और requireMention सत्यापित करें।
• परीक्षण संदेश भेजते समय यह देखने के लिए openclaw logs --follow का उपयोग करें कि अनुरोध Gateway तक पहुँच रहे हैं या नहीं।

• Gateway configuration
• Security
• Reactions