Microsoft Teams

​

बंडल किया गया Plugin

openclaw plugins install @openclaw/msteams

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

​

त्वरित सेटअप

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # पुष्टि करें कि आप लॉग इन हैं और अपने टेनेंट की जानकारी देखें

# एक बार का सेटअप (सत्रों के बीच स्थायी URL):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# प्रत्येक डेवलपमेंट सत्र:
devtunnel host my-openclaw-bot
# आपका एंडपॉइंट: https://<tunnel-id>.devtunnels.ms/api/messages

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

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

teams app get <teamsAppId> --install-link

teams app doctor <teamsAppId>

​

लक्ष्य

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

​

कॉन्फ़िगरेशन लेखन

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

​

अभिगम नियंत्रण (DM + समूह)

• डिफ़ॉल्ट: channels.msteams.dmPolicy = "pairing"। अज्ञात प्रेषकों को स्वीकृत किए जाने तक अनदेखा किया जाता है।
• channels.msteams.allowFrom में स्थिर AAD ऑब्जेक्ट ID या accessGroup:core-team जैसे स्थिर प्रेषक अभिगम समूहों का उपयोग होना चाहिए।
• अनुमति-सूचियों के लिए UPN/डिस्प्ले-नाम मिलान पर निर्भर न रहें; वे बदल सकते हैं। OpenClaw सीधे नाम मिलान को डिफ़ॉल्ट रूप से अक्षम रखता है; इसे चुनने के लिए channels.msteams.dangerouslyAllowNameMatching: true उपयोग करें।
• क्रेडेंशियल की अनुमति होने पर विज़ार्ड Microsoft Graph के माध्यम से नामों को ID में रिज़ॉल्व कर सकता है।

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

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["00000000-0000-0000-0000-000000000000", "accessGroup:core-team"],
    },
  },
}

• channels.msteams.teams के अंतर्गत टीमों और चैनलों को सूचीबद्ध करके समूह/चैनल उत्तरों का दायरा निर्धारित करें।
• कुंजियों के रूप में Teams लिंक से प्राप्त स्थिर Teams वार्तालाप ID का उपयोग करें, बदल सकने वाले डिस्प्ले नामों का नहीं (टीम और चैनल ID देखें)।
• जब groupPolicy="allowlist" और टीमों की अनुमति-सूची मौजूद हो, तो केवल सूचीबद्ध टीमें/चैनल स्वीकार किए जाते हैं (मेंशन आवश्यक रहता है)।
• कॉन्फ़िगरेशन विज़ार्ड Team/Channel प्रविष्टियाँ स्वीकार करता है और उन्हें आपके लिए संग्रहीत करता है।
• स्टार्टअप पर OpenClaw टीम/चैनल और उपयोगकर्ता अनुमति-सूची के नामों को ID में रिज़ॉल्व करता है (जब Graph अनुमतियाँ इसकी अनुमति देती हैं) और मैपिंग लॉग करता है। जिन नामों को रिज़ॉल्व नहीं किया जा सका, वे टाइप किए गए रूप में रखे जाते हैं, लेकिन channels.msteams.dangerouslyAllowNameMatching: true सेट न होने तक रूटिंग में अनदेखे किए जाते हैं।

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

​

फ़ेडरेटेड प्रमाणीकरण (सर्टिफ़िकेट और मैनेज्ड आइडेंटिटी)

​

विकल्प A: सर्टिफ़िकेट-आधारित प्रमाणीकरण

1. एक सर्टिफ़िकेट जनरेट या प्राप्त करें (निजी कुंजी सहित PEM प्रारूप)।
2. Entra ID → App Registration → Certificates & secrets → Certificates → सार्वजनिक सर्टिफ़िकेट अपलोड करें।

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      certificatePath: "/path/to/cert.pem",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_CERTIFICATE_PATH=/path/to/cert.pem

​

विकल्प B: Azure Managed Identity

1. बॉट पॉड/VM की एक मैनेज्ड आइडेंटिटी होती है (सिस्टम- या उपयोगकर्ता-असाइन की गई)।
2. फ़ेडरेटेड आइडेंटिटी क्रेडेंशियल, मैनेज्ड आइडेंटिटी को Entra ID ऐप पंजीकरण से जोड़ता है।
3. रनटाइम पर OpenClaw, Azure IMDS एंडपॉइंट से टोकन प्राप्त करने के लिए @azure/identity उपयोग करता है।
4. बॉट प्रमाणीकरण के लिए टोकन Teams SDK को दिया जाता है।

