venom

环境要求

• Node.js 18 或更高版本（v6 强制要求）
• npm 包管理器（随 Node.js 一起安装）
• 可访问 WhatsApp Web 的网络环境
• 一个可用于扫码登录的 WhatsApp 账号（手机端保持联网）

安装与启动步骤

1. 1确认 Node 版本

   Venom v6 要求 Node.js 18+，先检查本机版本，低于 18 需先升级再继续。

   node -v

   复制

2. 2初始化项目

   在空目录中生成 package.json，避免把依赖装到全局或上级目录。

   npm init -y

   复制

3. 3安装 venom-bot

   从 npm 安装主包，安装过程中会自动下载 Chromium，网络慢时请耐心等待。

   npm install venom-bot

   复制

4. 4编写快速上手脚本

   新建入口文件写入 README 示例：create 建会话，onMessage 里用 sendText 回复 hello。

   import { create } from 'venom-bot';
   
   create({ session: 'venom-bot' }).then((client) => {
     client.onMessage(async (message) => {
       if (message.body === 'hello') {
         await client.sendText(message.from, "Hey there!  I'm running on Venom.");
       }
     });
   });

   复制

5. 5运行并扫码登录

   用 node 执行入口文件，终端会打印二维码，用手机 WhatsApp 扫码即可上线。

   node index.js

   复制

6. 6验证会话持久化

   登录后 token 自动保存，重启脚本无需重新扫码；可在 options.folderNameToken 查看存储目录。

关键配置

如何确认成功

终端出现二维码，扫码后 statusFind 打印 successChat/isLogged，向机器人发送 hello 能收到回复即成功。

常见问题

注意事项

• Venom 基于非官方 WhatsApp Web 协议，存在账号被风控或封禁的风险，建议使用小号测试。
• 扫码登录后 token 会持久化保存，请勿把 token 目录提交到公开仓库。
• 生产环境建议通过 options.browserPathExecutable、addProxy 等按需定制浏览器与代理配置。
• 使用 AI 能力（如 NLP 识别）需在业务层自行接入，README 未提供内置 AI 服务端点。