WeChat

OpenClaw подключается к WeChat через внешний Plugin канала @tencent-weixin/openclaw-weixin от Tencent.

Статус: внешний Plugin. Поддерживаются личные чаты и медиа. Групповые чаты не заявлены в текущих метаданных возможностей Plugin.

Именование

• WeChat — пользовательское название в этой документации.
• Weixin — название, используемое пакетом Tencent и идентификатором Plugin.
• openclaw-weixin — идентификатор канала OpenClaw.
• @tencent-weixin/openclaw-weixin — npm-пакет.

Используйте openclaw-weixin в командах CLI и путях конфигурации.

Как это работает

Код WeChat не находится в основном репозитории OpenClaw. OpenClaw предоставляет общий контракт Plugin канала, а внешний Plugin предоставляет среду выполнения, специфичную для WeChat:

1. openclaw plugins install устанавливает @tencent-weixin/openclaw-weixin.
2. Gateway обнаруживает манифест Plugin и загружает точку входа Plugin.
3. Plugin регистрирует идентификатор канала openclaw-weixin.
4. openclaw channels login --channel openclaw-weixin запускает вход по QR-коду.
5. Plugin сохраняет учетные данные аккаунта в каталоге состояния OpenClaw.
6. Когда Gateway запускается, Plugin запускает монитор Weixin для каждого настроенного аккаунта.
7. Входящие сообщения WeChat нормализуются через контракт канала, направляются выбранному агенту OpenClaw и отправляются обратно через исходящий путь Plugin.

Это разделение важно: ядро OpenClaw должно оставаться независимым от каналов. Вход в WeChat, вызовы Tencent iLink API, выгрузка/загрузка медиа, токены контекста и мониторинг аккаунтов принадлежат внешнему Plugin.

Установка

Быстрая установка:

npx -y @tencent-weixin/openclaw-weixin-cli install

Ручная установка:

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

Перезапустите Gateway после установки:

openclaw gateway restart

Вход

Запустите вход по QR-коду на той же машине, где работает Gateway:

openclaw channels login --channel openclaw-weixin

Отсканируйте QR-код с помощью WeChat на телефоне и подтвердите вход. Plugin сохраняет токен аккаунта локально после успешного сканирования.

Чтобы добавить еще один аккаунт WeChat, снова выполните ту же команду входа. Для нескольких аккаунтов изолируйте сеансы личных сообщений по аккаунту, каналу и отправителю:

openclaw config set session.dmScope per-account-channel-peer

Контроль доступа

Личные сообщения используют обычную модель привязки и списка разрешенных OpenClaw для Plugin каналов.

Одобрите новых отправителей:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

Полную модель контроля доступа см. в разделе Привязка.

Совместимость

Plugin проверяет версию хоста OpenClaw при запуске.

Если Plugin сообщает, что ваша версия OpenClaw слишком старая, либо обновите OpenClaw, либо установите устаревшую линейку Plugin:

openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

Вспомогательный процесс

Plugin WeChat может выполнять вспомогательную работу рядом с Gateway, пока он отслеживает Tencent iLink API. В issue #68451 этот вспомогательный путь выявил ошибку в общей очистке устаревших Gateway в OpenClaw: дочерний процесс мог попытаться очистить родительский процесс Gateway, вызывая циклы перезапуска под менеджерами процессов, такими как systemd.

Текущая очистка при запуске OpenClaw исключает текущий процесс и его предков, поэтому вспомогательный процесс канала не должен завершать Gateway, который его запустил. Это исправление общее; это не путь, специфичный для WeChat, в ядре.

Устранение неполадок

Проверьте установку и статус:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Если канал отображается как установленный, но не подключается, подтвердите, что Plugin включен, и перезапустите:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

Если Gateway многократно перезапускается после включения WeChat, обновите и OpenClaw, и Plugin:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

Если при запуске сообщается, что установленный пакет Plugin requires compiled runtime output for TypeScript entry, npm-пакет был опубликован без скомпилированных файлов среды выполнения JavaScript, необходимых OpenClaw. Обновите/переустановите после того, как издатель Plugin выпустит исправленный пакет, или временно отключите/удалите Plugin.

Временное отключение:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

Связанная документация

• Обзор каналов: Чат-каналы
• Привязка: Привязка
• Маршрутизация каналов: Маршрутизация каналов
• Архитектура Plugin: Архитектура Plugin
• SDK Plugin канала: SDK Plugin канала
• Внешний пакет: @tencent-weixin/openclaw-weixin