• प्रबंधित पहचान सक्षम वाला Azure अवसंरचना (AKS वर्कलोड पहचान, App Service, VM)।
• Entra ID ऐप पंजीकरण पर बनाई गई फ़ेडरेटेड पहचान क्रेडेंशियल।
• पॉड/VM से IMDS (169.254.169.254:80) तक नेटवर्क पहुँच।

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

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id> (केवल उपयोगकर्ता-असाइन की गई पहचान)

​

AKS वर्कलोड पहचान सेटअप

1. अपने AKS क्लस्टर पर वर्कलोड पहचान सक्षम करें।
2. Entra ID ऐप पंजीकरण पर फ़ेडरेटेड पहचान क्रेडेंशियल बनाएँ:
   az ad app federated-credential create --id <APP_OBJECT_ID> --parameters '{
     "name": "my-bot-workload-identity",
     "issuer": "<AKS_OIDC_ISSUER_URL>",
     "subject": "system:serviceaccount:<NAMESPACE>:<SERVICE_ACCOUNT>",
     "audiences": ["api://AzureADTokenExchange"]
   }'
   
3. ऐप क्लाइंट ID के साथ Kubernetes सेवा खाते को एनोटेट करें:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. वर्कलोड पहचान इंजेक्शन के लिए पॉड को लेबल करें:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. IMDS (169.254.169.254) तक नेटवर्क पहुँच की अनुमति दें: यदि NetworkPolicy का उपयोग कर रहे हैं, तो पोर्ट 80 पर 169.254.169.254/32 के लिए एक इग्रेस नियम जोड़ें।

​

प्रमाणीकरण प्रकार की तुलना

​

स्थानीय विकास (टनलिंग)

# एक बार का सेटअप:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# प्रत्येक डेवलपमेंट सत्र:
devtunnel host my-openclaw-bot

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

​

बॉट का परीक्षण

teams app doctor <teamsAppId>

1. Teams ऐप इंस्टॉल करें (teams app get <id> --install-link से इंस्टॉल लिंक)।
2. Teams में बॉट ढूँढें और एक DM भेजें।
3. आने वाली गतिविधि के लिए Gateway लॉग जाँचें।

​

पर्यावरण चर

​

सदस्य जानकारी कार्रवाई

• ChannelSettings.Read.Group और TeamMember.Read.Group RSC अनुमतियाँ (अनुशंसित मैनिफ़ेस्ट में पहले से मौजूद)।

​

इतिहास संदर्भ

• channels.msteams.historyLimit नियंत्रित करता है कि कितने हालिया चैनल/समूह संदेश प्रॉम्प्ट में समाहित किए जाएँ। अनुपलब्ध होने पर messages.groupChat.historyLimit का उपयोग होता है, फिर डिफ़ॉल्ट 50 है। अक्षम करने के लिए 0 सेट करें।
• प्राप्त थ्रेड इतिहास को प्रेषक अनुमति-सूचियों (allowFrom / groupAllowFrom) द्वारा फ़िल्टर किया जाता है, इसलिए थ्रेड संदर्भ सीडिंग में केवल अनुमत प्रेषकों के संदेश शामिल होते हैं।
• उद्धृत अटैचमेंट संदर्भ (किसी उत्तर के अपने अटैचमेंट में Skype Reply-स्कीमा HTML से पार्स किया गया) बिना फ़िल्टर किए आगे भेजा जाता है; वर्तमान में केवल थ्रेड-इतिहास सीडिंग पर प्रेषक-अनुमति-सूची फ़िल्टर लागू होता है।
• DM इतिहास को channels.msteams.dmHistoryLimit (उपयोगकर्ता टर्न) से सीमित किया जा सकता है। प्रति-उपयोगकर्ता ओवरराइड: channels.msteams.dms["<user_id>"].historyLimit।

​

वर्तमान Teams RSC अनुमतियाँ (मैनिफ़ेस्ट)

