2026 Tencent WeChat ClawBot: установка и меры предосторожности — CLI в один шаг, матрица latest/legacy и runbook границ безопасности

около 18 мин чтения · MACCOME

Если OpenClaw Gateway уже работает локально или в облаке и нужен личный чат WeChat (официальный канал Tencent ClawBot / openclaw-weixin), материал закрывает: установку через @tencent-weixin/openclaw-weixin-cli и ручной путь; матрицу хоста OpenClaw × плагин 2.0.x / legacy; границы Public Beta (личный чат, файлы, окно 24 ч, compliance, каталоги) и триаж по симптомам. Дополняет гид установки на три платформы — здесь только канал WeChat.

Шесть типичных ошибок перед сканированием QR (сначала механизм)

  1. QR без постоянного Gateway : сон ноутбука → канал падает, винят «сломанный плагин WeChat».
  2. Несовпадение хоста и плагина : OpenClaw ≥ 2026.3.22 с линией плагина 1.0.x → ошибка совместимости при старте.
  3. Основной WeChat для prod Agent : контент через Tencent ; фильтры и риск аккаунта вне контроля.
  4. Слишком широкий рабочий каталог : «разбери рабочий стол» в WeChat может затронуть весь профиль.
  5. Цель — группы : сейчас личный чат ; @ в группе и файлы — другая политика.
  6. Сообщения есть, tools молчат : часто tools.profile, не канал WeChat — runbook tools.

Tencent ведёт openclaw-weixin на GitHub и публикует @tencent-weixin/openclaw-weixin-cli в npm (активные обновления, май 2026). Установщик читает openclaw --version, выбирает dist-tag latest (2.0.x) или legacy (1.0.x), затем openclaw plugins install и QR — воспроизводимее, чем угадывать версию вручную.

Уже есть в блоге Этот материал Не дублируем
Установка три платформы Плагин WeChat + QR Первая установка OpenClaw
Сопровождение обновления Выравнивание плагина после upgrade gateway probe / ACP полностью
Триаж tools.profile WeChat OK, tools KO → ссылка Отдельный allowlist
SSH постоянный Gateway Канал WeChat 7×24 на питании 24/7 LocalForward по шагам

Предусловия: Gateway, клиент WeChat и сеть

Перед CLI отметьте:

  • OpenClaw Gateway запущен, openclaw gateway status healthy ; на remote — один авторитетный Gateway.
  • Node : как в runbook 2026, Node 24 ; старые версии → расхождение CLI/Gateway.
  • Клиент WeChat : iOS 8.0.70+, Android 8.0.69+ (по доке Tencent ; обновить перед QR).
  • Исходящая сеть : npm и handshake Tencent ; корпоративный proxy в env.
  • Окно изменений : перед openclaw updatebackup create (см. сопровождение обновления).
dist-tag плагина openclaw-weixin Рекомендуемый хост OpenClaw
latest 2.0.x ≥ 2026.3.22
legacy 1.0.x ≥ 2026.1.0 且 < 2026.3.22

Установка в один шаг: openclaw-weixin-cli

На машине с openclaw CLI (тот же хост, что Gateway, или SSH на удалённый Mac):

bash
openclaw --version
openclaw gateway status

npx -y @tencent-weixin/openclaw-weixin-cli@latest install
# Типично: версия хоста → latest/legacy → plugins install → QR → gateway restart

openclaw gateway restart
openclaw channels status --probe

После QR — тест через «Передачу файлов» или отдельный аккаунт. Если канала «WeChat» нет в Control UI: обновить консоль и жёстко обновить кэш браузера (Windows Ctrl+F5 ; macOS Cmd+Shift+R).

Ручная установка (CI / без TTY)

Без интерактивного QR (чистый SSH):

bash
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true

openclaw channels login --channel openclaw-weixin

openclaw gateway restart
info

