WeChat

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

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

Назви

• WeChat — назва для користувачів у цій документації.
• Weixin — назва, яку використовує пакет Tencent і id Plugin.
• OmeniaClaw-weixin — id каналу OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin — npm-пакет.

Використовуйте OmeniaClaw-weixin у командах CLI і шляхах конфігурації.

Як це працює

Код WeChat не міститься в основному репозиторії OmeniaClaw. OmeniaClaw надає загальний контракт канального Plugin, а зовнішній Plugin надає специфічне для WeChat середовище виконання:

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

Це розділення важливе: ядро OmeniaClaw має залишатися незалежним від каналів. Вхід у WeChat, виклики Tencent iLink API, завантаження й отримання медіа, токени контексту та моніторинг облікових записів належать зовнішньому Plugin.

Встановлення

Швидке встановлення:

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

Ручне встановлення:

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

Перезапустіть Gateway після встановлення:

OmeniaClaw gateway restart

Вхід

Запустіть вхід за QR-кодом на тій самій машині, де працює Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

Відскануйте QR-код у WeChat на телефоні й підтвердьте вхід. Plugin зберігає токен облікового запису локально після успішного сканування.

Щоб додати інший обліковий запис WeChat, знову виконайте ту саму команду входу. Для кількох облікових записів ізолюйте сеанси прямих повідомлень за обліковим записом, каналом і відправником:

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

Керування доступом

Прямі повідомлення використовують звичайну модель сполучення OmeniaClaw і список дозволених для канальних Plugin.

Схваліть нових відправників:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

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

Сумісність

Plugin перевіряє версію хоста OmeniaClaw під час запуску.

Якщо Plugin повідомляє, що ваша версія OmeniaClaw застаріла, оновіть OmeniaClaw або встановіть legacy-лінію Plugin:

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

Процес sidecar

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

Поточне очищення під час запуску OmeniaClaw виключає поточний процес і його предків, тому допоміжний процес каналу не повинен завершувати Gateway, який його запустив. Це виправлення загальне; це не специфічний для WeChat шлях у ядрі.

Усунення несправностей

Перевірте встановлення і статус:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Якщо канал відображається як встановлений, але не підключається, підтвердьте, що Plugin увімкнено, і перезапустіть:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

Якщо Gateway багаторазово перезапускається після ввімкнення WeChat, оновіть і OmeniaClaw, і Plugin:

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

Якщо під час запуску повідомляється, що встановлений пакет Plugin requires compiled runtime output for TypeScript entry, npm-пакет було опубліковано без скомпільованих файлів середовища виконання JavaScript, потрібних OmeniaClaw. Оновіть або перевстановіть після того, як видавець Plugin випустить виправлений пакет, або тимчасово вимкніть чи видаліть Plugin.

Тимчасове вимкнення:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

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

• Огляд каналів: Канали чатів
• Сполучення: Сполучення
• Маршрутизація каналів: Маршрутизація каналів
• Архітектура Plugin: Архітектура Plugin
• SDK канального Plugin: SDK канального Plugin
• Зовнішній пакет: @tencent-weixin/OmeniaClaw-weixin