Skip to main content


How-to guides are like recipes when you are cooking. Equipped with basic knowledge about Wechaty, you can find key problems and use-cases at Wechaty Examples. If you are a total beginner, you can go to Wechaty getting started first.

Add events to the bot

Prepare your bot to add events

Add functionality to the bot

Use one of our quickstart repositories to add functionalities to the bot in a few minutes.

Deploy on IM platform

Deploy the bot on various instant messaging platform

Deploy with containers

Deploy the bot with highly popular container solutions


Using Puppets with Wechaty (How to switch between puppets)

For different instant messaging (IM) systems (such as WeChat, Whatsapp, and TikTok), the Wechaty community builds separate RPA (Robotic Process Automation) modules for each, and we call those modules Wechaty Puppet.

Wechaty Puppet Service is gRPC for Wechaty Puppet. To use a Wechaty Puppet Service, you need a TOKEN for that service, and pass it to Wechaty, then you will be able to use that Puppet Service.

export WECHATY_PUPPET=wechaty-puppet-service

You can switch between different Wechaty Puppet Services by changing your TOKEN. The source code works same irrespective of the token you used.

To learn how to generate TOKEN and switch between puppets , you can visit Puppet Services.

Use Cases

Wechaty cases study