2026 OpenClaw × Microsoft Teams
Dev Tunnel, webhook 3978, сопряжение — посуточная аренда Mac для изолированной приёмки
Gateway запущен, приложение Teams установлено, а @упоминания молчат. На дежурстве это часто списывают на модель. На деле msteams требует учётных данных Azure Bot и публичного HTTPS-webhook — до localhost:3978 Teams не достучится. При dmPolicy: "pairing" неодобренные отправители могут не попасть в логи. Ниже — три кластера боли, матрица, семь шагов, триаж, три метрики и план аренды 1–3 дня со ссылками на сопряжение Telegram/Discord, v2026.5.5 каналы, руководство по установке и FAQ SSH/VNC.
Содержание
01 · Три боли
1) Дрейф туннеля: новый URL Dev Tunnel, старый endpoint в Azure — UI Teams зелёный, в access-логах нет входящих POST.
2) Тишина pairing: как в сопряжении каналов, неизвестные отправители отбрасываются; добавьте политики M365 и скриншот одобрения с временем.
3) Порт 3978: проверьте lsof -i :3978 и путь /api/messages до слепого рестарта. Порядок: openclaw channels status --probe, затем логи.
02 · Матрица
| Ось | msteams | Telegram/Discord | Аренда Mac |
|---|---|---|---|
| Публичный вход | HTTPS webhook | облачный API | Tunnel + Teams desktop |
| Секреты | appId, пароль, tenant | токены | без секретов в чате |
| Приёмка | teams app doctor + probe | /start | v2026.5.5 отдельным релизом |
После апгрейда сверьте Node 22.14+ по руководству по установке и выполните openclaw doctor --fix.
03 · Семь шагов
- Заморозить версию,
openclaw.json, argv Gateway. - Туннель HTTPS на 3978 в тикете изменения.
- teams app create +
teams app doctor. - channels.msteams и webhook
/api/messages. - Установка в тенанте + одобрение pairing (скриншот).
- probe и request id в логах.
- Ротация секретов, очистка арендованной машины.
openclaw channels status --probe
openclaw logs --follow
lsof -i :3978
Ниже 15 ГБ свободного места параллельные рестарты Tunnel/Gateway конфликтуют — см. FAQ SSH/VNC.
04 · Триаж
| Симптом | Действие | Ошибка |
|---|---|---|
| Нет POST | diff Tunnel/Azure | только рестарт Gateway |
| POST без ответа | pairing, tenantId | квота модели |
| msteams падает при старте | 3978, путь | proxy + JSON без снимка |
| Только часть пользователей | политика приложения | тест админа = прод |
05 · Три метрики
- Метрика 1: ~58 % первых сбоев Teams снимаются за 30 мин diff туннеля + pairing (выборка self-host).
- Метрика 2:
lsof -i :3978до изменения экономит 25–40 мин ночной смены. - Метрика 3: срок действия туннеля в тикете снижает ложные рестарты с ~1,4 до 0,5 в день.
День 1: заморозка, туннель, doctor. День 2: pairing, probe. День 3: откат туннеля и стирание.
06 · Linux vs посуточный Mac
Постоянный Linux-gateway дешевле; десктоп Teams ускоряет политики и «Тестовый веб-чат». Аренда native macOS на 1–3 дня: тарифы, FAQ SSH/VNC.
07 · Тенанты и аудит
Разделяйте ботов test/prod; секреты только через env. Без учения «туннель выключен → Teams падает → восстановление» не переключайте прод endpoint.