Microsoft Teams

स्थिति: टेक्स्ट + DM अटैचमेंट समर्थित हैं; चैनल/समूह में फ़ाइल भेजने के लिए sharePointSiteId + Graph अनुमतियाँ आवश्यक हैं (समूह चैट में फ़ाइलें भेजना देखें)। पोल Adaptive Cards के माध्यम से भेजे जाते हैं। संदेश क्रियाएँ फ़ाइल-प्रथम प्रेषण के लिए स्पष्ट upload-file उपलब्ध कराती हैं।

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

वर्तमान OpenClaw रिलीज़ में Microsoft Teams एक बंडल किए गए Plugin के रूप में शामिल है; सामान्य पैकेज्ड बिल्ड में अलग से इंस्टॉल करने की आवश्यकता नहीं है।

पुराने बिल्ड या ऐसे कस्टम इंस्टॉलेशन पर, जिसमें बंडल किया गया Teams शामिल नहीं है, npm पैकेज सीधे इंस्टॉल करें:

openclaw plugins install @openclaw/msteams

वर्तमान आधिकारिक रिलीज़ टैग का अनुसरण करने के लिए बिना संस्करण वाला पैकेज उपयोग करें। सटीक संस्करण केवल तभी पिन करें, जब पुनरुत्पाद्य इंस्टॉलेशन आवश्यक हो।

स्थानीय चेकआउट (git रिपॉज़िटरी से चलाते समय):

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

विवरण: Plugins

त्वरित सेटअप

@microsoft/teams.cli एक ही कमांड में बॉट पंजीकरण, मैनिफ़ेस्ट निर्माण और क्रेडेंशियल जनरेशन संभालता है।

1. इंस्टॉल और लॉग इन करें

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

2. एक टनल शुरू करें (Teams localhost तक नहीं पहुँच सकता)

यदि आवश्यक हो, तो devtunnel CLI इंस्टॉल करें और प्रमाणित करें (आरंभ करने की मार्गदर्शिका)।

# एक बार का सेटअप (सत्रों के बीच स्थायी URL):devtunnel create my-openclaw-bot --allow-anonymousdevtunnel port create my-openclaw-bot -p 3978 --protocol auto # प्रत्येक डेवलपमेंट सत्र:devtunnel host my-openclaw-bot# आपका एंडपॉइंट: https://<tunnel-id>.devtunnels.ms/api/messages

विकल्प: ngrok http 3978 या tailscale funnel 3978 (हर सत्र में URL बदल सकते हैं)।

3. ऐप बनाएँ

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

यह एक Entra ID (Azure AD) एप्लिकेशन बनाता है, क्लाइंट सीक्रेट जनरेट करता है, Teams ऐप मैनिफ़ेस्ट (आइकन सहित) बनाकर अपलोड करता है और Teams द्वारा प्रबंधित बॉट पंजीकृत करता है (Azure सदस्यता आवश्यक नहीं)। आउटपुट में CLIENT_ID, CLIENT_SECRET, TENANT_ID और एक Teams App ID शामिल होते हैं; यह ऐप को सीधे Teams में इंस्टॉल करने का विकल्प भी देता है।

4. OpenClaw कॉन्फ़िगर करें आउटपुट से मिले क्रेडेंशियल का उपयोग करके:

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

या सीधे एनवायरनमेंट वेरिएबल उपयोग करें: MSTEAMS_APP_ID, MSTEAMS_APP_PASSWORD, MSTEAMS_TENANT_ID।

5. ऐप को Teams में इंस्टॉल करें

teams app create आपको ऐप इंस्टॉल करने के लिए संकेत देता है; "Install in Teams" चुनें। बाद में इंस्टॉल लिंक प्राप्त करने के लिए:

teams app get <teamsAppId> --install-link

6. पुष्टि करें कि सब कुछ काम करता है

teams app doctor <teamsAppId>

बॉट पंजीकरण, AAD ऐप कॉन्फ़िगरेशन, मैनिफ़ेस्ट वैधता और SSO सेटअप में डायग्नोस्टिक्स चलाता है।

