Tencent WeChat ClawBot 2026:
официальная установка OpenClaw, пороги версий и восемь ограничений

Если вы уже запустили OpenClaw Gateway на Mac, но хотите своего агента внутри WeChat, community-стеки на Wechaty или обратных протоколах несут риск блокировки аккаунта и хрупкое сопровождение. С марта 2026 Tencent поставляет официальный плагин WeChat ClawBot для клиентов 8.0.70+, подключаемый через npx -y @tencent-weixin/openclaw-weixin-cli@latest install на машине, где работает gateway. Эта статья даёт воспроизводимый порядок установки, границы аудита и triage — плюс как держать gateway на bare metal удалённом Mac CALMVPS, пока вы привязываете с телефона.

После прочтения вы поймёте: соответствуют ли ваш WeChat и экземпляр OpenClaw официальным gates; где запускать CLI относительно gateway; и что проверять, когда QR-привязка не удаётся, канал отсутствует в UI или ответы пустые.

01 Почему важен официальный путь ClawBot

Команды редко просят «ещё одного Telegram-бота». Им нужны лёгкие команды в приложении, которое открывают десятки раз в день: исследование, черновики, триггеры skills, короткая автоматизация. Неофициальные мосты ломаются тремя предсказуемыми способами:

  • Риск аккаунта: симулированные клиенты и взлом протокола могут вызвать меры платформы, затрагивающие и деловые контакты.
  • Нет SLA по uptime: login-flow, captcha и изменения upstream API превращаются в полуночные скрипты без SLA вендора.
  • Несовпадение продукта: multi-bot паттерны Telegram плохо ложатся на маршрутизацию WeChat; групповые функции усиливают state-баги.

ClawBot использует систему плагинов Tencent: вы находите его в Настройки → Плагины, запускаете опубликованную CLI на хосте gateway и авторизуетесь QR-сканом с телефона. Трафик всё равно проходит проверку безопасности Tencent — стабильность растёт, но нужно принять модерацию, только личный чат и некоторые лимиты доставки как правила продукта, а не дефекты установки.

Ops-командам стоит задокументировать три линии ответственности до go-live: кто обновляет WeChat на тестовых телефонах, кто ротирует API-ключи моделей на gateway и кто одобряет установку skills с доступом к файловой системе. Без этого раздела первый production-инцидент превращается в взаимные обвинения «WeChat сломался» и «OpenClaw сломался», хотя реальная проблема — неаудированный skill, пишущий вне workspace.

Относитесь к ClawBot как к официальному канальному плагину, а не generic IM SDK: установка быстрая; пороги версий, модерация и размещение gateway — настоящие acceptance-тесты.

02 ClawBot vs Wechaty vs плагин WeCom

Три распространённых пути к OpenClaw из WeChat (2026)
Измерение WeChat ClawBot (официальный) Community Wechaty / протокол Плагин WeCom OpenClaw
Тип аккаунта Личный WeChat на мобильном Разный; enforcement неясен Корпоративные боты WeCom
Compliance Официальный plugin track Высокий риск поломки / бана IT-контролируемые org-политики
Серверные нужды Доступный хост gateway; может быть remote bare metal Часто extra middleware daemons Публичный callback + corp credentials
Форма чата Только личный чат; без групп Некоторые forks с группами (рискованно) Командные уведомления, docs workflows

Индивидуальным разработчикам по умолчанию стоит выбирать ClawBot. Переходите на плагин WeCom, когда нужны org-wide распространение и audit — не оба на одном экспериментальном профиле gateway.

03 Предварительные условия и размещение gateway

ClawBot привязывается к вашему экземпляру OpenClaw — не к generic cloud model внутри WeChat. Перед установкой:

  • Клиент WeChat: iOS обычно требует 8.0.70+; Android gates следуют странице плагина и могут быть gray release по регионам.
  • Устройство: привязка использует мобильный WeChat; desktop WeChat не завершит авторизацию.
  • Хост CLI: запускайте install в shell на Mac, где работает gateway (локально или SSH на CALMVPS bare metal).
  • Сеть: телефон и хост CLI должны завершить QR handshake; разделяйте latency между egress API модели и WeChat.

Топология A: laptop gateway + локальная CLI + QR телефона. Топология B: gateway на арендованном bare metal Mac 24/7, SSH для CLI, тот же QR телефона — лучше, когда laptop засыпает.

install-wechat-clawbot.sh
npx -y @tencent-weixin/openclaw-weixin-cli@latest install

Проверьте имя пакета и README на npm перед production; если Tencent обновит flags, копируйте команду со страницы деталей плагина.