• ChannelMessage.Read.Group (एप्लिकेशन) - @mention के बिना सभी चैनल संदेश प्राप्त करें
• ChannelMessage.Send.Group (एप्लिकेशन)
• Member.Read.Group (एप्लिकेशन)
• Owner.Read.Group (एप्लिकेशन)
• ChannelSettings.Read.Group (एप्लिकेशन)
• TeamMember.Read.Group (एप्लिकेशन)
• TeamSettings.Read.Group (एप्लिकेशन)

• ChatMessage.Read.Chat (एप्लिकेशन) - @mention के बिना सभी समूह चैट संदेश प्राप्त करें

teams app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

Teams मैनिफ़ेस्ट का उदाहरण (संशोधित)

{
  $schema: "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  manifestVersion: "1.23",
  version: "1.0.0",
  id: "00000000-0000-0000-0000-000000000000",
  name: { short: "OpenClaw" },
  developer: {
    name: "Your Org",
    websiteUrl: "https://example.com",
    privacyUrl: "https://example.com/privacy",
    termsOfUseUrl: "https://example.com/terms",
  },
  description: { short: "OpenClaw in Teams", full: "OpenClaw in Teams" },
  icons: { outline: "outline.png", color: "color.png" },
  accentColor: "#5B6DEF",
  bots: [
    {
      botId: "11111111-1111-1111-1111-111111111111",
      scopes: ["personal", "team", "groupChat"],
      isNotificationOnly: false,
      supportsCalling: false,
      supportsVideo: false,
      supportsFiles: true,
    },
  ],
  webApplicationInfo: {
    id: "11111111-1111-1111-1111-111111111111",
  },
  authorization: {
    permissions: {
      resourceSpecific: [
        { name: "ChannelMessage.Read.Group", type: "Application" },
        { name: "ChannelMessage.Send.Group", type: "Application" },
        { name: "Member.Read.Group", type: "Application" },
        { name: "Owner.Read.Group", type: "Application" },
        { name: "ChannelSettings.Read.Group", type: "Application" },
        { name: "TeamMember.Read.Group", type: "Application" },
        { name: "TeamSettings.Read.Group", type: "Application" },
        { name: "ChatMessage.Read.Chat", type: "Application" },
      ],
    },
  },
}

​

मैनिफ़ेस्ट संबंधी सावधानियाँ (अनिवार्य फ़ील्ड)

• bots[].botId Azure Bot App ID से अवश्य मेल खाना चाहिए।
• webApplicationInfo.id Azure Bot App ID से अवश्य मेल खाना चाहिए।
• bots[].scopes में वे सतहें शामिल होनी चाहिए जिनका आप उपयोग करना चाहते हैं (personal, team, groupChat)।
• व्यक्तिगत स्कोप में फ़ाइल प्रबंधन के लिए bots[].supportsFiles: true आवश्यक है।
• चैनल ट्रैफ़िक के लिए authorization.permissions.resourceSpecific में चैनल पढ़ने/भेजने की अनुमतियाँ शामिल होनी चाहिए।

​

मौजूदा ऐप अपडेट करना

# मैनिफ़ेस्ट डाउनलोड करें, संपादित करें और फिर से अपलोड करें
teams app manifest download <teamsAppId> manifest.json
# manifest.json को स्थानीय रूप से संपादित करें...
teams app manifest upload manifest.json <teamsAppId>
# सामग्री बदलने पर संस्करण अपने-आप बढ़ जाता है

​

क्षमताएँ: केवल RSC बनाम Graph

​

केवल Teams RSC के साथ (ऐप इंस्टॉल है, कोई Graph API अनुमति नहीं)

• चैनल संदेश की टेक्स्ट सामग्री पढ़ना।
• चैनल संदेश की टेक्स्ट सामग्री भेजना।
• व्यक्तिगत (DM) फ़ाइल अटैचमेंट प्राप्त करना।

• चैनल/समूह की छवि या फ़ाइल सामग्री (पेलोड में केवल एक HTML स्टब शामिल होता है)।
• SharePoint/OneDrive में संग्रहीत अटैचमेंट डाउनलोड करना।
• लाइव Webhook ईवेंट से पहले का संदेश इतिहास पढ़ना।

​

Teams RSC + Microsoft Graph एप्लिकेशन अनुमतियों के साथ

