---
read_when:
    - Discord Activity विजेट सेट अप करना या उनकी समस्या निवारण करना
summary: Discord Activities के भीतर स्व-निहित OpenClaw HTML विजेट लॉन्च करें
title: Discord गतिविधियाँ
x-i18n:
    generated_at: "2026-07-19T08:49:07Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: b1bc04443aef89fd514290c3bebdbdd3e9972298b45cae3806bec99344f6d8cd
    source_path: channels/discord-activities.md
    workflow: 16
---

Discord Activities किसी एजेंट को वर्तमान Discord चैनल में एक इंटरैक्टिव, स्व-निहित HTML विजेट पोस्ट करने देती हैं। संदेश में एक **Open widget** बटन शामिल होता है; इसे क्लिक करने पर विजेट Discord के भीतर खुलता है।

यह सुविधा डिफ़ॉल्ट रूप से बंद रहती है। OpenClaw Activity HTTP रूट, `show_widget` एजेंट टूल और लॉन्च-बटन हैंडलर को केवल तभी पंजीकृत करता है, जब `channels.discord.activities` मौजूद हो और क्लाइंट सीक्रेट उपलब्ध हो जाए। अप्रचलित `discord_widget` उपनाम एक रिलीज़ तक उपलब्ध रहेगा।

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

- एक मौजूदा [OpenClaw Discord बॉट](/hi/channels/discord)
- एक सार्वजनिक HTTPS होस्टनेम, जिससे OpenClaw Gateway तक पहुँचा जा सके
- बॉट के Discord एप्लिकेशन के लिए Activities और OAuth2 कॉन्फ़िगर करने की अनुमति

कोई भी HTTPS रिवर्स प्रॉक्सी या टनल काम करेगी। नामित Cloudflare Tunnel, Gateway पोर्ट को सीधे उजागर किए बिना एक स्थिर होस्टनेम प्रदान करती है।

```yaml
# ~/.cloudflared/config.yml
tunnel: openclaw-discord
credentials-file: /home/you/.cloudflared/TUNNEL-ID.json
ingress:
  - hostname: openclaw.example.com
    service: http://127.0.0.1:18789
  - service: http_status:404
```

```bash
cloudflared tunnel login
cloudflared tunnel create openclaw-discord
cloudflared tunnel route dns openclaw-discord openclaw.example.com
cloudflared tunnel run openclaw-discord
```

सामान्य Gateway प्रमाणीकरण सक्षम रखें। केवल Activity प्रीफ़िक्स सार्वजनिक होता है, और Plugin स्वयं OAuth, Activity इंस्टेंस सदस्यता, चैनल बाइंडिंग, सत्रों और एक-बार उपयोग वाली दस्तावेज़ क्षमताओं को सत्यापित करता है।

## सेटअप

