WeChat

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

Status: externe plugin, onderhouden door het Tencent Weixin-team. Directe chats en media worden ondersteund. Groepschats worden niet vermeld in de capaciteitsmetadata van de plugin (deze verklaart alleen directe chats).

Naamgeving

• WeChat is de gebruikersgerichte naam in deze documentatie.
• Weixin is de naam die wordt gebruikt door Tencents pakket en door de plugin-id.
• openclaw-weixin is de OpenClaw-kanaal-id (weixin en wechat werken als aliassen).
• @tencent-weixin/openclaw-weixin is het npm-pakket.

Gebruik openclaw-weixin in CLI-opdrachten en configuratiepaden.

Werking

De WeChat-code bevindt zich niet in de kernrepository van OpenClaw. OpenClaw biedt het algemene contract voor kanaalplugins en de externe plugin biedt de WeChat-specifieke runtime:

1. openclaw plugins install installeert @tencent-weixin/openclaw-weixin.
2. De Gateway ontdekt het pluginmanifest en laadt het ingangspunt van de plugin.
3. De plugin registreert kanaal-id openclaw-weixin.
4. openclaw channels login --channel openclaw-weixin start het aanmelden via QR-code.
5. De plugin slaat accountreferenties op in de OpenClaw-statusmap (standaard ~/.openclaw).
6. Wanneer de Gateway start, start de plugin voor elk geconfigureerd account de bijbehorende Weixin-monitor.
7. Inkomende WeChat-berichten worden via het kanaalcontract genormaliseerd, naar de geselecteerde OpenClaw-agent gerouteerd en via het uitgaande pad van de plugin teruggestuurd.

Die scheiding is belangrijk: de OpenClaw-kern blijft kanaalonafhankelijk. Aanmelden bij WeChat, aanroepen van de Tencent iLink-API, het uploaden en downloaden van media, contexttokens en accountbewaking vallen onder de verantwoordelijkheid van de externe plugin.

Installatie

Snelle installatie:

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

Handmatige installatie:

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

Start de Gateway opnieuw na de installatie:

openclaw gateway restart

Aanmelden

Voer het aanmelden via QR-code uit op dezelfde machine waarop de Gateway draait:

openclaw channels login --channel openclaw-weixin

Scan de QR-code met WeChat op uw telefoon en bevestig de aanmelding. Na een geslaagde scan slaat de plugin het accounttoken lokaal op.

Voer dezelfde aanmeldopdracht opnieuw uit om nog een WeChat-account toe te voegen. Isoleer bij meerdere accounts sessies met directe berichten per account, kanaal en afzender:

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

Toegangsbeheer

Directe berichten gebruiken het normale koppelings- en toelatingslijstmodel van OpenClaw voor kanaalplugins.

Keur nieuwe afzenders goed:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

Zie Koppeling voor het volledige toegangsbeheermodel.

Compatibiliteit

De plugin controleert bij het opstarten de versie van de OpenClaw-host.

Als de plugin meldt dat uw OpenClaw-versie te oud is, werkt u OpenClaw bij of installeert u de verouderde pluginreeks:

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

Sidecarproces

De WeChat-plugin kan naast de Gateway ondersteunende taken uitvoeren terwijl deze de Tencent iLink-API bewaakt. In issue #68451 bracht dat ondersteunende pad een fout aan het licht in OpenClaws algemene opschoning van verouderde Gateway-processen: een onderliggend proces kon proberen het bovenliggende Gateway-proces op te schonen, waardoor herstartlussen ontstonden onder procesbeheerders zoals systemd.

De huidige opschoning bij het starten van OpenClaw sluit het huidige proces en diens bovenliggende processen uit, zodat een kanaalhulpproces de Gateway die het heeft gestart niet kan beëindigen. Deze oplossing is algemeen; het is geen WeChat-specifiek pad in de kern.

Probleemoplossing

Controleer de installatie en status:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Als het kanaal als geïnstalleerd wordt weergegeven maar geen verbinding maakt, controleert u of de plugin is ingeschakeld en start u opnieuw:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

Als de Gateway na het inschakelen van WeChat herhaaldelijk opnieuw start, werkt u zowel OpenClaw als de plugin bij:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

Als bij het opstarten wordt gemeld dat het geïnstalleerde pluginpakket requires compiled runtime output for TypeScript entry, is het npm-pakket gepubliceerd zonder de gecompileerde JavaScript-runtimebestanden die OpenClaw nodig heeft. Werk de plugin bij of installeer deze opnieuw nadat de uitgever een gecorrigeerd pakket heeft uitgebracht, of schakel de plugin tijdelijk uit of verwijder deze.

Tijdelijk uitschakelen:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

Gerelateerde documentatie

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