2026 WECHAT
CLAWBOT_
GATEWAY_
BIND_RUNBOOK.

Нужен OpenClaw в личном WeChat — отделяйте официальный плагин ClawBot Tencent от серых мостов. С марта 2026 в npm лежит @tencent-weixin/openclaw-weixin-cli; после включения в WeChat → Настройки → Плагины — QR-привязка к Gateway на 127.0.0.1:18789. Ниже: префлайт, матрица путей, шесть шагов, риски, кейс, числовые SLO с упором на WebSocket-канал, launchd и удалённый Apple Silicon (Metal полезен для ClawHub/skills, но DM живёт или умирает на uptime Gateway). Телефон + gray rollout на стороне WeChat; на сервере — Gateway 7×24. MacBook в сон = обрыв — эталонная привязка на удалённом Mac mini под launchd.

1. ClawBot vs серые мосты

ClawBot — официальный plugin-path WeChat для OpenClaw через @tencent-weixin/openclaw-weixin, не scraped Web. Фокус — DM, не WeCom. Серые мосты — краткий выигрыш, риск бана и смены протокола. Прод: канал Tencent + Gateway на железе с openclaw gateway status == healthy 24/7 — локальный always-on Mac или удалённый узел Apple Silicon с SSH и пробами /health.

2. Префлайт (пять gate)

Gate A: openclaw --version ≥ 2026.3.22, openclaw doctor. Gate B: Node.js 22+, PATH npm. Gate C: WeChat ≥ 8.0.70. Gate D: ClawBot в списке плагинов — нет пункта = gray, не подменяйте неофициальным CLI. Gate E: openclaw gateway status и curl -m 3 http://127.0.0.1:18789/health < 2 с до QR. На удалённом Mac: туннель/SSH, firewall 18789 только loopback или Tailscale — не светите Gateway в интернет.

3. Матрица решений

Сценарий	Путь	Заметка
Первая привязка в лабе	npx @tencent-weixin/openclaw-weixin-cli install	Быстрый QR
Прод с change-ticket	plugins install + config вручную	Откат по git config
npm timeout	mirror registry	Не сканируйте до enabled plugin
Тишина после upgrade	plugins.entries.openclaw-weixin.enabled	Ключи сдвинулись с 2026.3.22+
DM отваливается при sleep ноутбука	Re-bind на удалённом Gateway	Привязка к endpoint скана

4. Runbook — шесть шагов

Шаг 1 Включить ClawBot в WeChat

Обновить клиент → Настройки → Плагины → ClawBot ON. Нет пункта — ждите gray, версию клиента в тикет.

Шаг 2 Доказать, что Gateway жив

openclaw gateway status, curl -m 3 http://127.0.0.1:18789/health на bind-host. Удалённый Mac: те же команды по SSH, смотрите launchd plist и логи ~/.openclaw/logs.

Шаг 3 Поставить канал

Шаг 4 Скан QR сразу

QR TTL короткий; повторите шаг 3. Скриншот часовой давности — мусор.

Шаг 5 Проверить send/receive

Тестовый DM; параллельно openclaw channels status --probe. Inbound OK, outbound fail — сначала API-ключи модели, не WeChat.

Шаг 6 Soak 30 минут на удалённом эталоне

Golden host Apple Silicon, все probes green 30 мин — только потом продакшен-аккаунт WeChat. Сверка с Gateway не найден после install.

5. Матрица подводных камней

Зона	Риск	Митигация
Scope	DM-first; группы урезаны	Не вешайте support-группы
Аккаунт	Основной WeChat + exec в Agent	Второй аккаунт; sandbox exec
Трафик	Через инфраструктуру Tencent	Без агрессивных автоответов
Upgrade	Порядок загрузки plugins	doctor + probe до/после
Gateway uptime	Offline = тишина в WeChat	launchd на удалённом Mac, не sleep

6. Слоистый troubleshooting

Нет ClawBot в списке — gray. Нет контакта после scan — не рестартнули Gateway или enabled false. Только inbound — firewall :18789, флаг plugin. npx падает — mirror. После upgrade — openclaw doctor --fix, gateway restart --force --wait; не трогайте ~/.openclaw без бэкапа. WebSocket обрыв при sleep — не баг API, а локальный процесс Gateway.

7. Кейс: QR OK, тишина в дороге

Команда копала Tencent API. В логах — death websocket channel при system sleep. Re-bind на 24/7 удалённом узле вернул SLA. Вывод: ClawBot привязан к endpoint Gateway, который был online в момент scan — смена хоста = новый QR и запись в ops runbook.

8. Metal, Gateway и удалённый Mac

OpenClaw на VPS Linux возможен, но канал WeChat = процесс Gateway + plugin, не GPU. Apple Silicon на удалённом Mac даёт: стабильный launchd, unified memory под тяжёлые skills (FFmpeg VideoToolbox, MLX-инференс), и тот же Metal-стек, что в Blender Cycles Metal — для мультимедийных Agent-навыков после приёмки DM. 30-минутное окно probes на удалённом эталоне — обязательный gate перед прод-трафиком WeChat. MACGPU: изолированный диск, snapshot rollback, replay логов Gateway — без снятия с вас ответственности за аккаунты WeChat.

9. Числовые пороги

WeChat < 8.0.70 — upgrade. OpenClaw < 2026.3.22 — upgrade + doctor. Probes красные 5 мин после scan — не в прод. Три раунда DM с контекстом — потом file-writing Skills. Любая смена Gateway — 30 мин green probes на удалённом хосте.

10. FAQ

ClawBot vs WeCom? Другой channel и креды. Mac обязателен? Нет для бинарника OpenClaw; для этого runbook — удалённый Mac как golden path. QR протух? Повтор install/login. Группы? Планируйте DM. Metal помогает DM? Нет напрямую — помогает не убивать Gateway тяжёлыми skills на том же узле.