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.

Схема: шлюз OpenClaw на Mac VPS подключает Tencent WeChat ClawBot как личный IM-канал

Содержание

1. Боли: нет ClawBot, версия, QR и disconnect

Личный WeChat принципиально отличается от корпоративного WeChat (WeCom): Tencent контролирует greyscale-раскатку, версию протокола и egress данных. Четыре паттерна доминируют в тикетах поддержки весной 2026.

  1. Нет пункта ClawBot: клиент вне greyscale — нет меню плагина, CLI установлен, но QR не появляется. Ждать или тестировать более новое устройство; не крутить шлюз.
  2. Плагин отказывается загружаться: OpenClaw ниже 2026.3.22 или неверная major-линия openclaw-weixin; в логах mismatch версий, а не сеть.
  3. Сбой QR-скана: шлюз не на 18789, firewall или базовый smoke никогда не был зелёным — телефон не достигает VPS.
  4. Только приём, без отправки: 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 шлюза.

openclaw doctor
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

  1. Принять базу OpenClaw: doctor зелёный, 18789 слушает, echo provider — без WeChat.
  2. CLI one-click: npx -y @tencent-weixin/openclaw-weixin-cli install; записать dist-tag и путь плагина в логах.
  3. Ручной fallback: при сбое CLI — openclaw plugins install @tencent-weixin/openclaw-weixin или openclaw channels login weixin.
  4. Сканировать QR: открыть ClawBot на телефоне, сканировать QR в терминале или dashboard — VPS должен быть достижим (Tailscale/VPN при необходимости).
  5. Restart шлюза: openclaw gateway restart или reload launchctl; снова gateway status.
  6. Приёмка DM: отправить и получить в личном чате; JSONL: channelId и Delivery.
  7. Reconnect 7×24: симулировать reboot, написать после 24 ч без активности; triage ниже при обрыве.
npx -y @tencent-weixin/openclaw-weixin-cli install
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.