प्रोडक्शन के लिए क्लाइंट सीक्रेट के बजाय फ़ेडरेटेड प्रमाणीकरण (सर्टिफ़िकेट या मैनेज्ड आइडेंटिटी) पर विचार करें।

लक्ष्य

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

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

डिफ़ॉल्ट रूप से, Microsoft Teams /config set|unset द्वारा ट्रिगर किए गए कॉन्फ़िगरेशन अपडेट लिख सकता है (commands.config: true आवश्यक है)।

इससे अक्षम करें:

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

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

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 },          },        },      },    },  },}

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

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

प्रोडक्शन के लिए OpenClaw, channels.msteams.authType: "federated" के माध्यम से क्लाइंट सीक्रेट के विकल्प के रूप में फ़ेडरेटेड प्रमाणीकरण का समर्थन करता है। दो विधियाँ हैं:

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

अपने Entra ID ऐप पंजीकरण में पंजीकृत PEM सर्टिफ़िकेट उपयोग करें।

सेटअप:

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

Azure इन्फ़्रास्ट्रक्चर (AKS, App Service, Azure VMs) पर पासवर्ड-रहित प्रमाणीकरण के लिए 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" },    },  },}

कॉन्फ़िगरेशन (उपयोगकर्ता-असाइन की गई प्रबंधित पहचान): ऊपर दिए गए ब्लॉक में managedIdentityClientId: "<MI_CLIENT_ID>" जोड़ें।

पर्यावरण चर:

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

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

वर्कलोड पहचान का उपयोग करने वाले 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: v1kind: ServiceAccountmetadata:  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 के लिए एक इग्रेस नियम जोड़ें।

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

certificateThumbprint को certificatePath के साथ सेट किया जा सकता है, लेकिन आज प्रमाणीकरण पथ इसे नहीं पढ़ता; इसे केवल भावी संगतता के लिए स्वीकार किया जाता है।

डिफ़ॉल्ट: जब authType सेट नहीं होता, तो OpenClaw क्लाइंट-सीक्रेट प्रमाणीकरण (appPassword) का उपयोग करता है। मौजूदा कॉन्फ़िगरेशन बिना किसी बदलाव के काम करते रहते हैं।

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

Teams localhost तक नहीं पहुँच सकता। एक स्थायी डेवलपमेंट टनल का उपयोग करें, ताकि URL सभी सत्रों में स्थिर रहे:

# एक बार का सेटअप:devtunnel create my-openclaw-bot --allow-anonymousdevtunnel port create my-openclaw-bot -p 3978 --protocol auto # प्रत्येक डेवलपमेंट सत्र:devtunnel host my-openclaw-bot

विकल्प: ngrok http 3978 या tailscale funnel 3978 (URL प्रत्येक सत्र में बदल सकते हैं)।

यदि टनल URL बदलता है, तो एंडपॉइंट अपडेट करें:

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

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

डायग्नोस्टिक्स चलाएँ:

teams app doctor <teamsAppId>

एक ही चरण में बॉट पंजीकरण, AAD ऐप, मैनिफ़ेस्ट और SSO कॉन्फ़िगरेशन की जाँच करता है।

एक परीक्षण संदेश भेजें:

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

पर्यावरण चर

इन प्रमाणीकरण-संबंधी कॉन्फ़िगरेशन कुंजियों को openclaw.json के बजाय पर्यावरण चरों के माध्यम से सेट किया जा सकता है (अन्य कॉन्फ़िगरेशन कुंजियाँ, जैसे groupPolicy या historyLimit, केवल कॉन्फ़िगरेशन में उपलब्ध हैं):

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

OpenClaw Microsoft Teams के लिए Graph-समर्थित member-info कार्रवाई उपलब्ध कराता है, ताकि एजेंट और ऑटोमेशन किसी कॉन्फ़िगर की गई बातचीत के सत्यापित रोस्टर विवरण प्राप्त कर सकें।

आवश्यकताएँ:

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

जब भी Graph क्रेडेंशियल कॉन्फ़िगर होते हैं, यह कार्रवाई उपलब्ध होती है; इसके लिए कोई अलग channels.msteams.actions.memberInfo टॉगल नहीं है। मानक-चैनल लुकअप मेल खाने वाली टीम-रोस्टर पहचान, प्रदर्शन नाम, ईमेल और भूमिकाएँ लौटाते हैं। वर्तमान DM या समूह चैट में, यह कार्रवाई विश्वसनीय प्रेषक की स्थायी उपयोगकर्ता ID लौटा सकती है। निजी/साझा चैनल और गैर-वर्तमान चैट सदस्य लुकअप के लिए अतिरिक्त रोस्टर अनुमतियाँ आवश्यक हैं और डिफ़ॉल्ट अनुमति आधाररेखा द्वारा अस्वीकार किए जाते हैं।

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

• 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 अनुमतियाँ (मैनिफ़ेस्ट)

ये हमारे Teams ऐप मैनिफ़ेस्ट में मौजूदा resourceSpecific अनुमतियाँ हैं। ये केवल उस टीम/चैट के भीतर लागू होती हैं जहाँ ऐप इंस्टॉल किया गया है।

चैनलों के लिए (टीम स्कोप):

• 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 CLI के माध्यम से RSC अनुमतियाँ जोड़ें:

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

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

आवश्यक फ़ील्ड वाला न्यूनतम, मान्य उदाहरण। ID और URL बदलें।

{  $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># सामग्री बदलने पर संस्करण अपने-आप बढ़ जाता है

अपडेट करने के बाद, प्रत्येक टीम में ऐप को फिर से इंस्टॉल करें और कैश किए गए ऐप मेटाडेटा को साफ़ करने के लिए Teams को पूरी तरह बंद करके फिर से शुरू करें (केवल विंडो बंद न करें)।

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

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

काम करता है:

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

काम नहीं करता:

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

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

ये क्षमताएँ जुड़ती हैं:

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

RSC बनाम Graph API

निष्कर्ष: RSC रीयल-टाइम में सुनने के लिए है; Graph API ऐतिहासिक पहुँच के लिए है। ऑफ़लाइन रहते हुए छूटे हुए संदेश प्राप्त करने के लिए, आपको ChannelMessage.Read.All के साथ Graph API चाहिए (एडमिन की सहमति आवश्यक है)।

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

आपके द्वारा उपयोग किए जाने वाले Teams स्कोप और डेटा के लिए आवश्यक केवल Microsoft 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)

Teams किसी बॉट को भेजी गई HTML गतिविधि से फ़ाइल चिह्न हटा सकता है। उस स्थिति में, Bot Framework गतिविधि को किसी सामान्य HTML संदेश से अलग नहीं किया जा सकता; अटैचमेंट का पूरा संदर्भ केवल संदेश की Graph कॉपी में मौजूद होता है।

ऊपर दी गई अनुमतियाँ देने के बाद फ़ॉलबैक सक्षम करें:

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

यह केवल चैनलों और ग्रुप चैट पर लागू होता है। जब भी किसी HTML गतिविधि से सीधे डाउनलोड किया जा सकने वाला कोई मीडिया नहीं मिलता, तब यह एक Graph संदेश लुकअप जोड़ता है, जिसमें सामान्य या केवल मेंशन वाले संदेश भी शामिल हैं। डिफ़ॉल्ट false है, ताकि मौजूदा इंस्टॉलेशन में अतिरिक्त Graph ट्रैफ़िक या अनुमति त्रुटियाँ अपने-आप न जुड़ें।

उपयोगकर्ता मेंशन: बातचीत में पहले से मौजूद उपयोगकर्ताओं के लिए @मेंशन बिना किसी अतिरिक्त सेटअप के काम करते हैं। वर्तमान बातचीत में शामिल नहीं उपयोगकर्ताओं को डायनेमिक रूप से खोजने और मेंशन करने के लिए, User.Read.All (Application) अनुमति जोड़ें और एडमिन की सहमति दें।

ज्ञात सीमाएँ

Webhook टाइमआउट

Teams HTTP Webhook के माध्यम से संदेश भेजता है। OpenClaw उस Webhook लिसनर पर निश्चित HTTP सर्वर टाइमआउट लागू करता है: निष्क्रियता के लिए 30s, कुल अनुरोध के लिए 30s और हेडर प्राप्त करने के लिए 15s। वैकल्पिक इनबाउंड मीडिया और संदर्भ संवर्धन का साझा बजट 10 सेकंड है। रॉ गतिविधि को स्थायी रूप से जोड़ दिए जाने के बाद SDK वापस लौटता है; एजेंट टर्न स्वतंत्र रूप से समाप्त होता है और सक्रिय रूप से उत्तर भेजता है। यदि अनुरोध संसाधन या स्थायी स्वीकृति ट्रांसपोर्ट समय-सीमा से चूक जाती है, तो Teams उस गतिविधि को दोबारा भेज सकता है और इनग्रेस टूम्बस्टोन दोहराई गई इवेंट ID को अस्वीकार कर देता है।

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

यह SDK-समर्थित Teams पथ Microsoft Teams पब्लिक क्लाउड के लिए लाइव-सत्यापित है।

इनबाउंड उत्तर आने वाले Teams SDK टर्न संदर्भ का उपयोग करते हैं। संदर्भ से बाहर की सक्रिय कार्रवाइयाँ—भेजना, संपादित करना, हटाना, कार्ड, पोल, फ़ाइल-सहमति संदेश और कतारबद्ध लंबे समय तक चलने वाले उत्तर—संग्रहीत वार्तालाप संदर्भ serviceUrl का उपयोग करती हैं। पब्लिक क्लाउड डिफ़ॉल्ट रूप से Teams SDK पब्लिक क्लाउड परिवेश का उपयोग करता है और पब्लिक Teams Connector होस्ट पर संग्रहीत संदर्भों की अनुमति देता है: https://smba.trafficmanager.net/।

पब्लिक क्लाउड डिफ़ॉल्ट है। सामान्य पब्लिक-क्लाउड बॉट के लिए आपको channels.msteams.cloud या channels.msteams.serviceUrl सेट करने की आवश्यकता नहीं है।

गैर-पब्लिक Teams क्लाउड के लिए, जब Microsoft संबंधित सक्रिय सीमा प्रकाशित करे, तब cloud और उसे सेट करें:

• 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 स्वीकार करता है।

Microsoft, Teams की सक्रिय संदेश सेवा के दस्तावेज़ों के वार्तालाप बनाएँ अनुभाग में वैश्विक सक्रिय Bot Connector एंडपॉइंट प्रकाशित करता है। उपलब्ध होने पर आने वाली गतिविधि के serviceUrl का उपयोग करें; अन्यथा नीचे दी गई Microsoft की तालिका का उपयोग करें।

GCC का उदाहरण, जहाँ Microsoft एक अलग सक्रिय सेवा URL का दस्तावेज़ीकरण करता है, लेकिन Teams SDK कोई अलग GCC क्लाउड प्रीसेट उपलब्ध नहीं कराता:

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

GCC High का उदाहरण:

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

channels.msteams.serviceUrl समर्थित Microsoft Teams Bot Connector होस्ट तक सीमित है। जब कोई सेवा URL कॉन्फ़िगर किया जाता है, तो OpenClaw सक्रिय रूप से संदेश भेजने, संपादित करने, हटाने, कार्ड, पोल या कतारबद्ध लंबे समय तक चलने वाले उत्तर चलाने से पहले जाँचता है कि संग्रहीत वार्तालाप serviceUrl उसी होस्ट का उपयोग करता है। डिफ़ॉल्ट पब्लिक-क्लाउड कॉन्फ़िगरेशन के साथ, यदि कोई संग्रहीत वार्तालाप पब्लिक Teams Connector होस्ट से बाहर इंगित करता है, तो OpenClaw सुरक्षित रूप से विफल हो जाता है। cloud/service URL सेटिंग बदलने के बाद वार्तालाप से एक नया संदेश प्राप्त करें, ताकि संग्रहीत वार्तालाप संदर्भ वर्तमान रहे।

