Перейти до основного вмісту

​
WeChat

OpenClaw підключається до WeChat через зовнішній Plugin каналу Tencent @tencent-weixin/openclaw-weixin. Статус: зовнішній Plugin. Підтримуються особисті чати та медіа. Групові чати не заявлені в поточних метаданих можливостей Plugin.

​
Назви

  • WeChat — це назва для користувачів у цій документації.
  • Weixin — це назва, яку використовує пакет Tencent і id Plugin.
  • openclaw-weixin — це id каналу 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 реєструє id каналу 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-weixin
openclaw pairing approve openclaw-weixin <CODE>
Повну модель керування доступом див. у Pairing.

​
Сумісність

Plugin перевіряє версію OpenClaw хоста під час запуску.
Лінійка PluginВерсія OpenClawТег npm
2.x>=2026.3.22latest
1.x>=2026.1.0 <2026.3.22legacy
Якщо Plugin повідомляє, що ваша версія OpenClaw застаріла, або оновіть OpenClaw, або встановіть застарілу лінійку Plugin: 
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

​
Sidecar-процес

Plugin WeChat може запускати допоміжну роботу поруч із Gateway, поки він відстежує Tencent iLink API. У задачі #68451 цей допоміжний шлях виявив помилку в загальному очищенні застарілого Gateway в OpenClaw: дочірній процес міг спробувати очистити батьківський процес Gateway, спричиняючи цикли перезапуску в менеджерах процесів, таких як systemd. Поточне очищення під час запуску OpenClaw виключає поточний процес і його предків, тому допоміжний процес каналу не повинен завершувати Gateway, який його запустив. Це виправлення є загальним; це не специфічний для WeChat шлях у ядрі.

​
Усунення неполадок

Перевірте встановлення та статус: 
openclaw plugins list
openclaw channels status --probe
openclaw --version
Якщо канал показується як встановлений, але не підключається, переконайтеся, що Plugin увімкнено, і перезапустіть: 
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
Якщо Gateway неодноразово перезапускається після ввімкнення WeChat, оновіть і OpenClaw, і Plugin: 
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
Тимчасове вимкнення: 
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

​
Пов’язана документація