Skip to main content

Event Logger plugin

The EventLogger plugin helps in logging Wechaty events with just one line of code. In this tutorial, you will learn how to add the EventLogger plugin to a Wechaty bot.


  1. Node.js v12+
  2. Wechaty v0.40+
  3. Wechaty Plugin Contrib

Getting started#

You will require Node.js version 12.0 or greater in order to follow this tutorial. You can verify whether Node.js is installed on your system or whether you have the correct version using the command:

node -v

If you do not have Node.js installed or your version is below requirement, get the latest version of Node.js by following the links below:

Node.js installation docs

Installation guide for Node.js on other platforms can be found here.

Adding Event Logger plugin#

For the demonstration of adding this plugin, we will use the Starter Bot and show you how to add the EventLogger plugin to it. Follow the steps below:

1. Create a starter bot#

Follow the instructions on the Starter Bot page to create the foundation of a Wechaty bot.

2. Install dependency#

As the EventLogger plugin is present in the wechaty-plugin-contrib NPM package, you have to first add it to the dependencies. It can be installed using the following command:

npm i wechaty-plugin-contrib

3. Integrate the plugin#

Inside the event-logger-bot.ts file, import the plugin:

import { EventLogger } from 'wechaty-plugin-contrib'

Now, just before starting the bot, you can use this plugin:

// Add the following line to use the pluginbot.use(EventLogger())bot.start()

4. Run the bot#

In order to run the bot, first you have to export/set an environment variable with the type of puppet to use, and then start the bot:

export WECHATY_LOG=verboseexport WECHATY_PUPPET=wechaty-puppet-wechatmake bot# the above is equals to the below command:# npm start#   or, npx ts-node examples/ding-dong-bot.ts

EventLogger plugin output

Congratulations! You have successfully integrated the EventLogger plugin to your Wechaty bot. You will see after running the bot, it starts logging the Wechaty events.


You can apply a similar concept to add the EventLogger plugin to any of your Wechaty bots. You can learn more about this plugin here.

Learn how to integrate QR Code Terminal Plugin to your Wechaty bot in the next tutorial.