2026 Tencent WeChat ClawBot и OpenClaw: установка, совместимость и runbook Mac VPS (матрица решений и FAQ)
Официальный плагин Tencent @tencent-weixin/openclaw-weixin позволяет использовать личный WeChat как IM-вход для OpenClaw — при условии, что клиент показывает ClawBot в Настройки → Плагины (iOS 8.0.70+, Android 8.0.69+ в greyscale-раскатке). Сканирование QR до стабилизации шлюза даёт таймауты и «канал онлайн без ответа». Это руководство следует рекомендуемому порядку: проверка greyscale → preflight Mac VPS → npx -y @tencent-weixin/openclaw-weixin-cli install → привязка → приёмка — с матрицей WeCom/Telegram, таблицей 2.0.x/1.0.x, продуктовыми ограничениями, runbook из семи шагов и послойным triage.
Содержание
- 1. Боли: нет ClawBot, версия, QR и disconnect
- 2. Матрица: личный WeChat vs WeCom vs Feishu vs Telegram
- 3. Самопроверка greyscale на телефоне
- 4. Preflight Mac VPS: Node 22, 18789, provider, launchd
- 5. Совместимость: openclaw-weixin 2.0.x vs 1.0.x
- 6. Ограничения и compliance
- 7. Runbook из семи шагов: база → CLI → QR → 7×24
- 8. Таблица ошибок и triage
- 9. Примеры использования
- 10. FAQ
- 11. Заключение
1. Боли: нет ClawBot, версия, QR и disconnect
Личный WeChat принципиально отличается от корпоративного WeChat (WeCom): Tencent контролирует greyscale-раскатку, версию протокола и egress данных. Четыре паттерна доминируют в тикетах поддержки весной 2026.
- Нет пункта ClawBot: клиент вне greyscale — нет меню плагина, CLI установлен, но QR не появляется. Ждать или тестировать более новое устройство; не крутить шлюз.
- Плагин отказывается загружаться: OpenClaw ниже 2026.3.22 или неверная major-линия openclaw-weixin; в логах mismatch версий, а не сеть.
- Сбой QR-скана: шлюз не на 18789, firewall или базовый smoke никогда не был зелёным — телефон не достигает VPS.
- Только приём, без отправки: stale-сессия после сна, provider 429 или drift маршрутизации; часто путают с «сломанным ботом», хотя канал онлайн без ответа — реальный слой.
Меняйте одну вещь за шаг при первой установке: сначала стабильный шлюз, затем плагин, затем QR. Параллельные апгрейды ядра OpenClaw и WeChat-плагина создают недокументированные комбинации, похожие на «случайные disconnect».
В post-mortem команды подозревают сеть или LLM, хотя JSONL уже показывает отказ плагина или просроченный QR. Держите одну sessionId во время диагностики и не смешивайте rebind QR, ротацию секретов шлюза и смену provider.
Пятый паттерн — rebind после миграции с ноутбука. Симптом: канал зелёный, но сессия stale после смены хоста. Часто помогает целенаправленный QR-rebind на стабильном Mac VPS — никогда на laptop, который может уснуть до завершения smoke.
2. Матрица: личный WeChat vs WeCom vs Feishu vs Telegram
ClawBot для тех, кто уже живёт в личном WeChat. Компаниям с compliance нужна интеграция WeCom; multi-channel — runbook Feishu/LINE/Telegram.
| Измерение | Личный WeChat ClawBot | WeCom (корп.) | Feishu / Telegram |
|---|---|---|---|
| Вход | Бытовое приложение, greyscale-плагин | Admin-приложение, corp API | Bot token, webhook |
| Группы | Не поддерживается (только DM) | Да, с IT-политиками | Да, настраивается |
| Данные | Контент через серверы Tencent | Enterprise audit trail | Зависит от provider |
| Хост 7×24 | Mac VPS + launchd рекомендуется | Mac VPS типичен | Mac VPS или Docker |
| Compliance | Личный аккаунт, без SLA | Нужно IT-одобрение | Проверить регион/export |
Матрица экономит время до QR: если нужны группы или IT-audit, WeCom или Feishu уместнее; ClawBot силён для личного ассистента в DM. Команды с уже работающими IM-каналами на Mac VPS не должны ожидать ClawBot на отдельном Linux-хосте — плагин Tencent привязан к шлюзу OpenClaw и модели сессий.
3. Самопроверка greyscale на телефоне
До SSH: WeChat → Я → Настройки → Плагины → ClawBot. Нет пункта — никакой server runbook не поможет. iOS минимум 8.0.70, Android 8.0.69 в выбранных регионах. Без пункта: второе устройство с новой версией, ждать rollout, не sideload. С пунктом: немедленный preflight шлюза — QR-сессия короткая.
Зафиксируйте точную версию клиента и регион аккаунта в change ticket. Когда Tencent расширяет greyscale, тот же VPS внезапно показывает валидный QR без изменений — полезно отличить регрессию deploy от ожидания продукта.
4. Preflight Mac VPS: Node 22, 18789, provider, launchd
OpenClaw должен работать как production-шлюз до загрузки плагина Tencent. Ориентир — развёртывание в пять шагов и runbook шлюза.
- Runtime: Node.js 22+;
openclaw --versionиopenclaw doctorбез предупреждений полу-установки. - Шлюз: порт 18789 слушает;
openclaw gateway statushealthy. - Provider: минимум один LLM с успешным echo smoke — иначе WeChat кажется «немым» при зелёном канале.
- Один HOME:
UserNameplist launchd = SSH-пользователь; рабочая директория плагина с минимальными правами. - Audit: до сторонних skills — audit ClawHub.
openclaw gateway status
openclaw --version
lsof -i :18789
Сравните echo $HOME в SSH-shell и в симулированной сессии launchd. Расхождение часто объясняет «зелёно локально, красно в production» после привязки WeChat. Заложите достаточно RAM для шлюза и plugin worker; на shared Mac cloud IM-каналы, LLM provider и skills конкурируют за один пул памяти.
5. Совместимость: openclaw-weixin 2.0.x vs 1.0.x
| Линия плагина | Минимум OpenClaw | Поведение CLI | Примечание upgrade |
|---|---|---|---|
| 2.0.x (текущая) | ≥ 2026.3.22 | CLI выбирает dist-tag автоматически | После upgrade OpenClaw: doctor + rebind при необходимости |
| 1.0.x (legacy) | Старые линии 2026.2 | Нужен ручной pin | Переход на 2.0.x часто требует новый QR |
После upgrade по майскому release train: doctor, проверить версию плагина, повторить DM smoke. «Plugin refused to load» — почти всегда матрица версий, не firewall.
6. Ограничения и compliance
| Правило | Влияние | Рекомендация |
|---|---|---|
| Только DM | Нет группового routing | Проектировать support-flows в личке |
| Без rich media mix | Нет сложных комбо картинка+текст | Ссылки и plain text |
| 24 ч неактивности | Проактивные сообщения бота могут отбрасываться | Тестировать user-initiated turns |
| Один WeChat ID на привязку | Нет multi-device split | Вторичный аккаунт для тестов |
| Серверы Tencent | Контент покидает VPS | Без секретов в чате |
7. Runbook из семи шагов: база → CLI → QR → 7×24
- Принять базу OpenClaw: doctor зелёный, 18789 слушает, echo provider — без WeChat.
- CLI one-click:
npx -y @tencent-weixin/openclaw-weixin-cli install; записать dist-tag и путь плагина в логах. - Ручной fallback: при сбое CLI —
openclaw plugins install @tencent-weixin/openclaw-weixinилиopenclaw channels login weixin. - Сканировать QR: открыть ClawBot на телефоне, сканировать QR в терминале или dashboard — VPS должен быть достижим (Tailscale/VPN при необходимости).
- Restart шлюза:
openclaw gateway restartили reload launchctl; сноваgateway status. - Приёмка DM: отправить и получить в личном чате; JSONL:
channelIdи Delivery. - Reconnect 7×24: симулировать reboot, написать после 24 ч без активности; triage ниже при обрыве.
openclaw gateway restart
openclaw gateway status
openclaw channels status
Архивируйте timestamp QR и версию плагина в change ticket. Rebind после major upgrade без документации обычно снова требует терпения greyscale на телефоне.
Шаг два — CLI install — автоматически выбирает dist-tag; всё равно сохраните вывод. При ручном fallback проверьте, что openclaw channels status показывает WeChat как connected после restart, прежде чем запускать первый DM smoke. Шаг семь — reconnect 7×24 — обязателен: smoke только в интерактивном SSH не доказывает поведение после reboot или plist reload.
8. Таблица ошибок и triage
Последовательно: greyscale → версия плагина → шлюз → provider → session. Для «онлайн без ответа» — статья канала; multi-channel — runbook routing.
| Симптом | Вероятная причина | Исправление |
|---|---|---|
| Нет меню ClawBot | Клиент вне greyscale | Ждать версию/регион, другое устройство |
| Plugin refused to load | OpenClaw или плагин устарели | Upgrade ≥2026.3.22, перезапуск CLI |
| QR timeout | 18789 недоступен | Runbook шлюза, firewall, Tailscale |
| Disconnect после reboot | Неверный launchd/HOME | Plist того же пользователя, rebind |
| Только приём | Provider или routing | 429, intents, slice JSONL |
Избегайте параллельных изменений auth шлюза, config плагина и provider во время инцидента. Слой один — greyscale — проверяйте на телефоне, не на сервере. Слой два — версия — валидируйте OpenClaw ≥2026.3.22 и openclaw-weixin 2.0.x вместе. Слой три — доступность — Tailscale или VPN, если VPS за NAT и телефон не достигает QR-host.
9. Примеры использования
Личный ассистент: разработчик привязывает вторичный WeChat, спрашивает в DM метрики сервера — agent отвечает через tools шлюза; группы не нужны.
WeChat плюс Telegram: production на Mac VPS с обоими каналами; двухканальный load test до go-live, чтобы sessionId не коллидировали.
Микробизнес без WeCom: solo-founder использует ClawBot для DM клиентов; ограничения (24 ч, без rich mix) — в onboarding-тексте.
Compliance-скриншоты через DM: внутренние аудиты требуют периодического подтверждения текста на статус-странице. Cron-triggered agent flow с архивом JSONL даёт повторяемые доказательства — при условии, что секреты не публикуются в WeChat и бот отвечает только на инициированные пользователем сообщения в 24-часовом окне.
10. FAQ
Вопрос: Параллельно с Telegram или Feishu? Да — отдельный канал; не пропускайте multi-channel приёмку.
Вопрос: Mac VPS vs локальный Mac? 7×24 и стабильный reconnect: Mac VPS; ноутбук в sleep рвёт привязку.
Вопрос: Rescan после upgrade? Часто нет в 2.0.x; скачок с 1.0.x или downgrade OpenClaw — часто да.
Вопрос: Зарубежный регион? Greyscale регионален; тест в целевом регионе; сомнительные обходы App Store не рекомендуются.
11. Заключение
Критерий успеха: greyscale check → стабильный шлюз на 18789 → install CLI → QR → воспроизводимый DM. ClawBot личного WeChat не заменяет WeCom для enterprise compliance, но выигрывает там, где пользователи уже в WeChat. Для 7×24 без потери привязки при sleep выбирайте Mac VPS VPSMAC Apple Silicon с launchd и одним HOME — не ноутбук. Далее: шлюз, развёртывание, audit skills.