> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npx -y @tencent-weixin/openclaw-weixin-cli install ``` Handmatige installatie: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config set plugins.entries.openclaw-weixin.enabled true ``` Herstart de Gateway na installatie: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway restart ``` ## Inloggen Voer QR-login uit op dezelfde machine waarop de Gateway draait: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw config set session.dmScope per-account-channel-peer ``` ## Toegangscontrole Directe berichten gebruiken het normale OpenClaw-koppelings- en allowlistmodel voor kanaalplugins. Nieuwe afzenders goedkeuren: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw pairing list openclaw-weixin openclaw pairing approve openclaw-weixin ``` Zie [Koppeling](/nl/channels/pairing) 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw config set plugins.entries.openclaw-weixin.enabled false openclaw gateway restart ``` ## Gerelateerde documentatie * Kanaaloverzicht: [Chatkanalen](/nl/channels) * Koppeling: [Koppeling](/nl/channels/pairing) * Kanaalroutering: [Kanaalroutering](/nl/channels/channel-routing) * Pluginarchitectuur: [Pluginarchitectuur](/nl/plugins/architecture) * SDK voor kanaalplugins: [SDK voor kanaalplugins](/nl/plugins/sdk-channel-plugins) * Extern pakket: [@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin)