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   # verify you're logged in and see your tenant info

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

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

• एक Entra ID (Azure AD) application बनाता है
• client secret जनरेट करता है
• Teams app manifest बनाता और अपलोड करता है (icons के साथ)
• bot रजिस्टर करता है (डिफ़ॉल्ट रूप से Teams-managed - Azure subscription की आवश्यकता नहीं)

{
  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 DMs, group chats, या channels के ज़रिए OpenClaw से बात करें.
• routing deterministic रखें: replies हमेशा उसी channel में वापस जाते हैं जहाँ वे आए थे.
• सुरक्षित channel व्यवहार को default रखें (जब तक अन्यथा configure न किया गया हो, mentions आवश्यक).

​

Config writes

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

​

Access control (DMs + groups)

• Default: channels.msteams.dmPolicy = "pairing". Unknown senders approved होने तक ignore किए जाते हैं.
• channels.msteams.allowFrom को स्थिर AAD object IDs या static sender access groups जैसे accessGroup:core-team का उपयोग करना चाहिए.
• allowlists के लिए UPN/display-name matching पर निर्भर न रहें - वे बदल सकते हैं. OpenClaw डिफ़ॉल्ट रूप से direct name matching disable करता है; channels.msteams.dangerouslyAllowNameMatching: true के साथ स्पष्ट रूप से opt in करें.
• credentials अनुमति दें तो wizard Microsoft Graph के ज़रिए names को IDs में resolve कर सकता है.

• Default: channels.msteams.groupPolicy = "allowlist" (जब तक आप groupAllowFrom न जोड़ें, blocked). unset होने पर default override करने के लिए channels.defaults.groupPolicy उपयोग करें.
• channels.msteams.groupAllowFrom नियंत्रित करता है कि group chats/channels में कौन से senders या static sender access groups trigger कर सकते हैं (channels.msteams.allowFrom पर fall back करता है).
• किसी भी member को अनुमति देने के लिए groupPolicy: "open" सेट करें (फिर भी डिफ़ॉल्ट रूप से mention-gated).
• कोई channel नहीं अनुमति देने के लिए, channels.msteams.groupPolicy: "disabled" सेट करें.

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

• channels.msteams.teams के अंतर्गत teams और channels सूचीबद्ध करके group/channel replies को scope करें.
• Keys को Teams links से स्थिर Teams conversation IDs का उपयोग करना चाहिए, mutable display names का नहीं.
• जब groupPolicy="allowlist" हो और teams allowlist मौजूद हो, केवल सूचीबद्ध teams/channels स्वीकार किए जाते हैं (mention-gated).
• configure wizard Team/Channel entries स्वीकार करता है और उन्हें आपके लिए store करता है.
• startup पर, OpenClaw team/channel और user allowlist names को IDs में resolve करता है (जब Graph permissions अनुमति दें) और mapping log करता है; unresolved team/channel names typed रूप में रखे जाते हैं लेकिन routing के लिए डिफ़ॉल्ट रूप से ignore किए जाते हैं, जब तक channels.msteams.dangerouslyAllowNameMatching: true enabled न हो.

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

​

Federated authentication (certificate plus managed identity)

2026.4.11 में जोड़ा गया

​

विकल्प A: Certificate-based authentication

1. certificate generate करें या प्राप्त करें (private key के साथ PEM format).
2. Entra ID → App Registration → Certificates & secrets → Certificates → public certificate upload करें.

{
  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. bot pod/VM के पास managed identity होती है (system-assigned या user-assigned).
2. एक federated identity credential managed identity को Entra ID app registration से link करता है.
3. runtime पर, OpenClaw Azure IMDS endpoint (169.254.169.254) से tokens प्राप्त करने के लिए @azure/identity उपयोग करता है.
4. token bot authentication के लिए Teams SDK को pass किया जाता है.

• managed identity enabled वाला Azure infrastructure (AKS workload identity, App Service, VM)
• Entra ID app registration पर बनाया गया federated identity credential
• pod/VM से IMDS (169.254.169.254:80) तक network access

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

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      managedIdentityClientId: "<MI_CLIENT_ID>",
      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 तक ट्रैफ़िक की अनुमति देने वाला egress नियम जोड़ें।

​

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

​

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

# One-time setup:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot

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

​

Bot का परीक्षण

teams app doctor <teamsAppId>

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

​

पर्यावरण चर

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (वैकल्पिक: "secret" या "federated")
• MSTEAMS_CERTIFICATE_PATH (federated + certificate)
• MSTEAMS_CERTIFICATE_THUMBPRINT (वैकल्पिक, auth के लिए आवश्यक नहीं)
• MSTEAMS_USE_MANAGED_IDENTITY (federated + managed identity)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (केवल उपयोगकर्ता-असाइन MI)

​

सदस्य जानकारी action

• Member.Read.Group RSC permission (अनुशंसित manifest में पहले से मौजूद)
• क्रॉस-team lookup के लिए: admin consent के साथ User.Read.All Graph Application permission

​

इतिहास context

• channels.msteams.historyLimit नियंत्रित करता है कि कितने हालिया channel/group संदेश prompt में wrap किए जाते हैं।
• messages.groupChat.historyLimit पर fallback करता है। बंद करने के लिए 0 सेट करें (डिफ़ॉल्ट 50)।
• fetch किया गया thread इतिहास sender allowlists (allowFrom / groupAllowFrom) द्वारा filter किया जाता है, इसलिए thread context seeding में केवल allowed senders के संदेश शामिल होते हैं।
• quoted attachment context (ReplyTo*, Teams reply HTML से derived) वर्तमान में जैसा प्राप्त होता है वैसा ही पास किया जाता है।
• दूसरे शब्दों में, allowlists यह gate करती हैं कि agent को कौन trigger कर सकता है; आज केवल विशिष्ट supplemental context paths filter किए जाते हैं।
• DM इतिहास को channels.msteams.dmHistoryLimit (user turns) से सीमित किया जा सकता है। प्रति-user overrides: channels.msteams.dms["<user_id>"].historyLimit।

​

वर्तमान Teams RSC permissions (manifest)

• ChannelMessage.Read.Group (Application) - @mention के बिना सभी channel messages प्राप्त करें
• ChannelMessage.Send.Group (Application)
• Member.Read.Group (Application)
• Owner.Read.Group (Application)
• ChannelSettings.Read.Group (Application)
• TeamMember.Read.Group (Application)
• TeamSettings.Read.Group (Application)

• ChatMessage.Read.Chat (Application) - @mention के बिना सभी group chat messages प्राप्त करें

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

​

उदाहरण Teams manifest (redacted)

{
  $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" },
      ],
    },
  },
}

