​

Microsoft Teams (प्लगइन)

“जो यहाँ प्रवेश करे, सारी आशा त्याग दे।”

​

प्लगइन आवश्यक

openclaw plugins install @openclaw/msteams

openclaw plugins install ./extensions/msteams

​

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

1. Microsoft Teams प्लगइन इंस्टॉल करें।
2. एक Azure Bot बनाएँ (App ID + client secret + tenant ID)।
3. उन क्रेडेंशियल्स के साथ OpenClaw को कॉन्फ़िगर करें।
4. /api/messages (डिफ़ॉल्ट रूप से पोर्ट 3978) को सार्वजनिक URL या टनल के माध्यम से एक्सपोज़ करें।
5. Teams ऐप पैकेज इंस्टॉल करें और Gateway प्रारंभ करें।

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      appPassword: "<APP_PASSWORD>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

​

लक्ष्य

• Teams DMs, समूह चैट या चैनलों के माध्यम से OpenClaw से बात करना।
• रूटिंग को निर्धारक रखना: उत्तर हमेशा उसी चैनल में वापस जाएँ जहाँ से वे आए।
• सुरक्षित चैनल व्यवहार को डिफ़ॉल्ट रखना (जब तक अन्यथा कॉन्फ़िगर न हो, mentions आवश्यक)।

​

Config लिखना

{
  channels: { msteams: { configWrites: false } },
}

​

प्रवेश नियंत्रण (DMs + समूह)

• डिफ़ॉल्ट: channels.msteams.dmPolicy = "pairing"। अज्ञात प्रेषकों को स्वीकृति मिलने तक अनदेखा किया जाता है।
• channels.msteams.allowFrom AAD object IDs, UPNs, या display names स्वीकार करता है। जब क्रेडेंशियल्स अनुमति देते हैं, तो विज़ार्ड Microsoft Graph के माध्यम से नामों को IDs में resolve करता है।

• डिफ़ॉल्ट: channels.msteams.groupPolicy = "allowlist" (जब तक आप groupAllowFrom नहीं जोड़ते, तब तक ब्लॉक रहता है)। जब सेट न हो, तो डिफ़ॉल्ट को ओवरराइड करने के लिए channels.defaults.groupPolicy का उपयोग करें।
• channels.msteams.groupAllowFrom नियंत्रित करता है कि समूह चैट/चैनलों में कौन से प्रेषक ट्रिगर कर सकते हैं (fallback: channels.msteams.allowFrom)।
• किसी भी सदस्य को अनुमति देने के लिए groupPolicy: "open" सेट करें (डिफ़ॉल्ट रूप से अभी भी mention‑gated)।
• कोई चैनल नहीं अनुमति देने के लिए channels.msteams.groupPolicy: "disabled" सेट करें।

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["[email protected]"],
    },
  },
}

• channels.msteams.teams के अंतर्गत teams और channels सूचीबद्ध करके समूह/चैनल उत्तरों का दायरा सीमित करें।
• Keys टीम IDs या नाम हो सकते हैं; चैनल keys conversation IDs या नाम हो सकते हैं।
• जब groupPolicy="allowlist" और teams allowlist मौजूद हो, तो केवल सूचीबद्ध teams/channels स्वीकार किए जाते हैं (mention‑gated)।
• configure विज़ार्ड Team/Channel प्रविष्टियाँ स्वीकार करता है और उन्हें आपके लिए सहेज देता है।
• स्टार्टअप पर, OpenClaw टीम/चैनल और उपयोगकर्ता allowlist नामों को IDs में resolve करता है (जब Graph अनुमतियाँ अनुमति दें) और मैपिंग लॉग करता है; जो resolve न हों, वे टाइप किए गए रूप में ही रखे जाते हैं।

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

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

1. Microsoft Teams प्लगइन इंस्टॉल करें।
2. एक Azure Bot बनाएँ (App ID + secret + tenant ID)।
3. एक Teams ऐप पैकेज बनाएँ जो बॉट को संदर्भित करे और नीचे दी गई RSC अनुमतियाँ शामिल करे।
4. Teams ऐप को किसी टीम में (या DMs के लिए personal scope में) अपलोड/इंस्टॉल करें।
5. ~/.openclaw/openclaw.json (या env vars) में msteams कॉन्फ़िगर करें और Gateway प्रारंभ करें।
6. Gateway डिफ़ॉल्ट रूप से /api/messages पर Bot Framework webhook ट्रैफ़िक सुनता है।

​

Azure Bot सेटअप (पूर्वापेक्षाएँ)

​

चरण 1: Azure Bot बनाएँ

1. Create Azure Bot पर जाएँ
2. Basics टैब भरें:

   फ़ील्ड	मान
   बॉट हैंडल	आपका बॉट नाम, जैसे openclaw-msteams (अद्वितीय होना चाहिए)
   सब्सक्रिप्शन	अपनी Azure subscription चुनें
   रिसोर्स ग्रुप	नया बनाएँ या मौजूदा का उपयोग करें
   प्राइसिंग टियर	dev/testing के लिए Free
   Type of App	Single Tenant (अनुशंसित - नीचे नोट देखें)
   Creation type	Create new Microsoft App ID

अप्रचलन सूचना: नए मल्टी-टेनेंट बॉट्स का निर्माण 2025-07-31 के बाद अप्रचलित कर दिया गया। नए बॉट्स के लिए Single Tenant का उपयोग करें।

3. Review + create → Create पर क्लिक करें (~1-2 मिनट प्रतीक्षा करें)

​

चरण 2: क्रेडेंशियल्स प्राप्त करें

1. अपने Azure Bot संसाधन → Configuration पर जाएँ
2. Microsoft App ID कॉपी करें → यही आपका appId है
3. Manage Password पर क्लिक करें → App Registration पर जाएँ
4. Certificates & secrets → New client secret → Value कॉपी करें → यही आपका appPassword है
5. Overview → Directory (tenant) ID कॉपी करें → यही आपका tenantId है

​

चरण 3: Messaging Endpoint कॉन्फ़िगर करें

1. Azure Bot → Configuration
2. Messaging endpoint को अपने webhook URL पर सेट करें:
   • Production: https://your-domain.com/api/messages
   • Local dev: एक टनल का उपयोग करें (नीचे Local Development देखें)

​

चरण 4: Teams चैनल सक्षम करें

1. Azure Bot → Channels
2. Microsoft Teams → Configure → Save पर क्लिक करें
3. सेवा की शर्तें स्वीकार करें

​

Local Development (Tunneling)

ngrok http 3978
# Copy the https URL, e.g., https://abc123.ngrok.io
# Set messaging endpoint to: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Use your Tailscale funnel URL as the messaging endpoint

​

Teams Developer Portal (वैकल्पिक)

1. + New app पर क्लिक करें
2. बुनियादी जानकारी भरें (नाम, विवरण, डेवलपर जानकारी)
3. App features → Bot पर जाएँ
4. Enter a bot ID manually चुनें और अपना Azure Bot App ID पेस्ट करें
5. Scopes चुनें: Personal, Team, Group Chat
6. Distribute → Download app package
7. Teams में: Apps → Manage your apps → Upload a custom app → ZIP चुनें