RepoPicks Radar

Updated every day around 23:30 UTC

Guides

wechatbot-webhook

danni-cool/wechatbot-webhookReviewed by AI

Checked by RepoPicks Radar on

What is wechatbot-webhook?

This project turns a personal WeChat account into a web service. You start it with one command or a Docker container, scan a QR code with your phone, and then any tool that can call a URL (n8n, Coze, your own script, an AI app) can send text, images, videos and files to people or groups and receive incoming messages on an address you choose. It runs on Windows, macOS, Linux and ARM boards. The repository was archived in December 2024 and the documentation is in Chinese only.

wechatbot-webhook is free and open source (MIT) and can replace ManyChat and Twilio WhatsApp API.

How easy is it to install wechatbot-webhook?

C · install 1 or 2 tools · Windows

  • Windows C
  • macOS C
  • Linux C

On any of the three systems it is a C: with Node 18.14.1 or newer you run "npx wechatbot-webhook", then open a local address and scan a QR code with WeChat; the recommended route is a Docker container ("docker run -d --name wxBotWebhook -p 3001:3001 dannicool/docker-wechatbot-webhook") plus reading the container log to find the login link. There is no installer and every later step is an HTTP call you build yourself.

wechatbot-webhook on GitHub

Stars
2,164on Nov 10, 2026
Downloads
—all releases
Growth
—no gain in the last reading

Stars over time

2,1642,1652,166 Nov 7Nov 8Nov 9Nov 10 2,1642,1652,166 Nov 7Nov 9

Facts

Runs on
Windows, macOS, Linux
You need to install
Node.js, Docker
To build from source
Node.js, Docker
Disk space
100 MB–500 MB · estimate
Accounts or keys
Other (LOCAL_LOGIN_API_TOKEN)
Cost
Free · MIT licensed and free. You need a machine or small server to keep it running.
License
MIT (Permissive)
Last change on GitHub
Dec 1, 2024

wechatbot-webhook risk signals (5)

  • Attentionaccount restriction risk stated by author

    README Caution block: "项目目前基于web微信,其本身就有被限制风险,另外大概两天一掉线" — the project uses the web version of WeChat, which the author says carries a risk of the account being restricted, and it drops the connection roughly every two days. The author also states no new feature requests are accepted.

    AI review

  • Attentionunofficial wechat interface

    It drives WeChat through third-party libraries with local patches: package.json lists "wechaty": "^1.20.2" and patchedDependencies for [email protected], [email protected] and [email protected]. This is not an official WeChat interface, and automating a personal account this way goes against the platform's rules; the feature table also shows business WeChat messages are not supported (#142).

    AI review

  • Attentionservice holds your logged in account

    You scan a QR code to log your own WeChat into the service ("/login?token=[YOUR_PERSONAL_TOKEN]"), it remembers the session by default (DISABLE_AUTO_LOGIN), and the only protection is a token that is generated into the .env file if you do not set one. Anyone who reaches port 3001 with that token can read incoming messages, fetch avatars through /resouces and send messages as you.

    AI review

  • InfoRepository archived

    The repository is archived (read-only, no longer maintained)

    automatic check

  • Infodocumentation in chinese only

    The whole README, the feature table and the .env.example comments are written in Chinese (for example "启动服务的端口", "扫码登陆"), with no English version in the repository.

    AI review

Evidence is shown in its original language.

What Radar could not check about wechatbot-webhook

  • Whether the QR-code login still works today, since the repository was archived in December 2024 and the web version of WeChat changes often
  • How long a session stays connected in practice and how often you must scan again
  • Whether WeChat limits or blocks an account used this way
  • Real disk and memory use of the container (the 100-500 MB figure is an estimate, not measured)
  • What the 'windows protocol' branch announced in the README actually does, since the table marks it as not available

Similar projects

The RepoPicks app

Coming soon: install in 1 click with the RepoPicks app.

Before you download

See the release page on GitHub