​

Manifest caveats (आवश्यक fields)

• bots[].botId Azure Bot App ID से मेल खाना अनिवार्य है।
• webApplicationInfo.id Azure Bot App ID से मेल खाना अनिवार्य है।
• bots[].scopes में वे surfaces शामिल होने चाहिए जिन्हें आप उपयोग करने की योजना बना रहे हैं (personal, team, groupChat)।
• personal scope में file handling के लिए bots[].supportsFiles: true आवश्यक है।
• यदि आप channel traffic चाहते हैं, तो authorization.permissions.resourceSpecific में channel read/send शामिल होना चाहिए।

​

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

# Download, edit, and re-upload the manifest
teams app manifest download <teamsAppId> manifest.json
# Edit manifest.json locally...
teams app manifest upload manifest.json <teamsAppId>
# Version is auto-bumped if content changed

​

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

​

केवल Teams RSC के साथ (ऐप इंस्टॉल, कोई Graph API permissions नहीं)

• channel message text content पढ़ना।
• channel message text content भेजना।
• personal (DM) file attachments प्राप्त करना।

• Channel/group image या file contents (payload में केवल HTML stub शामिल होता है)।
• SharePoint/OneDrive में stored attachments download करना।
• message history पढ़ना (live webhook event से आगे)।

​

