WeChat

OmeniaClaw si collega a WeChat tramite il Plugin di canale esterno @tencent-weixin/OmeniaClaw-weixin di Tencent.

Stato: Plugin esterno. Le chat dirette e i media sono supportati. Le chat di gruppo non sono pubblicizzate dai metadati delle capability dell'attuale Plugin.

Denominazione

• WeChat è il nome rivolto agli utenti in questa documentazione.
• Weixin è il nome usato dal pacchetto di Tencent e dall'id del Plugin.
• OmeniaClaw-weixin è l'id del canale OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin è il pacchetto npm.

Usa OmeniaClaw-weixin nei comandi CLI e nei percorsi di configurazione.

Come funziona

Il codice WeChat non risiede nel repository core di OmeniaClaw. OmeniaClaw fornisce il contratto generico del Plugin di canale, e il Plugin esterno fornisce il runtime specifico per WeChat:

1. OmeniaClaw plugins install installa @tencent-weixin/OmeniaClaw-weixin.
2. Il Gateway rileva il manifest del Plugin e carica l'entrypoint del Plugin.
3. Il Plugin registra l'id di canale OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin avvia il login tramite QR.
5. Il Plugin salva le credenziali dell'account nella directory di stato di OmeniaClaw.
6. Quando il Gateway si avvia, il Plugin avvia il suo monitor Weixin per ogni account configurato.
7. I messaggi WeChat in ingresso vengono normalizzati tramite il contratto di canale, instradati all'agente OmeniaClaw selezionato e inviati di nuovo tramite il percorso in uscita del Plugin.

Questa separazione è importante: il core di OmeniaClaw deve rimanere indipendente dal canale. Login WeChat, chiamate all'API Tencent iLink, caricamento/scaricamento dei media, token di contesto e monitoraggio degli account sono di competenza del Plugin esterno.

Installazione

Installazione rapida:

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

Installazione manuale:

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

Riavvia il Gateway dopo l'installazione:

OmeniaClaw gateway restart

Login

Esegui il login tramite QR sulla stessa macchina su cui è in esecuzione il Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

Scansiona il codice QR con WeChat sul telefono e conferma il login. Il Plugin salva il token dell'account localmente dopo una scansione riuscita.

Per aggiungere un altro account WeChat, esegui di nuovo lo stesso comando di login. Per più account, isola le sessioni di messaggio diretto per account, canale e mittente:

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

Controllo degli accessi

I messaggi diretti usano il normale modello di pairing e allowlist di OmeniaClaw per i Plugin di canale.

Approva i nuovi mittenti:

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

Per il modello completo di controllo degli accessi, consulta Pairing.

Compatibilità

Il Plugin controlla la versione host di OmeniaClaw all'avvio.

Se il Plugin segnala che la tua versione di OmeniaClaw è troppo vecchia, aggiorna OmeniaClaw oppure installa la linea legacy del Plugin:

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

Processo sidecar

Il Plugin WeChat può eseguire attività helper accanto al Gateway mentre monitora l'API Tencent iLink. Nell'issue #68451, quel percorso helper ha esposto un bug nella pulizia generica dei Gateway obsoleti di OmeniaClaw: un processo figlio poteva tentare di pulire il processo Gateway padre, causando cicli di riavvio sotto process manager come systemd.

L'attuale pulizia all'avvio di OmeniaClaw esclude il processo corrente e i suoi antenati, quindi un helper di canale non deve terminare il Gateway che lo ha avviato. Questa correzione è generica; non è un percorso specifico per WeChat nel core.

Risoluzione dei problemi

Controlla installazione e stato:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Se il canale risulta installato ma non si connette, conferma che il Plugin sia abilitato e riavvia:

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

Se il Gateway si riavvia ripetutamente dopo aver abilitato WeChat, aggiorna sia OmeniaClaw sia il Plugin:

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

Se all'avvio viene segnalato che il pacchetto Plugin installato requires compiled runtime output for TypeScript entry, il pacchetto npm è stato pubblicato senza i file runtime JavaScript compilati necessari a OmeniaClaw. Aggiorna/reinstalla dopo che il publisher del Plugin ha distribuito un pacchetto corretto, oppure disabilita/disinstalla temporaneamente il Plugin.

Disabilitazione temporanea:

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

Documentazione correlata

• Panoramica dei canali: Canali chat
• Pairing: Pairing
• Instradamento dei canali: Instradamento dei canali
• Architettura Plugin: Architettura Plugin
• SDK dei Plugin di canale: SDK dei Plugin di canale
• Pacchetto esterno: @tencent-weixin/OmeniaClaw-weixin