WeChat

OpenClaw maakt verbinding met WeChat via Tencents externe @tencent-weixin/openclaw-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.
• openclaw-weixin is de OpenClaw-kanaal-id.
• @tencent-weixin/openclaw-weixin is het npm-pakket.

Gebruik openclaw-weixin in CLI-opdrachten en configuratiepaden.

# Hoe het werkt

De WeChat-code staat niet in de OpenClaw-core-repo. OpenClaw biedt het generieke 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 plugin-entrypoint.
3. De plugin registreert kanaal-id openclaw-weixin.
4. openclaw channels login --channel openclaw-weixin start QR-login.
5. De plugin slaat accountreferenties op onder de OpenClaw-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 OpenClaw-agent gerouteerd en teruggestuurd via het uitgaande pad van de plugin.

Die scheiding is belangrijk: OpenClaw-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/openclaw-weixin-cli install

Handmatige installatie:

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

Herstart de Gateway na installatie:

openclaw gateway restart

# Inloggen

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

openclaw channels login --channel openclaw-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:

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

# Toegangscontrole

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

Nieuwe afzenders goedkeuren:

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

Zie Koppeling voor het volledige toegangscontrolemodel.

# Compatibiliteit

De plugin controleert de hostversie van OpenClaw bij het opstarten.

Pluginlijn	OpenClaw-versie	npm-tag
2.x	>=2026.3.22	latest
1.x	>=2026.1.0 <2026.3.22	legacy

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

openclaw plugins install @tencent-weixin/openclaw-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 OpenClaws 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 OpenClaw 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:

openclaw plugins list
openclaw channels status --probe
openclaw --version

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

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

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

npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw 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 OpenClaw nodig heeft. Werk bij/herinstalleer nadat de plugin- uitgever een gerepareerd pakket heeft uitgebracht, of schakel de plugin tijdelijk uit/verwijder deze.

Tijdelijk uitschakelen:

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

# Gerelateerde documentatie

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