Если вы уже запустили 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
| Измерение | 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 засыпает.
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
Проверьте имя пакета и README на npm перед production; если Tencent обновит flags, копируйте команду со страницы деталей плагина.
04 Установка в шесть шагов и QR-привязка
- Обновить WeChat: Настройки → О приложении, выполнить требование плагина, обновить из store при необходимости.
- Открыть Плагины: Настройки → Плагины → WeChat ClawBot → скопировать команду установки.
- Проверить здоровье gateway: запустить status checks; на remote nodes сначала SSH.
- Запустить CLI: вставить
npx -y @tencent-weixin/openclaw-weixin-cli@latest installи ждать QR. - Авторизовать на телефоне: сканировать мобильным WeChat; вы привязываете этот экземпляр gateway, не shared vendor model.
- Проверить канал: подтвердить канал 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.