Microsoft Teams

​

Paketlenmiş plugin

openclaw plugins install @openclaw/msteams

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

​

Hızlı kurulum

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"

• Bir Entra ID (Azure AD) uygulaması oluşturur
• Bir istemci gizli anahtarı üretir
• Bir Teams uygulama manifesti oluşturur ve yükler (simgelerle)
• Botu kaydeder (varsayılan olarak Teams tarafından yönetilir - Azure aboneliği gerekmez)

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

​

Hedefler

• OpenClaw ile Teams DM’leri, grup sohbetleri veya kanallar üzerinden konuşun.
• Yönlendirmeyi deterministik tutun: yanıtlar her zaman geldikleri kanala geri gider.
• Varsayılan olarak güvenli kanal davranışı kullanın (aksi yapılandırılmadıkça bahsetmeler gerekir).

​

Yapılandırma yazmaları

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

​

Erişim denetimi (DM’ler + gruplar)

• Varsayılan: channels.msteams.dmPolicy = "pairing". Bilinmeyen gönderenler onaylanana kadar yok sayılır.
• channels.msteams.allowFrom, kararlı AAD nesne kimliklerini veya accessGroup:core-team gibi statik gönderen erişim gruplarını kullanmalıdır.
• İzin listeleri için UPN/görünen ad eşleştirmesine güvenmeyin - bunlar değişebilir. OpenClaw doğrudan ad eşleştirmesini varsayılan olarak devre dışı bırakır; channels.msteams.dangerouslyAllowNameMatching: true ile açıkça etkinleştirin.
• Sihirbaz, kimlik bilgileri izin verdiğinde adları Microsoft Graph üzerinden kimliklere çözümleyebilir.

• Varsayılan: channels.msteams.groupPolicy = "allowlist" (groupAllowFrom eklemediğiniz sürece engellenir). Ayarlanmamışsa varsayılanı geçersiz kılmak için channels.defaults.groupPolicy kullanın.
• channels.msteams.groupAllowFrom, grup sohbetlerinde/kanallarında hangi gönderenlerin veya statik gönderen erişim gruplarının tetikleyebileceğini denetler (channels.msteams.allowFrom değerine geri döner).
• Herhangi bir üyeye izin vermek için groupPolicy: "open" ayarlayın (varsayılan olarak yine bahsetme kapılıdır).
• Hiçbir kanala izin vermemek için channels.msteams.groupPolicy: "disabled" ayarlayın.

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

• channels.msteams.teams altında ekipleri ve kanalları listeleyerek grup/kanal yanıtlarının kapsamını belirleyin.
• Anahtarlar, değiştirilebilir görünen adlar yerine Teams bağlantılarından gelen kararlı Teams konuşma kimliklerini kullanmalıdır.
• groupPolicy="allowlist" olduğunda ve bir ekip izin listesi mevcut olduğunda, yalnızca listelenen ekipler/kanallar kabul edilir (bahsetme kapılı).
• Yapılandırma sihirbazı Team/Channel girdilerini kabul eder ve sizin için saklar.
• Başlangıçta OpenClaw, ekip/kanal ve kullanıcı izin listesi adlarını kimliklere çözümler (Graph izinleri izin verdiğinde) ve eşlemeyi günlüğe yazar; çözümlenemeyen ekip/kanal adları yazıldığı gibi tutulur ancak channels.msteams.dangerouslyAllowNameMatching: true etkinleştirilmediği sürece varsayılan olarak yönlendirme için yok sayılır.

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

​

Birleşik kimlik doğrulama (sertifika artı yönetilen kimlik)

2026.4.11’de eklendi

​

Seçenek A: Sertifika tabanlı kimlik doğrulama

1. Bir sertifika oluşturun veya edinin (özel anahtarlı PEM biçimi).
2. Entra ID → App Registration → Sertifikalar ve gizli diziler → Sertifikalar → Genel sertifikayı yükleyin.