Teams RSC + Microsoft Graph Application permissions के साथ

• hosted contents download करना (messages में paste की गई images)।
• SharePoint/OneDrive में stored file attachments download करना।
• Graph के माध्यम से channel/chat message history पढ़ना।

​

RSC बनाम Graph API

​

Graph-enabled media + history (channels के लिए आवश्यक)

1. Entra ID (Azure AD) App Registration में, Microsoft Graph Application permissions जोड़ें:
   • ChannelMessage.Read.All (channel attachments + history)
   • Chat.Read.All या ChatMessage.Read.All (group chats)
2. tenant के लिए admin consent grant करें।
3. Teams app manifest version bump करें, re-upload करें, और Teams में ऐप reinstall करें।
4. cached app metadata साफ़ करने के लिए Teams को पूरी तरह quit करके relaunch करें।

​

ज्ञात सीमाएं

​

Webhook timeouts

• Gateway timeouts
• Teams द्वारा message retry करना (duplicates पैदा करते हुए)
• replies drop होना

​

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

​

फ़ॉर्मैटिंग

• बुनियादी फ़ॉर्मैटिंग काम करती है: bold, italic, code, लिंक
• जटिल markdown (तालिकाएं, नेस्टेड सूचियां) सही ढंग से रेंडर नहीं हो सकते
• Adaptive Cards पोल और सिमैंटिक प्रस्तुति भेजने के लिए समर्थित हैं (नीचे देखें)

​

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