Microsoft की Teams सक्रिय एंडपॉइंट तालिका में China/21Vianet के लिए कोई अलग वैश्विक सक्रिय smba URL नहीं है। cloud: "China" कॉन्फ़िगर करें, ताकि Teams SDK Azure China प्रमाणीकरण, टोकन और JWT एंडपॉइंट का उपयोग करे। इसके बाद सक्रिय रूप से संदेश भेजने के लिए आने वाली China Teams गतिविधि से प्राप्त संग्रहीत वार्तालाप संदर्भ या Azure China Bot Framework चैनल सीमा (*.botframework.azure.cn) पर स्पष्ट रूप से कॉन्फ़िगर किया गया सेवा URL आवश्यक होता है। जब तक OpenClaw Graph अनुरोधों को Azure China Graph एंडपॉइंट के माध्यम से रूट नहीं करता, तब तक cloud: "China" के लिए Graph-समर्थित Teams सहायक अक्षम रहते हैं।

फ़ॉर्मैटिंग

Teams Markdown, Slack या Discord की तुलना में अधिक सीमित है:

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

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

मुख्य सेटिंग्स (साझा चैनल पैटर्न के लिए /gateway/configuration देखें):

• 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>

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

Teams में एक ही अंतर्निहित डेटा मॉडल पर दो चैनल UI शैलियाँ हैं:

समस्या: Teams API यह नहीं बताता कि कोई चैनल किस UI शैली का उपयोग करता है। यदि आप गलत replyStyle का उपयोग करते हैं:

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

समाधान: चैनल के सेटअप के आधार पर प्रति-चैनल replyStyle कॉन्फ़िगर करें:

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

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

जब बॉट किसी चैनल में उत्तर भेजता है, तो replyStyle का समाधान सबसे विशिष्ट ओवरराइड से डिफ़ॉल्ट की ओर किया जाता है। पहला गैर-undefined मान प्रभावी होता है:

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

यदि आप स्पष्ट replyStyle के बिना वैश्विक रूप से requireMention: false सेट करते हैं, तो Posts-शैली वाले चैनलों में उल्लेख शीर्ष-स्तरीय पोस्ट के रूप में दिखाई देते हैं, भले ही इनबाउंड संदेश किसी थ्रेड का उत्तर हो। अप्रत्याशित परिणामों से बचने के लिए वैश्विक, टीम, या चैनल स्तर पर replyStyle: "thread" निर्धारित करें।

संग्रहीत चैनल वार्तालाप में प्रोएक्टिव भेजने के लिए (कतारबद्ध टूल-कॉल उत्तर, लंबे समय तक चलने वाले एजेंट), वही टीम/चैनल समाधान लागू होता है; समूह चैट और व्यक्तिगत (DM) वार्तालापों में प्रोएक्टिव भेजने के लिए replyStyle की परवाह किए बिना हमेशा top-level का समाधान होता है।

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

जब replyStyle: "thread" प्रभावी हो और बॉट को किसी चैनल थ्रेड के भीतर से @mention किया गया हो, तो OpenClaw मूल थ्रेड रूट को आउटबाउंड वार्तालाप संदर्भ (19:...@thread.tacv2;messageid=<root>) से फिर जोड़ता है, ताकि उत्तर उसी थ्रेड में पहुँचे। यह लाइव (उसी टर्न में) भेजे गए संदेशों और Bot Framework टर्न संदर्भ की समय-सीमा समाप्त होने के बाद किए गए प्रोएक्टिव प्रेषणों (जैसे लंबे समय तक चलने वाले एजेंट, mcp__openclaw__message के माध्यम से कतारबद्ध टूल-कॉल उत्तर) दोनों पर लागू होता है।

थ्रेड रूट वार्तालाप संदर्भ पर संग्रहीत threadId से लिया जाता है। threadId से पहले के पुराने संग्रहीत संदर्भ activityId (जिस इनबाउंड गतिविधि ने अंतिम बार वार्तालाप को आरंभ किया था) का उपयोग करते हैं, इसलिए मौजूदा परिनियोजन दोबारा सीड किए बिना काम करते रहते हैं।

जब replyStyle: "top-level" प्रभावी हो, तो चैनल-थ्रेड इनबाउंड संदेशों का उत्तर जानबूझकर नए शीर्ष-स्तरीय पोस्ट के रूप में दिया जाता है; कोई थ्रेड प्रत्यय नहीं जोड़ा जाता। यह Threads-शैली वाले चैनलों के लिए सही है; यदि आप थ्रेडेड उत्तरों की अपेक्षा करते हैं लेकिन शीर्ष-स्तरीय पोस्ट दिखाई देते हैं, तो उस चैनल के लिए replyStyle गलत सेट है।

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

