WeChat

OmeniaClaw maakt verbinding met WeChat via Tencents externe @tencent-weixin/OmeniaClaw-weixin-kanaalplugin.

Status: externe plugin. Directe chats en media worden ondersteund. Groepschats worden niet geadverteerd door de huidige metadata voor pluginmogelijkheden.

Naamgeving

• WeChat is de gebruikersgerichte naam in deze documentatie.
• Weixin is de naam die wordt gebruikt door Tencents pakket en door de plugin-id.
• OmeniaClaw-weixin is de OmeniaClaw-kanaal-id.
• @tencent-weixin/OmeniaClaw-weixin is het npm-pakket.

Gebruik OmeniaClaw-weixin in CLI-opdrachten en configuratiepaden.

Hoe het werkt

De WeChat-code staat niet in de OmeniaClaw-core-repo. OmeniaClaw biedt het generieke contract voor kanaalplugins, en de externe plugin biedt de WeChat-specifieke runtime:

1. OmeniaClaw plugins install installeert @tencent-weixin/OmeniaClaw-weixin.
2. De Gateway ontdekt het pluginmanifest en laadt het plugin-entrypoint.
3. De plugin registreert kanaal-id OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin start QR-login.
5. De plugin slaat accountreferenties op onder de OmeniaClaw-statusdirectory.
6. Wanneer de Gateway start, start de plugin zijn Weixin-monitor voor elk geconfigureerd account.
7. Binnenkomende WeChat-berichten worden genormaliseerd via het kanaalcontract, naar de geselecteerde OmeniaClaw-agent gerouteerd en teruggestuurd via het uitgaande pad van de plugin.

Die scheiding is belangrijk: OmeniaClaw-core moet kanaalonafhankelijk blijven. WeChat-login, Tencent iLink API-aanroepen, media-upload/download, contexttokens en accountbewaking zijn eigendom van de externe plugin.

Installeren

Snelle installatie:

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

Handmatige installatie:

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

Herstart de Gateway na installatie:

OmeniaClaw gateway restart

Inloggen

Voer QR-login uit op dezelfde machine waarop de Gateway draait:

OmeniaClaw channels login --channel OmeniaClaw-weixin

Scan de QR-code met WeChat op je telefoon en bevestig de login. De plugin slaat het accounttoken lokaal op na een geslaagde scan.

Voer dezelfde loginopdracht opnieuw uit om nog een WeChat-account toe te voegen. Isoleer bij meerdere accounts direct-message-sessies per account, kanaal en afzender:

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

Toegangscontrole

Directe berichten gebruiken het normale OmeniaClaw-koppelings- en allowlistmodel voor kanaalplugins.

Nieuwe afzenders goedkeuren:

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

Zie Koppeling voor het volledige toegangscontrolemodel.

Compatibiliteit

De plugin controleert de hostversie van OmeniaClaw bij het opstarten.

Als de plugin meldt dat je OmeniaClaw-versie te oud is, werk dan OmeniaClaw bij of installeer de legacy-pluginlijn:

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

Sidecar-proces

De WeChat-plugin kan hulpwerk naast de Gateway uitvoeren terwijl deze de Tencent iLink API bewaakt. In issue #68451 bracht dat hulppad een bug aan het licht in OmeniaClaws generieke opschoning van verouderde Gateways: een childproces kon proberen het bovenliggende Gateway-proces op te schonen, wat herstartlussen veroorzaakte onder procesbeheerders zoals systemd.

De huidige opstartopschoning van OmeniaClaw sluit het huidige proces en zijn voorouders uit, dus een kanaalhelper mag de Gateway die hem heeft gestart niet beëindigen. Deze fix is generiek; het is geen WeChat-specifiek pad in core.

Problemen oplossen

Installatie en status controleren:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Als het kanaal als geïnstalleerd wordt weergegeven maar geen verbinding maakt, bevestig dan dat de plugin is ingeschakeld en herstart:

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

Als de Gateway herhaaldelijk herstart na het inschakelen van WeChat, werk dan zowel OmeniaClaw als de plugin bij:

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

Als het opstarten meldt dat het geïnstalleerde pluginpakket requires compiled runtime output for TypeScript entry, is het npm-pakket gepubliceerd zonder de gecompileerde JavaScript-runtimebestanden die OmeniaClaw nodig heeft. Werk bij/herinstalleer nadat de plugin- uitgever een gerepareerd pakket heeft uitgebracht, of schakel de plugin tijdelijk uit/verwijder deze.

Tijdelijk uitschakelen:

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

Gerelateerde documentatie

• Kanaaloverzicht: Chatkanalen
• Koppeling: Koppeling
• Kanaalroutering: Kanaalroutering
• Pluginarchitectuur: Pluginarchitectuur
• SDK voor kanaalplugins: SDK voor kanaalplugins
• Extern pakket: @tencent-weixin/OmeniaClaw-weixin