{
  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

​

Seçenek B: Azure Yönetilen Kimlik

1. Bot pod’u/VM’si bir yönetilen kimliğe sahiptir (sistem tarafından atanmış veya kullanıcı tarafından atanmış).
2. Bir birleşik kimlik bilgisi, yönetilen kimliği Entra ID uygulama kaydına bağlar.
3. Çalışma zamanında OpenClaw, Azure IMDS uç noktasından (169.254.169.254) token almak için @azure/identity kullanır.
4. Token, bot kimlik doğrulaması için Teams SDK’ya iletilir.

• Yönetilen kimlik etkin Azure altyapısı (AKS workload identity, App Service, VM)
• Entra ID uygulama kaydında oluşturulmuş birleşik kimlik bilgisi
• Pod/VM’den IMDS’ye (169.254.169.254:80) ağ erişimi

{
  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> (yalnızca kullanıcı tarafından atanmış için)

​

AKS İş Yükü Kimliği Kurulumu

1. AKS kümenizde iş yükü kimliğini etkinleştirin.
2. Entra ID uygulama kaydında bir birleşik kimlik kimlik bilgisi oluşturun:
   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. Kubernetes hizmet hesabına uygulama istemci kimliğiyle açıklama ekleyin:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. İş yükü kimliği enjeksiyonu için podu etiketleyin:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. IMDS’ye (169.254.169.254) ağ erişimi olduğundan emin olun - NetworkPolicy kullanıyorsanız, 80 numaralı bağlantı noktasında 169.254.169.254/32 hedefine trafiğe izin veren bir çıkış kuralı ekleyin.

​

Kimlik doğrulama türü karşılaştırması

​

Yerel geliştirme (tünelleme)

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

​

Botu Test Etme

teams app doctor <teamsAppId>

1. Teams uygulamasını yükleyin (teams app get <id> --install-link komutundaki yükleme bağlantısını kullanın)
2. Teams içinde botu bulun ve bir DM gönderin
3. Gelen etkinlik için Gateway günlüklerini kontrol edin

​

Ortam değişkenleri

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (isteğe bağlı: "secret" veya "federated")
• MSTEAMS_CERTIFICATE_PATH (birleşik + sertifika)
• MSTEAMS_CERTIFICATE_THUMBPRINT (isteğe bağlı, kimlik doğrulama için gerekli değil)
• MSTEAMS_USE_MANAGED_IDENTITY (birleşik + yönetilen kimlik)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (yalnızca kullanıcı tarafından atanmış MI)

​

Üye bilgisi eylemi

• Member.Read.Group RSC izni (önerilen bildirimde zaten var)
• Ekipler arası aramalar için: yönetici onayıyla User.Read.All Graph Uygulama izni

​

Geçmiş bağlamı

• channels.msteams.historyLimit, son kanal/grup mesajlarından kaç tanesinin isteme sarılacağını denetler.
• messages.groupChat.historyLimit değerine geri döner. Devre dışı bırakmak için 0 olarak ayarlayın (varsayılan 50).
• Getirilen ileti dizisi geçmişi, gönderen izin listelerine (allowFrom / groupAllowFrom) göre filtrelenir; bu nedenle ileti dizisi bağlamı tohumlaması yalnızca izin verilen gönderenlerden gelen mesajları içerir.
• Alıntılanan ek bağlamı (Teams yanıt HTML’sinden türetilen ReplyTo*) şu anda alındığı gibi geçirilir.
• Başka bir deyişle, izin listeleri ajanı kimin tetikleyebileceğini denetler; bugün yalnızca belirli tamamlayıcı bağlam yolları filtrelenir.
• DM geçmişi channels.msteams.dmHistoryLimit (kullanıcı dönüşleri) ile sınırlandırılabilir. Kullanıcı başına geçersiz kılmalar: channels.msteams.dms["<user_id>"].historyLimit.

​

Geçerli Teams RSC izinleri (bildirim)

• ChannelMessage.Read.Group (Application) - @bahsetme olmadan tüm kanal mesajlarını al
• 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) - @bahsetme olmadan tüm grup sohbeti mesajlarını al

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

​

Örnek Teams bildirimi (redakte edilmiş)

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

​

Bildirim uyarıları (zorunlu alanlar)

• bots[].botId Azure Bot Uygulama Kimliği ile eşleşmelidir.
• webApplicationInfo.id Azure Bot Uygulama Kimliği ile eşleşmelidir.
• bots[].scopes, kullanmayı planladığınız yüzeyleri (personal, team, groupChat) içermelidir.
• Kişisel kapsamda dosya işleme için bots[].supportsFiles: true gerekir.
• Kanal trafiği istiyorsanız authorization.permissions.resourceSpecific, kanal okuma/gönderme izinlerini içermelidir.

​

Mevcut bir uygulamayı güncelleme

# 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

​

Yetenekler: Yalnızca RSC ve Graph karşılaştırması

​

Yalnızca Teams RSC ile (uygulama yüklü, Graph API izinleri yok)

• Kanal mesajı metin içeriğini okuma.
• Kanal mesajı metin içeriği gönderme.
• Kişisel (DM) dosya eklerini alma.

• Kanal/grup görüntü veya dosya içerikleri (yük yalnızca HTML yer tutucusu içerir).
• SharePoint/OneDrive içinde depolanan ekleri indirme.
• Mesaj geçmişini okuma (canlı Webhook olayı dışında).

​

Teams RSC + Microsoft Graph Uygulama izinleri ile

• Barındırılan içerikleri indirme (mesajlara yapıştırılan görüntüler).
• SharePoint/OneDrive içinde depolanan dosya eklerini indirme.
• Graph aracılığıyla kanal/sohbet mesaj geçmişini okuma.

​

RSC ve Graph API karşılaştırması

​

Graph etkinleştirilmiş medya + geçmiş (kanallar için gerekli)

1. Entra ID (Azure AD) Uygulama Kaydı içinde Microsoft Graph Uygulama izinleri ekleyin:
   • ChannelMessage.Read.All (kanal ekleri + geçmiş)
   • Chat.Read.All veya ChatMessage.Read.All (grup sohbetleri)
2. Kiracı için yönetici onayı verin.
3. Teams uygulaması bildirim sürümünü artırın, yeniden yükleyin ve uygulamayı Teams içinde yeniden yükleyin.
4. Önbelleğe alınmış uygulama meta verilerini temizlemek için Teams’ten tamamen çıkıp yeniden başlatın.

​

Bilinen sınırlamalar

​

Webhook zaman aşımları

• Gateway zaman aşımları
• Teams’in mesajı yeniden denemesi (yinelenenlere neden olur)
• Düşen yanıtlar

​

Teams bulutu ve hizmet URL’si desteği

• channels.msteams.cloud, kimlik doğrulama, JWT doğrulaması, belirteç hizmetleri ve Graph kapsamı için Teams SDK bulut ön ayarını seçer.
• channels.msteams.serviceUrl, proaktif gönderimler, düzenlemeler, silmeler, kartlar, anketler, dosya onayı mesajları ve kuyruğa alınmış uzun süren yanıtlar öncesinde depolanan konuşma başvurularını doğrulamak için kullanılan Bot Connector uç noktası sınırını seçer. USGov ve DoD SDK bulutları için gereklidir. China/21Vianet için OpenClaw, SDK China ön ayarını kullanır ve depolanan/yapılandırılan hizmet URL’lerini yalnızca Azure China Bot Framework kanal konaklarında kabul eder.

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

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

​

Biçimlendirme

• Temel biçimlendirme çalışır: kalın, italik, code, bağlantılar
• Karmaşık markdown (tablolar, iç içe listeler) doğru işlenmeyebilir
• Adaptive Cards, anketler ve anlamsal sunum gönderimleri için desteklenir (aşağıya bakın)

​

Yapılandırma

• channels.msteams.enabled: kanalı etkinleştirir/devre dışı bırakır.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: bot kimlik bilgileri.
• channels.msteams.cloud: Teams SDK bulut ortamı (Public, USGov, USGovDoD veya China; varsayılan Public). USGov/DoD SDK bulutları için bunu serviceUrl ile ayarlayın; China, SDK ön ayarını ve saklanan Azure China Bot Framework konuşma başvurularını kullanır, Azure China Graph yönlendirmesi uygulanana kadar Graph destekli yardımcılar devre dışıdır.
• channels.msteams.serviceUrl: SDK proaktif işlemleri için Bot Connector hizmet URL’si sınırı. Public bulutu SDK varsayılanını kullanır; bunu GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High veya DoD için ayarlayın. Saklanan konuşma başvurusu 21Vianet tarafından işletilen Teams’ten geldiğinde China, Azure China Bot Framework kanal host’larını kabul eder.
• channels.msteams.webhook.port (varsayılan 3978)
• channels.msteams.webhook.path (varsayılan /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (varsayılan: pairing)
• channels.msteams.allowFrom: DM izin listesi (AAD nesne kimlikleri önerilir). Sihirbaz, Graph erişimi kullanılabildiğinde kurulum sırasında adları kimliklere çözümler.
• channels.msteams.dangerouslyAllowNameMatching: değiştirilebilir UPN/görünen ad eşleştirmesini ve doğrudan ekip/kanal adı yönlendirmesini yeniden etkinleştirmek için acil durum anahtarı.
• channels.msteams.textChunkLimit: giden metin parçası boyutu.
• channels.msteams.chunkMode: uzunluğa göre parçalamadan önce boş satırlara (paragraf sınırları) göre bölmek için length (varsayılan) veya newline.
• channels.msteams.mediaAllowHosts: gelen ek host’ları için izin listesi (varsayılan olarak Microsoft/Teams alan adları).
• channels.msteams.mediaAuthAllowHosts: medya yeniden denemelerinde Authorization üstbilgileri eklemek için izin listesi (varsayılan olarak Graph + Bot Framework host’ları).
• channels.msteams.requireMention: kanallarda/gruplarda @mention gerektirir (varsayılan true).
• channels.msteams.replyStyle: thread | top-level (bkz. Yanıt Stili).
• channels.msteams.teams.<teamId>.replyStyle: ekip başına geçersiz kılma.
• channels.msteams.teams.<teamId>.requireMention: ekip başına geçersiz kılma.
• channels.msteams.teams.<teamId>.tools: kanal geçersiz kılması eksik olduğunda kullanılan ekip başına varsayılan araç politikası geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.toolsBySender: ekip başına gönderici bazlı varsayılan araç politikası geçersiz kılmaları ("*" joker karakteri desteklenir).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: kanal başına geçersiz kılma.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: kanal başına geçersiz kılma.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: kanal başına araç politikası geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: kanal başına gönderici bazlı araç politikası geçersiz kılmaları ("*" joker karakteri desteklenir).
• toolsBySender anahtarları açık önekler kullanmalıdır: channel:, id:, e164:, username:, name: (eski öneksiz anahtarlar hâlâ yalnızca id: ile eşlenir).
• channels.msteams.actions.memberInfo: Graph destekli üye bilgisi eylemini etkinleştirir veya devre dışı bırakır (varsayılan: Graph kimlik bilgileri mevcut olduğunda etkin).
• channels.msteams.authType: kimlik doğrulama türü - "secret" (varsayılan) veya "federated".
• channels.msteams.certificatePath: PEM sertifika dosyasının yolu (federated + sertifika kimlik doğrulaması).
• channels.msteams.certificateThumbprint: sertifika parmak izi (isteğe bağlı, kimlik doğrulama için gerekli değildir).
• channels.msteams.useManagedIdentity: yönetilen kimlik kimlik doğrulamasını etkinleştirir (federated modu).
• channels.msteams.managedIdentityClientId: kullanıcı tarafından atanmış yönetilen kimlik için istemci kimliği.
• channels.msteams.sharePointSiteId: grup sohbetlerinde/kanallarda dosya yüklemeleri için SharePoint site kimliği (bkz. Grup sohbetlerinde dosya gönderme).

​

Yönlendirme ve oturumlar

• Oturum anahtarları standart aracı biçimini izler (bkz. /concepts/session):
  • Doğrudan mesajlar ana oturumu paylaşır (agent:<agentId>:<mainKey>).
  • Kanal/grup mesajları konuşma kimliğini kullanır:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Yanıt stili: ileti dizileri ve gönderiler

• Threads tarzı bir kanalda thread → yanıtlar uygunsuz şekilde iç içe görünür
• Posts tarzı bir kanalda top-level → yanıtlar ileti dizisi içinde değil, ayrı üst düzey gönderiler olarak görünür

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

​

Çözümleme önceliği

1. Kanal başına — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Ekip başına — channels.msteams.teams.<teamId>.replyStyle
3. Genel — channels.msteams.replyStyle
4. Örtük varsayılan — requireMention değerinden türetilir:
   • requireMention: true → thread
   • requireMention: false → top-level

​

İleti dizisi bağlamını koruma

​

Ekler ve görseller

• DM’ler: Görseller ve dosya ekleri Teams bot dosya API’leri üzerinden çalışır.
• Kanallar/gruplar: Ekler M365 depolama alanında (SharePoint/OneDrive) bulunur. Webhook yükü gerçek dosya baytlarını değil, yalnızca bir HTML taslağı içerir. Kanal eklerini indirmek için Graph API izinleri gereklidir.
• Açıkça dosya öncelikli gönderimler için media / filePath / path ile action=upload-file kullanın; isteğe bağlı message eşlik eden metin/yorum olur ve filename yüklenen adı geçersiz kılar.

​

Grup sohbetlerinde dosya gönderme

​

Grup sohbetleri neden SharePoint gerektirir?

​

Kurulum

1. Entra ID (Azure AD) → Uygulama Kaydı içinde Graph API izinleri ekleyin:
   • Sites.ReadWrite.All (Application) - dosyaları SharePoint’e yükler
   • Chat.Read.All (Application) - isteğe bağlıdır, kullanıcı başına paylaşım bağlantılarını etkinleştirir
2. Kiracı için yönetici onayı verin.
3. SharePoint site ID’nizi alın:
   # 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’ı yapılandırın:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Paylaşım davranışı

​

Geri dönüş davranışı

​

Dosyaların depolandığı konum

​

Anketler (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Oylar Gateway tarafından state/openclaw.sqlite altındaki OpenClaw Plugin durumu SQLite içinde kaydedilir.
• Mevcut msteams-polls.json dosyaları çalışan Plugin tarafından değil, openclaw doctor --fix tarafından içe aktarılır.
• Oyları kaydetmek için Gateway çevrimiçi kalmalıdır.
• Anketler henüz sonuç özetlerini otomatik yayımlamaz ve henüz desteklenen bir anket sonuçları CLI’si yoktur.

​

Sunum kartları

{
  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!"}]}'

​

Hedef biçimleri

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

​

Proaktif mesajlaşma

• Proaktif mesajlar yalnızca bir kullanıcı etkileşim kurduktan sonra mümkündür, çünkü konuşma referanslarını o noktada saklarız.
• dmPolicy ve izin listesi geçitleri için /gateway/configuration bölümüne bakın.

​

Ekip ve Kanal ID’leri (Yaygın Tuzak)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Ekip konuşma ID'si (bunu URL kod çözümünden geçirin)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Kanal ID'si (bunu URL kod çözümünden geçirin)

• Ekip anahtarı = /team/ sonrasındaki yol segmenti (URL kodu çözülmüş, ör. 19:Bk4j...@thread.tacv2; eski kiracılar @thread.skype gösterebilir, bu da geçerlidir)
• Kanal anahtarı = /channel/ sonrasındaki yol segmenti (URL kodu çözülmüş)
• OpenClaw yönlendirmesi için groupId sorgu parametresini yok sayın. Bu, gelen Teams etkinliklerinde kullanılan Bot Framework konuşma ID’si değil, Microsoft Entra grup ID’sidir.

​

Özel kanallar

1. Bot etkileşimleri için standart kanallar kullanın
2. DM’leri kullanın; kullanıcılar bota her zaman doğrudan mesaj gönderebilir
3. Geçmiş erişimi için Graph API kullanın (ChannelMessage.Read.All gerektirir)

​

Sorun giderme

​

Yaygın sorunlar

• Görseller kanallarda görünmüyor: Graph izinleri veya yönetici onayı eksik. Teams uygulamasını yeniden yükleyin ve Teams’ten tamamen çıkıp yeniden açın.
• Kanalda yanıt yok: Varsayılan olarak bahsetmeler gereklidir; channels.msteams.requireMention=false ayarlayın veya ekip/kanal bazında yapılandırın.
• Sürüm uyuşmazlığı (Teams hâlâ eski bildirimi gösteriyor): yenilemek için uygulamayı kaldırıp yeniden ekleyin ve Teams’ten tamamen çıkın.
• Webhook’tan 401 Unauthorized: Azure JWT olmadan elle test ederken beklenir; uç noktanın erişilebilir olduğu ancak kimlik doğrulamanın başarısız olduğu anlamına gelir. Doğru test etmek için Azure Web Chat kullanın.

​

Bildirim yükleme hataları

• “Icon file cannot be empty”: Bildirim, 0 bayt olan simge dosyalarına başvuruyor. Geçerli PNG simgeleri oluşturun (outline.png için 32x32, color.png için 192x192).
• “webApplicationInfo.Id already in use”: Uygulama hâlâ başka bir ekipte/sohbette yüklü. Önce onu bulun ve kaldırın ya da yayılım için 5-10 dakika bekleyin.
• Yüklemede “Something went wrong”: Bunun yerine https://admin.teams.microsoft.com üzerinden yükleyin, tarayıcı DevTools’u (F12) → Network sekmesini açın ve gerçek hata için yanıt gövdesini kontrol edin.
• Sideload başarısız: “Upload a custom app” yerine “Upload an app to your org’s app catalog” seçeneğini deneyin; bu çoğu zaman sideload kısıtlamalarını aşar.

​

RSC izinleri çalışmıyor

1. webApplicationInfo.id değerinin botunuzun App ID’siyle tam olarak eşleştiğini doğrulayın
2. Uygulamayı yeniden yükleyin ve ekip/sohbette yeniden kurun
3. Kuruluş yöneticinizin RSC izinlerini engelleyip engellemediğini kontrol edin
4. Doğru kapsamı kullandığınızı onaylayın: ekipler için ChannelMessage.Read.Group, grup sohbetleri için ChatMessage.Read.Chat

​

Başvurular

• Azure Bot Oluşturma - Azure Bot kurulum kılavuzu
• Teams Geliştirici Portalı - Teams uygulamaları oluşturma/yönetme
• Teams uygulama manifest şeması
• RSC ile kanal mesajlarını alma
• RSC izinleri başvurusu
• Teams bot dosya işleme (kanal/grup Graph gerektirir)
• Proaktif mesajlaşma
• @microsoft/teams.cli - bot yönetimi için Teams CLI

​

İlgili

• Kanallara Genel Bakış - desteklenen tüm kanallar
• Eşleştirme - DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar - grup sohbeti davranışı ve bahsetme geçidi
• Kanal Yönlendirme - mesajlar için oturum yönlendirmesi
• Güvenlik - erişim modeli ve güçlendirme