Skip to content
agent-wechat

VNC Viewer

agent-wechat includes a browser-based VNC viewer that lets you see exactly what’s happening inside the container.

Accessing the VNC viewer

Open your browser to:

http://localhost:6174/vnc/

This shows the WeChat desktop client running inside the container via noVNC. You can see:

  • The current WeChat UI state
  • QR codes during login
  • Chat windows and messages
  • Any errors or popups

When to use the VNC viewer

  • Debugging — see what the UI automation is doing
  • Login — watch the QR code flow if the CLI isn’t showing it
  • Verification — confirm the bot is logged in and working
  • Troubleshooting — check for error dialogs or unexpected UI states

Notes

  • The VNC viewer is served on the same port (6174) as the REST API, under the /vnc/ path
  • It’s read-only by default — you can observe but interactions through the browser are possible
  • No additional configuration is required; it’s always available when the container is running