Skip to main content
OpenClaw подключается к WeChat через внешний плагин канала @tencent-weixin/openclaw-weixin от Tencent. Статус: внешний плагин, поддерживаемый командой Tencent Weixin. Поддерживаются личные чаты и медиафайлы. Групповые чаты не заявлены в метаданных возможностей плагина (заявлена поддержка только личных чатов).

​
Именование

  • WeChat — название, используемое в пользовательской документации.
  • Weixin — название, используемое в пакете Tencent и идентификаторе плагина.
  • openclaw-weixin — идентификатор канала OpenClaw (weixin и wechat работают как псевдонимы).
  • @tencent-weixin/openclaw-weixin — пакет npm.
Используйте openclaw-weixin в командах CLI и путях конфигурации.

​
Принцип работы

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

​
Установка

Быстрая установка:
Установка вручную:
После установки перезапустите Gateway:

​
Вход

Запустите вход по QR-коду на том же компьютере, где работает Gateway:
Отсканируйте QR-код приложением WeChat на телефоне и подтвердите вход. После успешного сканирования плагин сохраняет токен аккаунта локально. Чтобы добавить ещё один аккаунт WeChat, снова выполните ту же команду входа. При использовании нескольких аккаунтов изолируйте сеансы личных сообщений по аккаунту, каналу и отправителю:

​
Управление доступом

Для личных сообщений используется стандартная модель OpenClaw с сопряжением и списком разрешённых отправителей для плагинов каналов. Разрешите доступ новым отправителям:
Полное описание модели управления доступом см. в разделе Сопряжение.

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

При запуске плагин проверяет версию OpenClaw на хосте. Если плагин сообщает, что ваша версия OpenClaw слишком старая, обновите OpenClaw или установите устаревшую линейку плагина:

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

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

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

Проверьте установку и состояние:
Если канал отображается как установленный, но не подключается, убедитесь, что плагин включён, и выполните перезапуск:
Если после включения WeChat Gateway постоянно перезапускается, обновите OpenClaw и плагин:
Если при запуске сообщается, что установленный пакет плагина requires compiled runtime output for TypeScript entry, пакет npm был опубликован без скомпилированных файлов среды выполнения JavaScript, необходимых OpenClaw. Выполните обновление или переустановку после того, как издатель плагина выпустит исправленный пакет, либо временно отключите или удалите плагин. Временное отключение:

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