Официальный WeChat-плагин · QR-привязка · лимиты личного чата · Gateway 24/7
Вы хотите подключить официальный WeChat ClawBot к работающему Gateway OpenClaw — и сталкиваетесь с просроченным QR, отсутствием grey-плагина или молчанием после перезапуска Gateway. Этот материал для разработчиков, которые планируют использовать npx @tencent-weixin/openclaw-weixin-cli в production: сначала архитектура (официальный плагин vs неофициальный мост), затем предусловия и разделение аккаунтов, далее шестишаговый runbook установки, привязки и приёмки. Дополнительно: чеклист установки Gateway и hardening multi-channel.
В 2026 Tencent выпускает официальный плагин OpenClaw, подключающий WeChat к той же control plane, что Telegram, Discord и Slack. Адаптер канала живёт в Gateway; skills, routing моделей и вызовы инструментов не меняются. Это отличает ClawBot от неофициальных Web WeChat-мостов с риском бана, хрупким протоколом и без нормального восстановления сессии.
Пакет @tencent-weixin/openclaw-weixin-cli инкапсулирует установку плагина, генерацию QR и первую привязку. OpenClaw управляет heartbeat, webhook и передачей в agent. Если Telegram уже работает, WeChat добавляется вторым каналом — не вместо hardening Gateway. Тексты чатов, метаданные контактов и логи agent могут содержать персональные данные; фиксируйте место обработки и retention на выделенном узле.
Официальный плагин: поддержка Tencent, привязка к версиям OpenClaw; обновления через npm или openclaw plugins.
Неофициальный мост: высокий риск блокировки — только для экспериментов.
Единый Gateway: один Gateway, несколько каналов; WeChat делит backend модели с Telegram.
Grey-release: клиент WeChat и плагин часто доступны лишь выбранным аккаунтам.
Фокус на личный чат: групповой бот как в Telegram в 2026 обычно вне scope — учитывайте в архитектуре.
Перед npx пройдите четыре gate. Отсутствие grey — главный stopper; runbook не заменит аккаунт без доступа к плагину.
| Gate | Проверка | Типичный итог |
|---|---|---|
| Клиент WeChat | Актуальная версия, виден grey-плагин | Без grey: QR не появится или привязка оборвётся |
| OpenClaw | Node 22.14+, openclaw gateway status зелёный | Gateway должен работать до QR, не после |
| Аккаунты | Realname vs тестовый субаккаунт | Prod: отдельный аккаунт; разделите личное и рабочее |
| Хост 24/7 | Ноутбук vs cloud Mac / VPS | Сон ноута убивает callbacks — см. постоянный cloud Mac |
WeChat ClawBot — не «только телефон»: хост Gateway должен оставаться доступным, пока вы ждёте ответы.
Для multi-channel команд выделите тестовый WeChat-аккаунт, не смешивая его с личными чатами. Production Gateway размещайте на планируемом узле 24/7; изоляция Docker — Compose baseline.
Два пути ведут к одной цели; зафиксируйте один на среду в change ticket.
One-shot npx: npx @tencent-weixin/openclaw-weixin-cli install — ставит плагин, запускает мастер привязки, показывает QR.
Ручной шаг 1: openclaw plugins install @tencent-weixin/openclaw-weixin
Ручной шаг 2: openclaw gateway restart
Ручной шаг 3: openclaw channels add weixin
Ручной шаг 4: привязать QR и подтвердить первый контакт в WeChat
openclaw gateway status npx @tencent-weixin/openclaw-weixin-cli install openclaw gateway restart openclaw logs --follow
Подсказка: при медленных npm-зеркалах или корпоративном proxy сначала проверьте registry — полуустановленный плагин даёт симптом «Gateway зелёный, канал мёртв».
QR: следите за окном валидности; при timeout генерируйте новый, не перезапускайте Gateway хаотично.
Скан в WeChat: подтвердите официальный контакт ClawBot; без grey-плагина flow останавливается здесь.
Контакт виден: новая строка чата; иначе — логи Gateway и версия плагина.
Echo roundtrip: короткое сообщение, ответ в SLA (секунды — минуты по backend).
Тест restart: openclaw gateway restart, повторное сообщение — soft restart должен сохранить сессию.
| Аспект | WeChat ClawBot | Telegram |
|---|---|---|
| Привязка | QR + grey-плагин | Token BotFather |
| Тип чата | Преимущественно личный | Группы и каналы |
| Файлы | Лимиты продукта | Bot API гибче |
| Callback | Gateway 24/7 | Те же требования |
| Симптом | Сначала проверить | Типичное действие |
|---|---|---|
| QR истёк | Окно времени, закрытый терминал | Новый QR; screen для remote |
| Нет входящих | Gateway down, firewall, версия плагина | openclaw gateway status |
| Тишина после restart | Персистентность сессии | Разделить soft restart и rebuild; re-bind |
| npm / npx ошибка | Mirror, proxy, Node | Сменить registry; ручной путь |
| Нужен групповой чат | Scope 2026 | Не поддерживается — другой канал |
Внимание: не меняйте в одном ticket re-bind WeChat, backend модели и webhook Telegram одновременно — bisect невозможен.
WeChat ClawBot в production — Gateway и plugin на изолированном хосте или в контейнере, мониторинг latency канала, runbook re-bind после deploy. Читайте логи в три фазы: plugin (привязка, QR), Gateway (routing, heartbeat), model backend (timeout, context).
Gateway на ноутбуке ломается от сна и NAT; IM-каналы требуют дисциплины 24/7 как Telegram. Для выделенной ёмкости и стабильных callbacks аренда cloud Mac Mini VpsMesh co-locate каналы WeChat и Telegram с hardening multi-channel. Цены аренды, Центр помощи, Оформить заказ.
Да. Оба канала на одном Gateway OpenClaw; skills и routing модели общие. Нужны Gateway 24/7 и доступные webhooks — см. hardening multi-channel.
Обычно: истёк QR, Gateway был offline при скане, нет grey-плагина или firewall. Сгенерируйте новый QR, проверьте openclaw gateway status — не меняйте сначала backend модели.
Soft restart должен сохранить сессию WeChat; после rebuild образа может понадобиться re-bind. Для постоянной работы перенесите Gateway на удалённый Mac — гайд 24/7, цены аренды.