वर्तमान सीमाएँ:

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

Graph अनुमतियों के बिना, चित्रों वाले चैनल संदेश केवल टेक्स्ट के रूप में आते हैं (चित्र सामग्री बॉट के लिए सुलभ नहीं होती)। डिफ़ॉल्ट रूप से, OpenClaw केवल Microsoft/Teams होस्टनाम से मीडिया डाउनलोड करता है। channels.msteams.mediaAllowHosts से इसे ओवरराइड करें (किसी भी होस्ट को अनुमति देने के लिए ["*"] का उपयोग करें)। Authorization हेडर केवल channels.msteams.mediaAuthAllowHosts में मौजूद होस्ट के लिए जोड़े जाते हैं (डिफ़ॉल्ट रूप से Graph + Bot Framework होस्ट)। इस सूची को सख्त रखें (मल्टी-टेनेंट प्रत्ययों से बचें)।

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

बॉट अंतर्निहित FileConsentCard प्रवाह का उपयोग करके DM में फ़ाइलें भेज सकते हैं। समूह चैट/चैनलों में फ़ाइलें भेजने के लिए अतिरिक्त सेटअप आवश्यक है:

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

बॉट एक एप्लिकेशन पहचान का उपयोग करते हैं, जबकि Microsoft Graph के /me संसाधन के लिए साइन-इन किया हुआ उपयोगकर्ता आवश्यक है। समूह चैट/चैनलों में फ़ाइलें भेजने के लिए, बॉट एक 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",    },  },}

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

प्रति-उपयोगकर्ता साझाकरण अधिक सुरक्षित है, क्योंकि केवल चैट प्रतिभागी फ़ाइल को एक्सेस कर सकते हैं। OpenClaw को समूह चैट के लिए सफल सदस्य लुकअप की आवश्यकता होती है; टाइमआउट, ट्रांसपोर्ट विफलताएँ, खाली परिणाम और Graph API द्वारा अस्वीकृतियाँ संगठन तक एक्सेस बढ़ाने के बजाय भेजने की प्रक्रिया को विफल कर देती हैं।

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

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

अपलोड की गई फ़ाइलें कॉन्फ़िगर की गई SharePoint साइट की डिफ़ॉल्ट दस्तावेज़ लाइब्रेरी में एक /OpenClawShared/ फ़ोल्डर में संग्रहीत होती हैं।

पोल (Adaptive Cards)

OpenClaw Teams पोल को Adaptive Cards के रूप में भेजता है (कोई नेटिव Teams पोल API नहीं है)।

• 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 उपलब्ध नहीं है।

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

message टूल, CLI या सामान्य उत्तर डिलीवरी का उपयोग करके Teams उपयोगकर्ताओं या वार्तालापों को अर्थ-संबंधी प्रस्तुति पेलोड भेजें। OpenClaw उन्हें सामान्य प्रस्तुति अनुबंध से Teams Adaptive Cards के रूप में रेंडर करता है।

presentation पैरामीटर अर्थ-संबंधी ब्लॉक स्वीकार करता है। जब presentation दिया जाता है, तो संदेश टेक्स्ट वैकल्पिक होता है। बटन Adaptive Card सबमिट या URL कार्रवाइयों के रूप में रेंडर होते हैं। Teams रेंडरर में चयन मेनू नेटिव नहीं हैं, इसलिए OpenClaw डिलीवरी से पहले उन्हें पठनीय टेक्स्ट में बदल देता है।

एजेंट टूल:

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

CLI:

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

लक्ष्य प्रारूप के विवरण के लिए नीचे लक्ष्य प्रारूप देखें।

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

MSTeams लक्ष्य उपयोगकर्ताओं और वार्तालापों के बीच अंतर करने के लिए उपसर्गों का उपयोग करते हैं:

CLI उदाहरण:

# 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 (सामान्य समस्या)

Teams URL में groupId क्वेरी पैरामीटर कॉन्फ़िगरेशन के लिए उपयोग किया जाने वाला टीम ID नहीं है। इसके बजाय URL पथ से ID निकालें:

टीम URL:

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

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