npx -y @tencent-weixin/openclaw-weixin-cli@latest install, отсканировать QR — без Wechaty и серых мостов. Ниже сравнение рисков, порог WeChat 8.0.70 и readiness Gateway, шесть шагов и три жёстких ориентира, ограничения личного чата, правило 24 часов и модерация, и почему закрытый ноутбук — плохой хост ClawBot, а выделенный облачный Mac KVMNODE с launchd — производственный стандарт. Сверяйтесь с круглосуточным OpenClaw, чеклистом установки, официальным install-daemon, диагностической лестницей.
2026 WeChat ClawBot и community-мосты: что меняет официальный плагин
OpenClaw долго подключался через Telegram, Discord и Slack; командам в Китае приходилось использовать Wechaty, iPad-протоколы и неофициальные webhook. Общие проблемы: протокол ломается без предупреждения, возможна блокировка аккаунта, поддержка на одном разработчике. В конце марта 2026 Tencent выпускает плагин «WeChat ClawBot» и npm-scope @tencent-weixin/openclaw-weixin-cli — QR-привязка к работающему OpenClaw Gateway становится штатным продуктовым сценарием.
ClawBot — не встроенная LLM WeChat, а подключение вашего настроенного OpenClaw Agent (персона, MEMORY, Skills, маршрутизация моделей) к окну чата в списке контактов. Сообщения идут через клиент WeChat; инференс и инструменты остаются на хосте Gateway. Tencent проверяет контент на соответствие, но не хостит вашу модель. При сбоях разделяйте канал WeChat, Gateway и API модели — не сводите всё к «WeChat сломан».
Соответствие протоколу: официальный плагин вместо мостов с риском блокировки.
Узкая установка: одна команда npx генерирует QR, без своего middleware.
Возможности OpenClaw сохраняются: в WeChat вы говорите с Agent, а не с фиксированной моделью вендора.
Ясные продуктовые границы: сейчас личный чат; группы и enterprise — через плагин WeCom.
Эксплуатация у вас: Gateway offline, 18789 не healthy или нет token launchd — WeChat показывает только сбой отправки или задержку.
Без наблюдаемого daemon Gateway сначала завершите install-daemon, затем ClawBot — иначе первое сообщение после скана зависает на «Gateway не слушает». Зафиксируйте в тикете версии плагина, CLI-пакета и openclaw.
Предусловия: версия WeChat, readiness OpenClaw и ключ модели
Примерно половина сбоев ClawBot — из-за устаревшего клиента WeChat, вторая — из-за Gateway не ready по факту. Таблица собирает поля для дежурства. Проверьте исходящую пропускную способность и задержку npm registry — timeout npx маскируется под поломку плагина.
| Проверка | Требование | Типичный симптом при невыполнении |
|---|---|---|
| Версия WeChat | iOS 8.0.70+ / Android 8.0.69+, ClawBot в Настройки→Плагины | Нет пункта или «версия слишком низкая» при скане |
| OpenClaw Gateway | openclaw gateway status --deep ready, 18789 один listener | Скан OK, нет ответа или RPC timeout |
| Node / CLI | Node 22 как в install.sh, which openclaw одинаков в SSH и launchd | Install находит неверный Gateway |
| API модели | Минимум один валидный upstream-ключ в openclaw.json | WeChat шлёт/принимает, ответ пустой или 401 |
| Исходящая сеть | Хост достигает API модели и npm registry | npx падает или QR истекает |
Сначала зелёный Gateway в терминале, потом плагин WeChat — обратный порядок смешивает все причины.
На выделенном облачном Mac KVMNODE: каталог состояния не в iCloud и не в team-sync, иначе прерывистые ошибки записи БД выглядят как случайные обрывы ClawBot. Token: launchd token и лестница L2 — не переустанавливайте WeChat первым. Если ключ модели в переменных окружения, выровняйте EnvironmentVariables plist и интерактивный SSH.
Шесть шагов: плагин, QR-привязка и приёмка канала
Обновить WeChat: Я → Настройки → О WeChat, проверить версию, вернуться к Плагинам.
Включить ClawBot: Настройки → Плагины → «WeChat ClawBot» → прочитать инструкцию.
На хосте Gateway: npx -y @tencent-weixin/openclaw-weixin-cli@latest install в той же SSH-сессии, что OpenClaw.
Сканировать QR в терминале, подтвердить на телефоне; QR короткоживущий — повторить шаг 03.
Тестовая фраза в чате ClawBot, сверить логи Gateway и openclaw channels probe.
После перезапуска Gateway отправить снова: launchd должен держать канал; версии и timestamps в тикет.
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH" openclaw gateway status --deep npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw gateway restart openclaw channels probe 2>/dev/null || true
Привязку выполняйте на хосте, где реально работает Gateway. OpenClaw на узле KVMNODE в Сингапуре и npx на локальном ноутбуке направят QR на неверный инстанс. SSH на облачный Mac или ssh user@host 'npx ...'. Приложите строки логов Gateway с timestamp первого сообщения WeChat — отделите задержку канала от задержки модели.
Личный чат, несколько Agent и WeCom: выбор без путаницы
Документация и практика: ClawBot рассчитан на личный чат, не на @-бота в группе WeChat тем же плагином. Вход использует resolveAgentRoute по channel + accountId + peer — отдельный контекст на пару; частая смена Agent в одном диалоге ломает state machine.
| Модель | Назначение | Замечание |
|---|---|---|
| Один WeChat + главный Agent | Ежедневный ассистент | Одно окно, Skills маршрутизируют внутри |
| Несколько WeChat, по Agent | Жёсткое разделение ролей | Несколько аккаунтов онлайн, отдельные сканы |
| Плагин OpenClaw WeCom | Командные боты, документы | Параллельно ClawBot, не замена |
Групповые боты, app-сообщения и Doc API — через официальный плагин OpenClaw WeCom, не через личный ClawBot. Оба канала могут висеть на одном Gateway — явный routing в openclaw.json. Ограничьте Skills с чувствительным выводом на канале WeChat, если модерация блокирует.
Подводные камни, порядок triage и постоянный облачный Mac
QR истёк: QR в терминале живёт минуты — новый npx, не переиспользуйте скриншот.Правило 24 ч: долгая неактивность может отбрасывать проактивные push — формат «вопрос-ответ», не маркетинговая рассылка.Модерация: WeChat блокирует при нарушении — правьте промпты и вывод инструментов в OpenClaw, не перепривязывайте в цикле.Сон Gateway: закрытый ноутбук рвёт ClawBot как Telegram — заметнее, потому что WeChat — ежедневный вход.
Официальный CLI: @tencent-weixin/openclaw-weixin-cli, без поддельных npm-пакетов.
Порт зондирования по умолчанию: 18789 как в чеклисте установки.
Порог WeChat: 8.0.70 iOS / 8.0.69 Android (март 2026), затем открыть плагин.
Triage: gateway status --deep → API модели → npx install rescan → логи Gateway → переустановка WeChat последней. При channels 401 или split brain сначала выравнивание CLI. В тикете разделяйте «ошибка отправки WeChat» и «Gateway не отвечает».
| Хост | Опыт ClawBot | Вывод для эксплуатации |
|---|---|---|
| Закрытый ноутбук | Сон обрывает, привязка недолговечна | Только эксперимент |
| NAS / слабый VPS | Node и disk IO нестабильны | Свой мониторинг, вне Apple-стека |
| Выделенный облачный Mac KVMNODE | launchd + выбор региона Git/модели | WeChat 7×24 в продакшене |
Если на том же облачном Mac параллельно iOS CI и OpenClaw, 16 ГБ unified memory под xcodebuild и Gateway может замедлять ответы WeChat без обрыва канала — M4 Pro или split пула вместо повторных сканов. Apple Silicon делит память между Gateway и нагрузкой Metal — события memory pressure коррелируют с медленными ответами. Для аудируемого WeChat 7×24 с Gateway на том же хосте типична аренда Mac mini KVMNODE: шесть регионов, выделенный хост, аренда от дня до месяца, один runbook для 18789 и launchd. Цены — страница цен, гайды — центр помощи, заказ — оформить заказ.