• होस्ट की गई सामग्री डाउनलोड करना (संदेशों में चिपकाई गई छवियाँ)।
• SharePoint/OneDrive में संग्रहीत फ़ाइल अटैचमेंट डाउनलोड करना।
• Graph के माध्यम से चैनल/चैट संदेश इतिहास पढ़ना।

​

RSC बनाम Graph API

​

Graph-सक्षम मीडिया + इतिहास

1. Entra ID (Azure AD) App Registration → Graph की Application permissions जोड़ें:
   • चैनल अटैचमेंट और चैनल इतिहास के लिए ChannelMessage.Read.All।
   • ग्रुप-चैट अटैचमेंट और ग्रुप-चैट इतिहास के लिए Chat.Read.All।
   • जब अटैचमेंट के बाइट्स SharePoint/OneDrive स्टोरेज से डाउनलोड किए जाने आवश्यक हों, तब Files.Read.All; केवल इतिहास वाले सेटअप को इसकी आवश्यकता नहीं होती।
2. टेनेंट के लिए Grant admin consent।
3. Teams ऐप के मैनिफ़ेस्ट संस्करण को बढ़ाएँ, दोबारा अपलोड करें और Teams में ऐप को फिर से इंस्टॉल करें।
4. कैश किया गया ऐप मेटाडेटा साफ़ करने के लिए Teams को पूरी तरह बंद करके फिर से शुरू करें।

​

चैनल/ग्रुप फ़ाइल पुनर्प्राप्ति (graphMediaFallback)

{
  channels: {
    msteams: {
      graphMediaFallback: true,
    },
  },
}

​

ज्ञात सीमाएँ

​

Webhook टाइमआउट

​

Teams क्लाउड और सेवा URL समर्थन

• channels.msteams.cloud प्रमाणीकरण, JWT सत्यापन, टोकन सेवाओं और Graph स्कोप के लिए Teams SDK क्लाउड प्रीसेट चुनता है।
• channels.msteams.serviceUrl सक्रिय रूप से संदेश भेजने, संपादित करने, हटाने, कार्ड, पोल, फ़ाइल-सहमति संदेश और कतारबद्ध लंबे समय तक चलने वाले उत्तर भेजने से पहले संग्रहीत वार्तालाप संदर्भों को सत्यापित करने के लिए उपयोग की जाने वाली Bot Connector एंडपॉइंट सीमा चुनता है। USGov और DoD SDK क्लाउड के लिए यह आवश्यक है। China/21Vianet के लिए, OpenClaw SDK के China प्रीसेट का उपयोग करता है और केवल Azure China Bot Framework चैनल होस्ट पर संग्रहीत/कॉन्फ़िगर किए गए सेवा URL स्वीकार करता है।

{
  "channels": {
    "msteams": {
      "serviceUrl": "https://smba.infra.gcc.teams.microsoft.com/teams"
    }
  }
}

{
  "channels": {
    "msteams": {
      "cloud": "USGov",
      "serviceUrl": "https://smba.infra.gov.teams.microsoft.us/teams"
    }
  }
}

​

फ़ॉर्मैटिंग

• बुनियादी फ़ॉर्मैटिंग काम करती है: बोल्ड, इटैलिक, code, लिंक।
• जटिल Markdown (तालिकाएँ, नेस्टेड सूचियाँ) सही ढंग से रेंडर नहीं हो सकता।
• पोल और अर्थपूर्ण प्रस्तुति प्रेषण के लिए Adaptive Cards समर्थित हैं (नीचे देखें)।

​

कॉन्फ़िगरेशन