• channels.msteams.enabled: channel को सक्षम/अक्षम करें।
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: बॉट क्रेडेंशियल।
• channels.msteams.cloud: Teams SDK cloud environment (Public, USGov, USGovDoD, या China; डिफ़ॉल्ट Public)। USGov/DoD SDK clouds के लिए इसे serviceUrl के साथ सेट करें; China, SDK preset और संग्रहीत Azure China Bot Framework conversation references का उपयोग करता है, और Graph-backed helpers तब तक अक्षम रहते हैं जब तक Azure China Graph routing लागू नहीं हो जाती।
• channels.msteams.serviceUrl: SDK proactive operations के लिए Bot Connector service URL boundary। Public cloud SDK डिफ़ॉल्ट का उपयोग करता है; इसे GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High, या DoD के लिए सेट करें। China, Azure China Bot Framework channel hosts स्वीकार करता है जब संग्रहीत conversation reference 21Vianet द्वारा संचालित Teams से आता है।
• channels.msteams.webhook.port (डिफ़ॉल्ट 3978)
• channels.msteams.webhook.path (डिफ़ॉल्ट /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (डिफ़ॉल्ट: pairing)
• channels.msteams.allowFrom: DM अनुमति-सूची (AAD object IDs अनुशंसित)। Graph access उपलब्ध होने पर सेटअप के दौरान विज़ार्ड नामों को IDs में resolve करता है।
• channels.msteams.dangerouslyAllowNameMatching: mutable UPN/display-name matching और सीधे team/channel name routing को फिर से सक्षम करने के लिए आपातकालीन toggle।
• channels.msteams.textChunkLimit: outbound text chunk size।
• channels.msteams.chunkMode: length chunking से पहले blank lines (paragraph boundaries) पर split करने के लिए length (डिफ़ॉल्ट) या newline।
• channels.msteams.mediaAllowHosts: inbound attachment hosts के लिए अनुमति-सूची (डिफ़ॉल्ट Microsoft/Teams domains)।
• channels.msteams.mediaAuthAllowHosts: media retries पर Authorization headers संलग्न करने के लिए अनुमति-सूची (डिफ़ॉल्ट Graph + Bot Framework hosts)।
• channels.msteams.requireMention: channels/groups में @mention आवश्यक करें (डिफ़ॉल्ट true)।
• channels.msteams.replyStyle: thread | top-level (Reply Style देखें)।
• channels.msteams.teams.<teamId>.replyStyle: प्रति-team override।
• channels.msteams.teams.<teamId>.requireMention: प्रति-team override।
• channels.msteams.teams.<teamId>.tools: default per-team tool policy overrides (allow/deny/alsoAllow) जो channel override अनुपस्थित होने पर उपयोग होते हैं।
• channels.msteams.teams.<teamId>.toolsBySender: default per-team per-sender tool policy overrides ("*" wildcard समर्थित)।
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: प्रति-channel override।
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: प्रति-channel override।
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: प्रति-channel tool policy overrides (allow/deny/alsoAllow)।
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: प्रति-channel per-sender tool policy overrides ("*" wildcard समर्थित)।
• toolsBySender keys को स्पष्ट prefixes का उपयोग करना चाहिए: channel:, id:, e164:, username:, name: (legacy unprefixed keys अभी भी केवल id: पर map होते हैं)।
• channels.msteams.actions.memberInfo: Graph-backed member info action को सक्षम या अक्षम करें (डिफ़ॉल्ट: Graph credentials उपलब्ध होने पर सक्षम)।
• channels.msteams.authType: authentication type - "secret" (डिफ़ॉल्ट) या "federated"।
• channels.msteams.certificatePath: PEM certificate file का path (federated + certificate auth)।
• channels.msteams.certificateThumbprint: certificate thumbprint (वैकल्पिक, auth के लिए आवश्यक नहीं)।
• channels.msteams.useManagedIdentity: managed identity auth सक्षम करें (federated mode)।
• channels.msteams.managedIdentityClientId: user-assigned managed identity के लिए client ID।
• channels.msteams.sharePointSiteId: group chats/channels में file uploads के लिए SharePoint site ID (group chats में files भेजना देखें)।

​

Routing और sessions

• Session keys standard agent format का पालन करती हैं (/concepts/session देखें):
  • Direct messages मुख्य session साझा करते हैं (agent:<agentId>:<mainKey>)।
  • Channel/group messages conversation id का उपयोग करते हैं:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Reply style: threads बनाम posts

• Threads-style channel में thread → replies असहज रूप से nested दिखाई देते हैं
• Posts-style channel में top-level → replies in-thread के बजाय अलग top-level posts के रूप में दिखाई देते हैं

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

​

Resolution precedence

1. प्रति-channel — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. प्रति-team — channels.msteams.teams.<teamId>.replyStyle
3. Global — channels.msteams.replyStyle
4. Implicit default — requireMention से derive किया गया:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Thread context preservation

​

अटैचमेंट और इमेज

• DMs: इमेज और फ़ाइल अटैचमेंट Teams bot file APIs के ज़रिए काम करते हैं।
• चैनल/ग्रुप: अटैचमेंट M365 storage (SharePoint/OneDrive) में रहते हैं। Webhook payload में केवल HTML stub शामिल होता है, वास्तविक फ़ाइल bytes नहीं। चैनल अटैचमेंट डाउनलोड करने के लिए Graph API permissions आवश्यक हैं।
• स्पष्ट file-first sends के लिए, media / filePath / path के साथ action=upload-file का उपयोग करें; वैकल्पिक message साथ का टेक्स्ट/कमेंट बन जाता है, और filename अपलोड किए गए नाम को override करता है।

​

ग्रुप चैट में फ़ाइलें भेजना

​

ग्रुप चैट को SharePoint की आवश्यकता क्यों होती है

​

सेटअप

1. Entra ID (Azure AD) → App Registration में Graph API permissions जोड़ें:
   • Sites.ReadWrite.All (Application) - SharePoint पर फ़ाइलें अपलोड करें
   • Chat.Read.All (Application) - वैकल्पिक, per-user sharing links सक्षम करता है
2. tenant के लिए admin consent प्रदान करें।
3. अपना SharePoint site ID प्राप्त करें:
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw कॉन्फ़िगर करें:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Sharing व्यवहार

​

Fallback व्यवहार

​

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

​

Polls (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Votes को gateway द्वारा OpenClaw plugin-state SQLite में state/openclaw.sqlite के अंतर्गत रिकॉर्ड किया जाता है।
• मौजूदा msteams-polls.json फ़ाइलें openclaw doctor --fix द्वारा import की जाती हैं, running plugin द्वारा नहीं।
• Votes रिकॉर्ड करने के लिए gateway को online रहना चाहिए।
• Polls अभी result summaries auto-post नहीं करते, और अभी कोई supported poll-results CLI नहीं है।

​

Presentation cards

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello!" }],
  },
}

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