04 Установка в шесть шагов и QR-привязка

  1. Обновить WeChat: Настройки → О приложении, выполнить требование плагина, обновить из store при необходимости.
  2. Открыть Плагины: Настройки → Плагины → WeChat ClawBot → скопировать команду установки.
  3. Проверить здоровье gateway: запустить status checks; на remote nodes сначала SSH.
  4. Запустить CLI: вставить npx -y @tencent-weixin/openclaw-weixin-cli@latest install и ждать QR.
  5. Авторизовать на телефоне: сканировать мобильным WeChat; вы привязываете этот экземпляр gateway, не shared vendor model.
  6. Проверить канал: подтвердить канал WeChat online в control UI; если отсутствует — one-click update и hard refresh браузера (Cmd+Shift+R), перезапуск gateway при необходимости, повторный scan.

Входящие сообщения маршрутизируются через resolveAgentRoute OpenClaw по channel, accountId и peer. Для большинства индивидуальных пользователей один аккаунт WeChat + primary agent с внутренней делегацией лучше, чем переключение agents в одном thread.

Playbook B — несколько аккаунтов WeChat на разных agents — поддерживается, когда нужны жёсткие границы (например «личный ассистент» vs «ops bot»). Каждый аккаунт получает свой peer context; не ожидайте Telegram-style multi-bot tabs в одном чате. После привязки отправьте безвредный ping («кто ты / какая модель»), чтобы подтвердить routing, прежде чем включать skills с shell или browser.

Если gateway на CALMVPS bare metal, запускайте CLI через SSH в той же user session, которая владеет launchd для ai.openclaw.gateway. Закрытие laptop не должно останавливать доступность WeChat — только здоровье gateway.

05 Восемь ограничений и матрица triage

  • Только личный чат: не ожидайте group @mentions; broadcast через WeCom или другие каналы.
  • Модерация контента: Tencent фильтрует чувствительные домены (например DeFi, wallets, crypto wording) — пустые ответы могут быть policy, а не сбой модели.
  • Запасной аккаунт: привяжите вторичный WeChat, когда OpenClaw имеет широкие system permissions.
  • Границы workspace: ужесточите writable paths и approvals system.run.
  • Idle sessions: длительная тишина может потребовать новое user message для пробуждения канала.
  • Android gray release: отсутствующая запись плагина обычно означает version/region, а не «установить сильнее».
  • Доставка файлов: обработанные артефакты могут потребовать email или drive, а не вложения WeChat.
  • Отсутствующая строка канала: выровняйте версии gateway/CLI, проверьте logs после UI refresh.
Типичные симптомы и первые исправления
Симптом Проверить сначала Первое исправление
Нет ClawBot в Плагинах Версия WeChat / gray release Upgrade; ждать официальный rollout
QR готов, gateway offline CLI не на хосте gateway SSH на remote Mac, rerun install, restart gateway
Усечённые ответы Keywords модерации Переформулировать prompts; избегать blocked topics
Нет строки WeChat в UI Устаревший build OpenClaw One-click update + hard refresh

При отладке «тихих сбоев» захватывайте gateway logs и точную user utterance. Модерация часто возвращает пустые bodies без stack trace; тот же prompt на Telegram или Discord доказывает, что model path в порядке, а WeChat channel отфильтрован.

Статья разработчика Tencent документирует официальную timeline ClawBot и скриншоты — откройте ссылку после публикации, чтобы подтвердить, что шаги не изменились.

Официальный WeChat ClawBot: одна команда подключает OpenClaw

06 Gateway на bare metal Mac и sizing

  • Plugin gate WeChat (iOS): публичные tutorials указывают 8.0.70+.
  • Официальный CLI package: @tencent-weixin/openclaw-weixin-cli через npx … install.
  • Default gateway control port: 18789 (как в remote dual-machine docs).
  • Remote sizing: multi-channel + cron + WeChat entry: начинайте с M4 24GB; тяжёлые local models или skill trials: M4 Pro; рост logs: 1TB/2TB до CPU upgrades.

Gateway на спящем laptop ломает 24/7 доступность WeChat и token hygiene. Generic Linux VPS не имеет macOS toolchain и TCC-related node workflows. Shared virtual Mac farm может ограничивать custom launch agents или disk IO — нормально для demos, больно, когда WeChat — ваш on-call pager.

Reference workflow: gateway + WeChat channel на CALMVPS Singapore monthly M4 24GB node; local MacBook остаётся Remote node для screen capture и Xcode side tasks; burst compile jobs на weekly parallel worker без касания gateway tokens. WeChat sessions остаются на hub; build spikes поглощает worker.

Командам, которым нужны стабильный gateway, официальный WeChat entry и воспроизводимый triage, CALMVPS multi-region bare metal Mac обычно лучший хост: dedicated Apple Silicon, доставка ~120s, daily/weekly parallel workers для build spikes без upgrade hub. См. страницу тарифов CALMVPS.