<Steps>
  <Step title="Gateway को HTTPS पर उपलब्ध कराएँ">
    अपनी टनल या रिवर्स प्रॉक्सी शुरू करें और Activities कॉन्फ़िगरेशन जोड़ने के बाद सत्यापित करें कि `https://openclaw.example.com/discord/activity/` से Gateway तक पहुँचा जा सकता है। उदाहरण होस्टनेम को अपने होस्टनेम से बदलें।
  </Step>

  <Step title="Discord में Activities सक्षम करें">
    मौजूदा बॉट एप्लिकेशन को [Discord Developer Portal](https://discord.com/developers/applications) में खोलें। **Activities** खोलें, Activities सक्षम करें और एक URL मैपिंग बनाएँ:

    - प्रीफ़िक्स: `ROOT` (`/`)
    - लक्ष्य: `openclaw.example.com/discord/activity`

    लक्ष्य सार्वजनिक होस्टनेम और `/discord/activity` का संयोजन है, जिसके अंत में स्लैश नहीं होना चाहिए।

  </Step>

  <Step title="OAuth2 क्लाइंट सीक्रेट कॉपी करें">
    Developer Portal में **OAuth2** खोलें। Discord को कम-से-कम एक रीडायरेक्ट URI चाहिए, इसलिए यदि एप्लिकेशन में अभी कोई URI नहीं है, तो लूपबैक पते जैसा कोई स्थानीय प्लेसहोल्डर जोड़ें; Embedded App SDK Activity वापसी प्रवाह संभालता है। एप्लिकेशन क्लाइंट सीक्रेट कॉपी या रीसेट करें। इसे क्रेडेंशियल मानें: इसे चैट, लॉग या कमिट की गई कॉन्फ़िगरेशन फ़ाइल में पेस्ट न करें।
  </Step>

  <Step title="OpenClaw कॉन्फ़िगर करें">
    विजेट उपलब्ध कराने वाले Discord अकाउंट में एक ब्लॉक जोड़ें:

    ```json5
    {
      channels: {
        discord: {
          token: "${DISCORD_BOT_TOKEN}",
          activities: {
            clientSecret: "${DISCORD_CLIENT_SECRET}",
            // वैकल्पिक। डिफ़ॉल्ट रूप से स्टार्टअप पर ज्ञात हुआ बॉट एप्लिकेशन ID उपयोग होता है।
            applicationId: "YOUR_DISCORD_APPLICATION_ID",
          },
        },
      },
    }
    ```

    `DISCORD_CLIENT_SECRET` सेट होने पर आप ब्लॉक से `clientSecret` हटा सकते हैं। विकल्प चुनकर सुविधा सक्षम करने के लिए ब्लॉक स्वयं मौजूद रहना आवश्यक है।

    सामान्य Discord एक्सेस सेटिंग अलग रहती हैं। उदाहरण के लिए, `allowFrom` अब भी यह नियंत्रित करता है कि एजेंट को कौन DM कर सकता है; यह इस बात को नियंत्रित नहीं करता कि किसी चैनल में पहले से पोस्ट किया गया विजेट कौन खोल सकता है।

  </Step>

  <Step title="पुनः आरंभ करके परीक्षण करें">
    Gateway पुनः आरंभ करें। Discord वार्तालाप में एजेंट से एक इंटरैक्टिव विजेट दिखाने के लिए कहें। एजेंट `show_widget` को कॉल करता है; पोस्ट किए गए संदेश पर **Open widget** क्लिक करें।
  </Step>
</Steps>

## सुरक्षा मॉडल

- विजेट मेटाडेटा लौटाए जाने से पहले OAuth, Discord उपयोगकर्ता की पहचान करता है।
- Discord की Get Activity Instance API को यह पुष्टि करनी होगी कि OAuth उपयोगकर्ता वर्तमान Activity इंस्टेंस में मौजूद है। इंस्टेंस चैनल उसी चैनल से मेल खाना चाहिए, जहाँ विजेट पोस्ट किया गया था।
- जिस किसी को भी Discord उस चैनल में प्रवेश की अनुमति देता है, वह उसके विजेट खोल सकता है। दर्शक-वर्ग सीमित करने के लिए Discord चैनल अनुमतियाँ उपयोग करें। OpenClaw कमांड और DM अनुमत-सूचियाँ पहले से पोस्ट की गई चैनल सामग्री का एक्सेस प्रदान या समाप्त नहीं करतीं।
- OAuth सत्र 15 मिनट बाद समाप्त हो जाते हैं। विजेट दस्तावेज़ क्षमताएँ 60 सेकंड बाद समाप्त हो जाती हैं और केवल एक बार काम करती हैं।
- विजेट सात दिनों बाद समाप्त हो जाते हैं और प्रत्येक Discord Plugin इंस्टेंस में अधिकतम 64 विजेट रखे जाते हैं।
- विजेट HTML आपका एजेंट बनाता है और इसे विश्वसनीय सामग्री माना जाना चाहिए। ऐसे सीक्रेट एम्बेड न करें जिन्हें आप किसी त्रुटिपूर्ण विजेट द्वारा उजागर नहीं होने देना चाहते।
- विजेट अपने नेस्टेड फ़्रेम के भीतर नेविगेट कर सकता है। `sandbox="allow-scripts"` iframe शीर्ष-स्तरीय नेविगेशन, पॉपअप और समान-ओरिजिन एक्सेस को अवरुद्ध करता है, जबकि उसकी Content Security Policy नेटवर्क कनेक्शन और बाहरी संसाधनों को अवरुद्ध करती है। ये नियंत्रण बहुस्तरीय सुरक्षा उपाय हैं, विजेट बनाने वाले एजेंट के विरुद्ध कोई सुरक्षा सीमा नहीं।
- Activities अक्षम होने पर `/discord/activity` बिल्कुल भी पंजीकृत नहीं होता।

सक्षम किए जाने पर सार्वजनिक Activity शेल और टोकन-एक्सचेंज रूट आपकी टनल के माध्यम से उपलब्ध हो जाते हैं। वे मान्य OAuth सत्र और एक-बार उपयोग वाली दस्तावेज़ क्षमता के बिना विजेट HTML उजागर नहीं करते।

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

### Activity में “Gateway offline” दिखाई देता है

- पुष्टि करें कि टनल चल रही है और Gateway के वास्तविक बाइंड पोर्ट पर रूट करती है
- पुष्टि करें कि Developer Portal के लक्ष्य में `/discord/activity` शामिल है
- Discord या OpenClaw कॉन्फ़िगरेशन बदलने के बाद Gateway पुनः आरंभ करें
- Activities क्लाइंट सीक्रेट अनुपलब्ध होने की एक-पंक्ति वाली चेतावनी के लिए Gateway लॉग जाँचें

### Discord एक खाली पृष्ठ खोलता है या `blocked:csp` की रिपोर्ट करता है

- सत्यापित करें कि URL मैपिंग `ROOT` का उपयोग करती है और दूसरा `/discord/activity` खंड नहीं जोड़ती
- पुष्टि करें कि शेल, `shell.js` और SDK मॉड्यूल, सभी Discord प्रॉक्सी के माध्यम से लौटते हैं
- `/discord/activity/` के अंतर्गत अनुरोधों के लिए Gateway लॉग की जाँच करें

विजेट के नेटवर्क अनुरोध जानबूझकर अवरुद्ध किए जाते हैं। विजेट के लिए आवश्यक सभी CSS, JavaScript, छवियाँ और डेटा इनलाइन करें।

### “Widget unavailable”

बटन को उसी चैनल से लॉन्च करें, जहाँ एजेंट ने उसे पोस्ट किया था। क्लिक करने पर OpenClaw सर्वर की ओर लॉन्च ट्रैक करता है, इसलिए Discord द्वारा बटन की कस्टम ID छोड़े जाने या बिगाड़े जाने पर भी नया लॉन्च रिकॉर्ड सटीक विजेट निर्धारित कर सकता है। जब न तो कस्टम ID और न ही लॉन्च रिकॉर्ड से विजेट निर्धारित होता है, तो OpenClaw उस चैनल में सबसे हाल में पोस्ट किया गया सक्रिय विजेट खोलता है। जिन बटनों में उनकी कस्टम ID सुरक्षित रहती है, उनके माध्यम से पुराने विजेट अब भी उपलब्ध रहते हैं।

### “You cannot launch Activities in this channel”

Discord फ़ोरम-पोस्ट थ्रेड से Activities लॉन्च नहीं करता। OpenClaw वहाँ विजेट संदेश और बटन पोस्ट कर सकता है, लेकिन इसके बजाय किसी सामान्य टेक्स्ट चैनल से Activity लॉन्च करें। यह प्रतिबंध Discord की ओर से है, OpenClaw की ओर से नहीं।