Ir al contenido
Guías

Configuración de Microsoft Teams en OpenClaw

Las variables de entorno de autenticación, los límites de historial y de contexto de hilo, los modos de visibilidad del contexto, la nube y la URL de servicio para las nubes gubernamentales y de China, el webhook, las políticas de mensajes directos y los ID de objeto estables, los límites de fragmentos y de medios, las sobrescrituras por equipo y por canal, las tarjetas de bienvenida, las valoraciones y el SSO

6 min de lectura

El canal de Teams tiene una de las listas de claves más largas de todos los canales de OpenClaw, porque tiene que cubrir en un solo bloque las nubes gubernamentales, el historial respaldado por Graph, las sobrescrituras por equipo y los flujos de bienvenida con tarjetas adaptables. Esta es la lista tal como la agrupa la documentación: variables de entorno, contexto de historial y las claves de configuración propiamente dichas.

Variables de entorno e historial

  • Solo las claves relacionadas con la autenticación pueden venir del entorno: el ID de la aplicación, la contraseña de la aplicación, el ID del inquilino, el tipo de autenticación como secreto o federado, la ruta y la huella digital del certificado para el método por certificado, y el indicador de identidad administrada y el ID de cliente para el método por identidad; otras claves, como la política de grupo o el límite de historial, solo se definen en la configuración.
  • El límite de historial controla cuántos mensajes recientes del canal o del grupo se incluyen en el prompt; si falta, recurre al límite global de historial de chats de grupo y después a 50, y el valor cero lo desactiva.
  • El contexto de hilo de Graph añade el mensaje principal y hasta las 50 respuestas más antiguas junto al historial reciente del canal, excluye el mensaje que lo activa, mantiene el historial separado del texto de comando del remitente para que los comandos citados en el historial no se ejecuten, y recorta los mensajes largos recuperados a su principio y su final dentro del límite por mensaje.
  • El contexto de hilos y de adjuntos citados sigue la clave de visibilidad del contexto, con respaldo en los valores predeterminados de los canales y después en all; allowlist filtra ambos según las listas de remitentes permitidos y allowlist-quote filtra el historial del hilo pero permite el contexto citado; el historial de mensajes directos se limita en turnos de usuario, con una sobrescritura por usuario.
Los ID de objeto de AAD estables también autorizan las acciones de aprobación.

Nubes, webhook, acceso, límites

El indicador de activación, el ID de la aplicación, la contraseña de la aplicación y el ID del inquilino son lo básico. La clave de nube selecciona el entorno del SDK de Teams, público de forma predeterminada, o gobierno de EE. UU., DoD o China, y se define junto con la URL de servicio para las nubes gubernamentales; China usa el preajuste del SDK y referencias de conversación de Azure China almacenadas, con las funciones auxiliares respaldadas por Graph desactivadas hasta que llegue el enrutamiento de Graph para Azure China, y la URL de servicio es la frontera del Bot Connector para las operaciones proactivas, con un valor predeterminado para la nube pública y definida explícitamente para GCC, GCC High o DoD. El puerto del webhook es 3978 de forma predeterminada y la ruta, la de mensajes. La política de mensajes directos admite pairing, allowlist, open o disabled, con pairing como valor predeterminado; la lista de permitidos de mensajes directos prefiere los ID de objeto de AAD, que también autorizan las acciones de aprobación, y el asistente de configuración resuelve los nombres a ID cuando hay acceso a Graph; el destino predeterminado define el destino de salida y también puede autorizar aprobaciones, y la clave peligrosa de coincidencia por nombre es el interruptor de emergencia que vuelve a activar la coincidencia por UPN o por nombre para mostrar, que son mutables, y el enrutamiento directo por nombre de equipo o de canal. El límite de fragmentos de texto es 4000 de forma predeterminada y tiene ahí un tope fijo, configures lo que configures; el modo de fragmentación por saltos de línea divide en las líneas en blanco antes que por longitud; la lista de hosts de medios permitidos incluye de forma predeterminada los dominios de Microsoft y Teams; la lista de autenticación de medios decide dónde se pueden adjuntar encabezados Authorization en los reintentos; el respaldo de medios de Graph activa las búsquedas en Graph cuando el HTML omite los marcadores de archivo, y el límite de tamaño de medios recurre al valor predeterminado del agente.

Sobrescrituras, tarjetas, valoraciones, SSO

  • El requisito de mención es true de forma predeterminada y el estilo de respuesta elige entre hilo o nivel superior; ambos se pueden sobrescribir por equipo y por canal en el mapa teams, indexado por ID de equipo e ID de conversación, junto con políticas de herramientas por equipo y por canal con allow, deny y also-allow, y políticas de herramientas por remitente indexadas con prefijos explícitos channel, id, e164, username o name y el comodín.
  • El tipo de autenticación, la ruta y la huella digital del certificado, el indicador de identidad administrada y el ID de cliente reflejan la página de autenticación, y el ID del sitio de SharePoint indica el sitio que se usa para subir archivos en los chats de grupo y los canales.
  • Una tarjeta de bienvenida y una tarjeta de bienvenida de grupo con sugerencias de prompt muestran una tarjeta adaptable en el primer contacto por mensaje directo o en grupo, el prefijo de respuesta antepone texto a las respuestas salientes, las valoraciones con pulgar arriba y pulgar abajo están activadas de forma predeterminada con un seguimiento de reflexión tras una valoración negativa y su periodo de espera, y los bloques de SSO y de autenticación delegada configuran la conexión OAuth de Bot Framework y los scopes delegados de Graph; activar el SSO requiere un nombre de conexión.

OpenClaw en Microsoft Teams es el artículo del canal al que pertenecen estas claves, y la autenticación de Microsoft Teams en OpenClaw, los métodos federados detrás de las claves de autenticación.

ID, no nombres

Tres claves de la lista comparten un principio: los ID de objeto son estables y los nombres no, así que las listas de permitidos, las aprobaciones y los destinos deben llevar el ID, y el interruptor de coincidencia por nombre solo existe para mantener viva una instalación antigua mientras se migra. La guía del manifiesto y los permisos de Microsoft Teams en OpenClaw cubre los permisos que necesitan las funciones auxiliares respaldadas por Graph, y los chats de grupo en OpenClaw, las reglas comunes a todos los canales para las conversaciones de grupo que estas sobrescrituras afinan.

En Diali

Microsoft Teams no está entre los canales que Diali conecta hoy: WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS y voz. OpenClaw alojado en Diali es el asistente, y la guía para conectar tu primer canal en cinco minutos muestra los canales que puedes conectar en cinco minutos.

  • Solo las claves de autenticación vienen del entorno; el resto va en la configuración.
  • El contexto de hilo trae el mensaje principal y cincuenta respuestas, nunca sus comandos.
  • 4000 caracteres por fragmento, con tope fijo.
Empezar

Deja de leer sobre ello y crea el tuyo

Configura un agente, elige un canal y ponlo a trabajar dentro de la aplicación que ya tienes abierta.