Weixin (Personal WeChat) Integration

Table of contents

  1. Weixin (Personal WeChat) Integration
    1. Features
    2. Setup Guide
      1. 1. First-Time Login
      2. 2. Scan QR Code
      3. 3. Done!
    3. Commands
    4. Technical Details
    5. Troubleshooting
      1. QR Code Not Displaying
      2. Login Failed
      3. Connection Lost
    6. Security Notes
    7. Next Steps

Weixin integration for personal WeChat accounts via QR code login.

Features

  • QR Code Login: Scan with WeChat to login
  • Auto Credential Caching: Login credentials saved locally
  • Auto Reconnect: Automatically reconnects on restart
  • Long Message Support: Auto-chunking for messages > 2,048 characters

Setup Guide

1. First-Time Login

Run the following Lua command in Neovim:

:lua require('chat.integrations.weixin').login()

A QR code will be displayed in a floating window.

The QR code is generated via the OpenClaw WeChat Gateway.

2. Scan QR Code

  • Open WeChat on your phone
  • Scan the QR code
  • Confirm login on your phone

Do not share the QR code with others to prevent unauthorized access.

3. Done!

Login credentials are automatically saved to:

stdpath('data')/chat-weixin-state.json

Subsequent restarts will auto-connect using saved credentials.

You don’t need to login again unless credentials expire or are cleared.

Commands

Command Description
:lua require('chat.integrations.weixin').login() Start QR code login
:lua require('chat.integrations.weixin').logout() Logout and clear credentials
:lua require('chat.integrations.weixin').get_state() Check connection status

Technical Details

  • API: OpenClaw WeChat Gateway
  • Authentication: QR Code Login (auto-refresh)
  • Message Limit: 2,048 characters (auto-chunking)
  • State Persistence: stdpath('data')/chat-weixin-state.json
  • Polling: Long-poll every 3 seconds

Troubleshooting

QR Code Not Displaying

Symptom: QR code window not appearing.

Solution:

  1. Check if the floating window is created
  2. Verify the gateway is accessible
  3. Check Neovim logs for errors

Login Failed

Symptom: QR code scan does not complete login.

Solution:

  1. Ensure you confirm login on your phone
  2. Check network connectivity
  3. Try scanning again with a fresh QR code

Connection Lost

Symptom: Messages not being received after restart.

Solution:

  1. Check if credentials are saved
  2. Run :lua require('chat.integrations.weixin').get_state() to check status
  3. Re-login if credentials expired

Security Notes

  • Never share your QR code with others
  • Credentials are stored locally in stdpath('data')
  • Logout to clear credentials when switching devices
  • Use :lua require('chat.integrations.weixin').logout() to clear state

Next Steps