• channels.msteams.enabled: चैनल को सक्षम/अक्षम करें।
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: बॉट क्रेडेंशियल।
• channels.msteams.cloud: Teams SDK क्लाउड परिवेश (Public, USGov, USGovDoD, या China; डिफ़ॉल्ट Public)। USGov/DoD SDK क्लाउड के लिए इसे serviceUrl से सेट करें; चीन SDK प्रीसेट और संग्रहीत Azure China Bot Framework वार्तालाप संदर्भों का उपयोग करता है, और Azure China Graph रूटिंग जारी होने तक Graph-समर्थित सहायक अक्षम रहते हैं।
• channels.msteams.serviceUrl: SDK की प्रोएक्टिव कार्रवाइयों के लिए Bot Connector सेवा URL सीमा। सार्वजनिक क्लाउड SDK डिफ़ॉल्ट का उपयोग करता है; GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High, या DoD के लिए इसे सेट करें। जब संग्रहीत वार्तालाप संदर्भ 21Vianet द्वारा संचालित Teams से आता है, तब चीन Azure China Bot Framework चैनल होस्ट स्वीकार करता है।
• channels.msteams.webhook.port (डिफ़ॉल्ट 3978)।
• channels.msteams.webhook.path (डिफ़ॉल्ट /api/messages)।
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (डिफ़ॉल्ट pairing)।
• channels.msteams.allowFrom: DM अनुमत-सूची (AAD ऑब्जेक्ट ID अनुशंसित हैं)। Graph एक्सेस उपलब्ध होने पर विज़ार्ड सेटअप के दौरान नामों को ID में बदलता है।
• channels.msteams.dangerouslyAllowNameMatching: परिवर्तनशील UPN/डिस्प्ले-नाम मिलान और सीधे टीम/चैनल नाम रूटिंग को फिर से सक्षम करने के लिए आपातकालीन टॉगल।
• channels.msteams.textChunkLimit: आउटबाउंड टेक्स्ट खंड का आकार, वर्णों में (डिफ़ॉल्ट 4000, और अधिक कॉन्फ़िगर किया गया मान होने पर भी अधिकतम 4000 तक सीमित)।
• channels.msteams.streaming.chunkMode: लंबाई के आधार पर खंड बनाने से पहले रिक्त पंक्तियों (अनुच्छेद सीमाओं) पर विभाजित करने के लिए length (डिफ़ॉल्ट) या newline।
• channels.msteams.mediaAllowHosts: इनबाउंड अटैचमेंट होस्ट के लिए अनुमत-सूची (डिफ़ॉल्ट रूप से Microsoft/Teams डोमेन: Graph, SharePoint/OneDrive, Teams CDN, Bot Framework, Azure Media Services)।
• channels.msteams.mediaAuthAllowHosts: मीडिया पुनः प्रयासों पर Authorization हेडर जोड़ने के लिए अनुमत-सूची (डिफ़ॉल्ट रूप से Graph + Bot Framework होस्ट)।
• channels.msteams.graphMediaFallback: जब चैनल/समूह HTML में फ़ाइल मार्कर न हों, तब Graph संदेश लुकअप का विकल्प चुनें (डिफ़ॉल्ट false; चैनल/समूह फ़ाइल पुनर्प्राप्ति देखें)।
• channels.msteams.mediaMaxMb: प्रति-चैनल मीडिया आकार सीमा का ओवरराइड, MB में। सेट न होने पर agents.defaults.mediaMaxMb का उपयोग करता है।
• channels.msteams.requireMention: चैनलों/समूहों में @mention आवश्यक करें (डिफ़ॉल्ट true)।
• channels.msteams.replyStyle: thread | top-level (उत्तर शैली देखें)।
• channels.msteams.teams.<teamId>.replyStyle: प्रति-टीम ओवरराइड।
• channels.msteams.teams.<teamId>.requireMention: प्रति-टीम ओवरराइड।
• channels.msteams.teams.<teamId>.tools: चैनल ओवरराइड अनुपस्थित होने पर उपयोग किए जाने वाले डिफ़ॉल्ट प्रति-टीम टूल नीति ओवरराइड (allow/deny/alsoAllow)।
• channels.msteams.teams.<teamId>.toolsBySender: डिफ़ॉल्ट प्रति-टीम, प्रति-प्रेषक टूल नीति ओवरराइड ("*" वाइल्डकार्ड समर्थित)।
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: प्रति-चैनल ओवरराइड।
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: प्रति-चैनल ओवरराइड।
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: प्रति-चैनल टूल नीति ओवरराइड (allow/deny/alsoAllow)।
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: प्रति-चैनल, प्रति-प्रेषक टूल नीति ओवरराइड ("*" वाइल्डकार्ड समर्थित)।
• toolsBySender कुंजियों में स्पष्ट उपसर्ग होने चाहिए: channel:, id:, e164:, username:, name: (पुरानी उपसर्ग-रहित कुंजियाँ अब भी केवल id: से मैप होती हैं)।
• channels.msteams.authType: प्रमाणीकरण प्रकार - "secret" (डिफ़ॉल्ट) या "federated"।
• channels.msteams.certificatePath: PEM प्रमाणपत्र फ़ाइल का पथ (फ़ेडरेटेड + प्रमाणपत्र प्रमाणीकरण)।
• channels.msteams.certificateThumbprint: प्रमाणपत्र थंबप्रिंट; स्वीकार्य है, प्रमाणीकरण के लिए आवश्यक नहीं।
• channels.msteams.useManagedIdentity: प्रबंधित पहचान प्रमाणीकरण सक्षम करें (फ़ेडरेटेड मोड)।
• channels.msteams.managedIdentityClientId: उपयोगकर्ता-असाइन की गई प्रबंधित पहचान के लिए क्लाइंट ID।
• channels.msteams.sharePointSiteId: समूह चैट/चैनलों में फ़ाइल अपलोड के लिए SharePoint साइट ID (समूह चैट में फ़ाइलें भेजना देखें)।
• channels.msteams.welcomeCard, channels.msteams.groupWelcomeCard, channels.msteams.promptStarters: पहले DM/समूह संपर्क पर दिखाया जाने वाला स्वागत Adaptive Card और उसके सुझाए गए प्रॉम्प्ट बटन।
• channels.msteams.responsePrefix: आउटबाउंड उत्तरों से पहले जोड़ा जाने वाला टेक्स्ट।
• channels.msteams.feedbackEnabled (डिफ़ॉल्ट true), channels.msteams.feedbackReflection (डिफ़ॉल्ट true), channels.msteams.feedbackReflectionCooldownMs: उत्तरों पर अंगूठा-ऊपर/नीचे फ़ीडबैक और नकारात्मक फ़ीडबैक पर चिंतन हेतु अनुवर्ती कार्रवाई।
• channels.msteams.sso, channels.msteams.delegatedAuth: SSO-समर्थित प्रवाहों के लिए Bot Framework OAuth कनेक्शन और प्रत्यायोजित Graph स्कोप; sso.enabled: true के लिए sso.connectionName आवश्यक है।

​

रूटिंग और सत्र

• सत्र कुंजियाँ मानक एजेंट प्रारूप का पालन करती हैं (/concepts/session देखें):
  • सीधे संदेश मुख्य सत्र साझा करते हैं (agent:<agentId>:<mainKey>)।
  • चैनल/समूह संदेश वार्तालाप ID का उपयोग करते हैं:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

उत्तर शैली: थ्रेड बनाम पोस्ट

• Threads-शैली वाले चैनल में thread → उत्तर असहज रूप से नेस्टेड दिखाई देते हैं।
• Posts-शैली वाले चैनल में top-level → उत्तर थ्रेड के भीतर दिखने के बजाय अलग शीर्ष-स्तरीय पोस्ट के रूप में दिखाई देते हैं।

{
  channels: {
    msteams: {
      replyStyle: "thread",
      teams: {
        "19:abc...@thread.tacv2": {
          channels: {
            "19:xyz...@thread.tacv2": {
              replyStyle: "top-level",
            },
          },
        },
      },
    },
  },
}

​

समाधान प्राथमिकता

1. प्रति-चैनल - channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. प्रति-टीम - channels.msteams.teams.<teamId>.replyStyle
3. वैश्विक - channels.msteams.replyStyle
4. अंतर्निहित डिफ़ॉल्ट - requireMention से प्राप्त:
   • requireMention: true → thread
   • requireMention: false → top-level

​

थ्रेड संदर्भ का संरक्षण

​

अटैचमेंट और चित्र

• DM: चित्र और फ़ाइल अटैचमेंट Teams बॉट फ़ाइल API के माध्यम से काम करते हैं।
• चैनल/समूह: अटैचमेंट M365 संग्रहण (SharePoint/OneDrive) में रहते हैं। Webhook पेलोड में केवल HTML स्टब शामिल होता है, वास्तविक फ़ाइल बाइट नहीं। चैनल अटैचमेंट डाउनलोड करने के लिए Graph API अनुमतियाँ आवश्यक हैं।
• स्पष्ट फ़ाइल-प्रथम प्रेषणों के लिए media / filePath / path के साथ action=upload-file का उपयोग करें; वैकल्पिक message साथ का टेक्स्ट/टिप्पणी बन जाता है, और filename (या title) अपलोड किए गए नाम को ओवरराइड करता है।