Несколько аккаунтов: каждый channels login добавляет запись. При параллельной работе: openclaw config set session.dmScope per-account-channel-peer — без смешения сессий.

Меры предосторожности: границы продукта, compliance, права (обязательно)

Ограничения Public Beta и полевые данные — в team runbook заранее:

  • Сначала личный чат : не планировать «бот группы WeChat» вместо WeCom ; группы могут меняться.
  • Файлы только входящие : приём для Agent ; крупные файлы «назад» в чат ненадёжны.
  • Окно 24 ч : после долгого молчания push может отбрасываться ; Q/A, не маркетинг без присмотра.
  • Один аккаунт — одна инстанция : один WeChat обычно к одному OpenClaw ; один Gateway — несколько залогиненных WeChat.
  • Контент и compliance : через инфра Tencent ; фильтры finance/crypto ; право менять или останавливать сервис.
  • Минимальные права каталога : пути в AGENTS.md ; не отдавать весь $HOME tools из WeChat.
warning

Безопасность аккаунта: отдельный вторичный WeChat для ClawBot, изолирован от основного, оплаты и рабочих групп ; prod-секреты не в промптах, доступных WeChat.

Симптом Первый подозреваемый Первое действие
Нет канала WeChat в UI Кэш / плагин выкл. Обновить + hard refresh ; plugins.entries.openclaw-weixin.enabled
QR нет или истёк TTY / часы channels login --channel openclaw-weixin ; NTP
Принимает, не отвечает Gateway zombie / маршрут модели gateway status + doctor ; без сна ноутбука
Чат OK, tools нет tools.profile Runbook tools.profile, не переустанавливать WeChat по кругу
Канал пропал после upgrade Несовпадение версий Повтор openclaw-weixin-cli install или pin legacy/latest

Runbook из шести шагов: плагин — QR — приёмка — ужесточение

  1. Отпечаток версий : openclaw --version, версия плагина, форма Gateway (local / Docker / remote Mac).
  2. Backup : prod → openclaw backup create до потери QR/pairing.
  3. Установка плагина : сначала openclaw-weixin-cli install ; иначе ручной plugins install.
  4. QR и зонд : отдельный аккаунт → тест в «Передачу файлов» → входящие в логах Gateway.
  5. Ужесточение : каталоги tools ; tools.profile coding или full по политике.
  6. 7×24 : Gateway на хосте с питанием 24/7 ; ноутбук только SSH к Control UI (SSH runbook).

Три метрики для тикета изменений

  • Доступность канала : доля входящих WeChat за 7 д (без отбрасываний из-за 24 ч молчания), цель ≥99 % при Gateway 24/7.
  • Несовпадения плагина : upgrade OpenClaw без совместимого установщика — цель prod 0.
  • Изоляция аккаунтов : доля основного WeChat среди привязанных — цель 0.

Итог: WeChat — вход, стабильный хост — основа

QR только на ноутбуке со сном превращает автоматизацию в «иногда отвечает». Образы Lighthouse Tencent упрощают первую установку OpenClaw, но если Gateway следует локальному питанию, SLA WeChat не аудируется.

Для личного чата 7×24, тикетируемых изменений, ясных границ каталогов фиксация OpenClaw + openclaw-weixin на удалённых Mac MACCOME (M4 / M4 Pro) в шести регионах часто дешевле, чем QR и probe на спящем ноутбуке: гид по шести регионам + SSH runbook.

FAQ

Канал WeChat пропал после обновления OpenClaw?

Матрица 2.0.x/legacy, затем npx -y @tencent-weixin/openclaw-weixin-cli@latest install ; перед upgrade — backup create. Хост: цены аренды.

Может ли ClawBot подключаться к группам WeChat?

Public Beta: в основном личный чат ; группы не поддерживаются — «Передача файлов» или отдельный аккаунт.

WeChat отвечает, но tools не выполняются?

Проверить tools.profile и overrides agent — runbook tools ; доступ: центр помощи.