> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chat

# Google Chat (Chat API)

स्थिति: Google Chat API वेबहुक्स (केवल HTTP) के माध्यम से DMs + spaces के लिए तैयार।

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

1. एक Google Cloud प्रोजेक्ट बनाएँ और **Google Chat API** सक्षम करें।
   * यहाँ जाएँ: [Google Chat API Credentials](https://console.cloud.google.com/apis/api/chat.googleapis.com/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](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat) में एक 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>** चुनें।
   * टेक्स्ट बॉक्स में अपना ईमेल पता दर्ज करें (उदाहरण: `user@example.com`)।
   * नीचे **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 में जोड़ें

जब Gateway चल रहा हो और आपका ईमेल visibility सूची में जोड़ा गया हो:

1. [Google Chat](https://chat.google.com/) पर जाएँ।
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 (केवल वेबहुक)

Google Chat webhooks require a public HTTPS endpoint. For security, **only expose the `/googlechat` path** to the internet. Keep the OpenClaw dashboard and other sensitive endpoints on your private network.

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

Use Tailscale Serve for the private dashboard and Funnel for the public webhook path. This keeps `/` private while exposing only `/googlechat`.

1. **जाँचें कि आपका Gateway किस पते से बाउंड है:**

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   ss -tlnp | grep 18789
   ```

   IP पता नोट करें (उदाहरण: `127.0.0.1`, `0.0.0.0`, या आपका Tailscale IP जैसे `100.x.x.x`)।

2. **डैशबोर्ड को केवल tailnet के लिए एक्सपोज़ करें (पोर्ट 8443):**

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   # 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. **केवल वेबहुक पथ को सार्वजनिक रूप से एक्सपोज़ करें:**

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   # 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. **विन्यास सत्यापित करें:**

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   tailscale serve status
   tailscale funnel status
   ```

Your public webhook URL will be:
`https://<node-name>.<tailnet>.ts.net/googlechat`

Your private dashboard stays tailnet-only:
`https://<node-name>.<tailnet>.ts.net:8443/`

Google Chat ऐप विन्यास में सार्वजनिक URL का उपयोग करें (बिना `:8443` के)।

> Note: This configuration persists across reboots. To remove it later, run `tailscale funnel reset` and `tailscale serve reset`.

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

यदि आप Caddy जैसा रिवर्स प्रॉक्सी उपयोग करते हैं, तो केवल विशिष्ट पथ को प्रॉक्सी करें:

```caddy theme={"theme":{"light":"min-light","dark":"min-dark"}}
your-domain.com {
    reverse_proxy /googlechat* localhost:18789
}
```

इस विन्यास के साथ, `your-domain.com/` पर आने वाला कोई भी अनुरोध अनदेखा किया जाएगा या 404 लौटाएगा, जबकि `your-domain.com/googlechat` सुरक्षित रूप से OpenClaw तक रूट किया जाएगा।

### विकल्प C: Cloudflare Tunnel

अपने टनल की ingress नियमों को केवल वेबहुक पथ रूट करने के लिए विन्यस्त करें:

* **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.

## लक्ष्य

डिलीवरी और allowlists के लिए इन पहचानकर्ताओं का उपयोग करें:

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

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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", "name@example.com"],
      },
      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

यदि Google Cloud Logs Explorer में इस प्रकार की त्रुटियाँ दिखाई दें:

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

This means the webhook handler isn't registered. Common causes:

1. **Channel not configured**: The `channels.googlechat` section is missing from your config. सत्यापित करें:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw config get channels.googlechat
   ```

   यदि यह "Config path not found" लौटाता है, तो विन्यास जोड़ें (देखें [Config highlights](#config-highlights))।

2. **प्लगइन सक्षम नहीं**: प्लगइन स्थिति जाँचें:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw plugins list | grep googlechat
   ```

   यदि यह "disabled" दिखाता है, तो अपने config में `plugins.entries.googlechat.enabled: true` जोड़ें।

3. **Gateway पुनः आरंभ नहीं किया गया**: config जोड़ने के बाद Gateway को पुनः आरंभ करें:

   ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
   openclaw gateway restart
   ```

सत्यापित करें कि चैनल चल रहा है:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/gateway/configuration)
* [Security](/gateway/security)
* [Reactions](/tools/reactions)