​

समूह चैट में फ़ाइलें भेजना

​

समूह चैट को SharePoint की आवश्यकता क्यों होती है

​

सेटअप

1. Entra ID (Azure AD) → App Registration में Graph API अनुमतियाँ जोड़ें:
   • Sites.ReadWrite.All (Application) - SharePoint पर फ़ाइलें अपलोड करें।
   • ChatMember.Read.All (Application) - समूह-चैट फ़ाइल प्रेषणों के लिए न्यूनतम-विशेषाधिकार वाली टेनेंट-व्यापी अनुमति। Chat.Read.All भी काम करती है और समूह-चैट इतिहास सक्षम होने पर इसे पहले से कवर करती है। प्रति-चैट विकल्प के रूप में, ChatMember.Read.Chat संसाधन-विशिष्ट सहमति अनुमति का उपयोग करें।
2. टेनेंट के लिए व्यवस्थापक सहमति प्रदान करें।
3. अपनी SharePoint साइट ID प्राप्त करें:
   # मान्य टोकन के साथ Graph Explorer या curl के माध्यम से:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # उदाहरण: "contoso.sharepoint.com/sites/BotFiles" पर स्थित साइट के लिए
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # प्रतिक्रिया में शामिल है: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw कॉन्फ़िगर करें:
   {
     channels: {
       msteams: {
         // ... अन्य कॉन्फ़िगरेशन ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

साझाकरण व्यवहार

​

फ़ॉलबैक व्यवहार

​

फ़ाइलें संग्रहीत होने का स्थान

​

पोल (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> --poll-question "..." --poll-option "..." --poll-option "...".
• मत Gateway द्वारा OpenClaw Plugin-स्थिति SQLite में state/openclaw.sqlite के अंतर्गत रिकॉर्ड किए जाते हैं।
• मौजूदा msteams-polls.json फ़ाइलें चल रहे Plugin द्वारा नहीं, बल्कि openclaw doctor --fix द्वारा आयात की जाती हैं।
• मत रिकॉर्ड करने के लिए Gateway का ऑनलाइन रहना आवश्यक है।
• पोल स्वचालित रूप से परिणाम सारांश पोस्ट नहीं करते और अभी कोई पोल-परिणाम CLI उपलब्ध नहीं है।

​

प्रस्तुति कार्ड

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "नमस्ते",
    blocks: [{ type: "text", text: "नमस्ते!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"नमस्ते","blocks":[{"type":"text","text":"नमस्ते!"}]}'

​

लक्ष्य प्रारूप

# ID द्वारा किसी उपयोगकर्ता को भेजें
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "नमस्ते"

# प्रदर्शन नाम द्वारा किसी उपयोगकर्ता को भेजें (Graph API लुकअप ट्रिगर करता है)
openclaw message send --channel msteams --target "user:John Smith" --message "नमस्ते"

# समूह चैट या चैनल को भेजें
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "नमस्ते"

# किसी वार्तालाप को प्रस्तुति कार्ड भेजें
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"नमस्ते","blocks":[{"type":"text","text":"नमस्ते"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "नमस्ते!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "नमस्ते",
    blocks: [{ type: "text", text: "नमस्ते" }],
  },
}

​

सक्रिय संदेश सेवा

• सक्रिय संदेश केवल तब संभव हैं जब कोई उपयोगकर्ता इंटरैक्ट कर चुका हो, क्योंकि OpenClaw उसी समय वार्तालाप संदर्भ संग्रहीत करता है।
• dmPolicy और अनुमति-सूची गेटिंग के लिए /gateway/configuration देखें।

​

टीम और चैनल ID (सामान्य समस्या)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    टीम वार्तालाप ID (इसे URL-डिकोड करें)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      चैनल ID (इसे URL-डिकोड करें)

• टीम कुंजी = /team/ के बाद का पथ खंड (URL-डिकोड किया हुआ, जैसे 19:Bk4j...@thread.tacv2; पुराने टेनेंट में @thread.skype दिख सकता है, जो भी मान्य है)।
• चैनल कुंजी = /channel/ के बाद का पथ खंड (URL-डिकोड किया हुआ)।
• OpenClaw रूटिंग के लिए groupId क्वेरी पैरामीटर को अनदेखा करें। यह Microsoft Entra समूह ID है, आने वाली Teams गतिविधियों में उपयोग किया जाने वाला Bot Framework वार्तालाप ID नहीं।

​

निजी चैनल

1. बॉट इंटरैक्शन के लिए मानक चैनलों का उपयोग करें।
2. DM का उपयोग करें; उपयोगकर्ता हमेशा बॉट को सीधे संदेश भेज सकते हैं।
3. ऐतिहासिक एक्सेस के लिए Graph API का उपयोग करें (ChannelMessage.Read.All आवश्यक है)।

​

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

​

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

• चैनलों में छवियाँ दिखाई नहीं दे रही हैं: Graph अनुमतियाँ या एडमिन सहमति अनुपलब्ध है। Teams ऐप को फिर से इंस्टॉल करें और Teams को पूरी तरह बंद करके दोबारा खोलें।
• चैनल में कोई प्रतिक्रिया नहीं: डिफ़ॉल्ट रूप से उल्लेख आवश्यक हैं; channels.msteams.requireMention=false सेट करें या प्रति टीम/चैनल कॉन्फ़िगर करें।
• संस्करण बेमेल (Teams अभी भी पुराना मैनिफ़ेस्ट दिखाता है): ऐप हटाकर फिर से जोड़ें और रीफ़्रेश करने के लिए Teams को पूरी तरह बंद करें।
• Webhook से 401 Unauthorized: Azure JWT के बिना मैन्युअल परीक्षण करते समय यह अपेक्षित है; इसका अर्थ है कि एंडपॉइंट पहुँच योग्य है, लेकिन प्रमाणीकरण विफल हुआ। उचित परीक्षण के लिए Azure Web Chat का उपयोग करें।

​

मैनिफ़ेस्ट अपलोड त्रुटियाँ

• “Icon file cannot be empty”: मैनिफ़ेस्ट ऐसी आइकन फ़ाइलों का संदर्भ देता है जिनका आकार 0 बाइट है। मान्य PNG आइकन बनाएँ (outline.png के लिए 32x32, color.png के लिए 192x192)।
• “webApplicationInfo.Id already in use”: ऐप अभी भी किसी दूसरी टीम/चैट में इंस्टॉल है। पहले उसे ढूँढकर अनइंस्टॉल करें या प्रसार के लिए 5-10 मिनट प्रतीक्षा करें।
• अपलोड करते समय “Something went wrong”: इसके बजाय https://admin.teams.microsoft.com के माध्यम से अपलोड करें, ब्राउज़र DevTools (F12) → Network tab खोलें और वास्तविक त्रुटि के लिए प्रतिक्रिया बॉडी जाँचें।
• साइडलोड विफल हो रहा है: “Upload a custom app” के बजाय “Upload an app to your org’s app catalog” आज़माएँ; यह अक्सर साइडलोड प्रतिबंधों को बायपास कर देता है।

​

RSC अनुमतियाँ काम नहीं कर रही हैं

1. सत्यापित करें कि webApplicationInfo.id आपके बॉट के App ID से बिल्कुल मेल खाता है।
2. ऐप को दोबारा अपलोड करें और टीम/चैट में पुनः इंस्टॉल करें।
3. जाँचें कि क्या आपके संगठन के एडमिन ने RSC अनुमतियाँ अवरुद्ध की हैं।
4. पुष्टि करें कि आप सही स्कोप का उपयोग कर रहे हैं: टीमों के लिए ChannelMessage.Read.Group, समूह चैट के लिए ChatMessage.Read.Chat।

​

संदर्भ

• Azure Bot बनाएँ - Azure Bot सेटअप गाइड
• Teams Developer Portal - Teams ऐप बनाएँ/प्रबंधित करें
• Teams ऐप मैनिफ़ेस्ट स्कीमा
• RSC के साथ चैनल संदेश प्राप्त करें
• RSC अनुमतियों का संदर्भ
• Teams बॉट फ़ाइल प्रबंधन (चैनल/समूह के लिए Graph आवश्यक है)
• सक्रिय संदेश सेवा
• @microsoft/teams.cli - बॉट प्रबंधन के लिए Teams CLI

​

संबंधित

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