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
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)
- Can replace
- ManyChat, WhatsApp API
- 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