​

Target formats

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Send a presentation card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "Hello!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello" }],
  },
}

​

Proactive messaging

• Proactive messages केवल तभी संभव हैं जब user ने interact किया हो, क्योंकि उस समय हम conversation references संग्रहीत करते हैं।
• dmPolicy और allowlist gating के लिए /gateway/configuration देखें।

​

Team और Channel IDs (सामान्य Gotcha)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team conversation ID (URL-decode this)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-decode this)

• Team key = /team/ के बाद वाला path segment (URL-decoded, जैसे, 19:Bk4j...@thread.tacv2; पुराने tenants में @thread.skype दिख सकता है, जो भी valid है)
• Channel key = /channel/ के बाद वाला path segment (URL-decoded)
• OpenClaw routing के लिए groupId query parameter को ignore करें। यह Microsoft Entra group ID है, incoming Teams activities में उपयोग किया जाने वाला Bot Framework conversation ID नहीं।

​

Private channels

1. bot interactions के लिए standard channels का उपयोग करें
2. DMs का उपयोग करें - users हमेशा bot को सीधे message कर सकते हैं
3. historical access के लिए Graph API का उपयोग करें (ChannelMessage.Read.All आवश्यक)

​

Troubleshooting

​

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

• चैनलों में इमेज नहीं दिख रहीं: Graph permissions या admin consent गायब है। Teams app को reinstall करें और Teams को पूरी तरह quit/reopen करें।
• चैनल में कोई response नहीं: mentions डिफ़ॉल्ट रूप से आवश्यक हैं; channels.msteams.requireMention=false सेट करें या प्रति team/channel configure करें।
• Version mismatch (Teams अभी भी पुराना manifest दिखाता है): app को remove + re-add करें और refresh करने के लिए Teams को पूरी तरह quit करें।
• Webhook से 401 Unauthorized: Azure JWT के बिना manual testing करते समय अपेक्षित है - इसका मतलब endpoint reachable है लेकिन auth विफल हुआ। ठीक से test करने के लिए Azure Web Chat का उपयोग करें।

​

Manifest upload errors

• “Icon file cannot be empty”: manifest उन icon files को reference करता है जिनका आकार 0 bytes है। valid PNG icons बनाएँ (outline.png के लिए 32x32, color.png के लिए 192x192)।
• “webApplicationInfo.Id already in use”: app अभी भी किसी अन्य team/chat में installed है। पहले उसे find और uninstall करें, या propagation के लिए 5-10 मिनट प्रतीक्षा करें।
• upload पर “Something went wrong”: इसके बजाय https://admin.teams.microsoft.com के ज़रिए upload करें, browser DevTools (F12) → Network tab खोलें, और वास्तविक error के लिए response body देखें।
• Sideload विफल हो रहा है: “Upload a custom app” के बजाय “Upload an app to your org’s app catalog” आज़माएँ - यह अक्सर sideload restrictions को bypass कर देता है।

​

RSC permissions काम नहीं कर रहीं

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