项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1152
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 20 或更高版本
- Git
- FFmpeg
- Yarn 包管理器
- PM2 进程管理工具
- PostgreSQL 数据库(仅云平台部署时需要)
安装与启动步骤
-
1全局安装工具
先安装 Yarn 和 PM2。Yarn 用于装依赖,PM2 用于后台守护进程;需要已装好 Node.js 20+ 和 FFmpeg。
npm install -g yarn pm2 -
2克隆项目仓库
把 raganork-md 源码拉到本地并进入项目目录,后续命令都在该目录内执行。
git clone https://github.com/souravkl11/raganork-md.git cd raganork-md -
3安装项目依赖
在项目根目录用 Yarn 安装依赖,网络较慢时可耐心等待或配置镜像源。
yarn install -
4获取会话字符串
打开 README 中给出的官网 https://rgnk.site 按引导生成 SESSION 字符串,这是机器人登录所需的凭证。
-
5创建 .env 配置
在项目根目录新建 .env 文件,按提示写入会话、机器人名称、命令前缀和主人号码等配置。
cat > .env << 'EOF' SESSION=RGNK~d7a5s66 BOT_NAME=Your Bot Name HANDLERS=.,! SUDO=919876543210 EOF -
6启动机器人
执行启动命令运行机器人。若用 PM2 长期运行,可按需改用 PM2 托管,README 未给出对应命令。
npm start
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
SESSION | 是 | 登录会话字符串,多账号用英文逗号分隔 | RGNK~d7a5s66 |
BOT_NAME | 否 | 机器人显示名称 | Your Bot Name |
HANDLERS | 否 | 触发命令的前缀字符,可配置多个 | .,! |
SUDO | 否 | 主人(管理员)手机号,不带加号 | 919876543210 |
DATABASE_URL | 否 | PostgreSQL 连接串,云平台部署持久化会话用;VPS 可用本地文件存储 | postgres://user:pass@host:5432/db |
如何确认成功
终端执行 npm start 后进程持续运行、无依赖或会话报错,即为启动成功。
常见问题
Q:部署在 Render、Koyeb、Railway 等云平台需要注意什么?
A:需要配置 DATABASE_URL(PostgreSQL)用于持久化存储;VPS 部署则可以改用本地文件存储,不必配置数据库。
Q:如何让一个实例管理多个 WhatsApp 账号?
A:在 .env 的 SESSION 中用英文逗号分隔多个会话字符串,例如 RGNK~d7a5s66,RGNK~7ad8cW,即为多会话模式。
Q:启动命令是什么?
A:README 给出的启动命令是 npm start,需在项目根目录执行,且已提前完成 yarn install 和 .env 配置。
Q:Node.js 版本有要求吗?
A:有,需要 Node.js 20 或更高版本,低版本可能导致依赖安装或运行失败。
注意事项
- FFmpeg 需提前在系统层面安装好,项目本身不提供其安装命令。
- SESSION 属于敏感凭证,不要提交到公开仓库或泄露给他人。
- 云平台部署必须准备 PostgreSQL 数据库连接串,否则会话可能丢失。
- PM2 仅用于进程管理,README 未给出具体的 PM2 托管命令,需自行查阅官方文档。
核心亮点
- 基于 JavaScript,模块化插件结构,添加自定义命令只需新增脚本文件
- 轻量低占用,可在低配服务器或树莓派上长期运行
- 内置常见 WhatsApp 操作封装,如消息收发、群组管理和媒体处理,减少重复开发
不足之处
- 依赖非官方 WhatsApp Web 接口,存在账号封禁风险
- 文档和示例相对简单,复杂功能需自行阅读源码探索
适用场景
- 个人或小团队搭建自动回复客服机器人
- 社群运营中自动欢迎新成员、关键词回复和定时通知
- 通过 WhatsApp 推送服务器告警或日常提醒
替代项目
Baileys、whatsapp-web.js
上一篇:OpenInstinct
下一篇:neo-chat
同类项目推荐
Facebook-Messenger-Bot
开源
用你的聊天记录训练一个像你的Messenger机器人
Facebook chatbot that I trained to talk like me using Seq2Seq
apfel
开源
Mac 上免费本地 AI,无需联网,即刻体验。
The free AI already on your Mac. CLI tool, OpenAI-compatible server, and interactive···
gemini_multipdf_chat
开源
上传多个 PDF,直接对话提问,快速获取答案。
Gemini PDF Chatbot: A Streamlit-based application powered by the Gemini conversation···
hugging-chat-api
开源
用 Python 几行代码调用 HuggingChat,快速搭建聊天机器人。
HuggingChat Python API
WhatsAppBotTut
开源
跟着教程,用 Python 快速搭建 WhatsApp 聊天机器人
Tutorial to create WhatsApp Bot using Twilio and Python
HacxGPT-CLI
开源
命令行里畅聊无阻,绕过审查直达AI答案
Open-source CLI for unrestricted AI - Access powerful models without censorship
llama-gpt
开源
本地跑起ChatGPT,数据不出门,隐私百分百
A self-hosted, offline, ChatGPT-like chatbot. Powered by Llama 2. 100% private, with···
AmigaGPT
开源
让 Amiga 老电脑也能聊 ChatGPT 和画图
AmigaOS 3.1/4.1 and MorphOS application for chatting with ChatGPT or generating imag···
jev-chat-windows
开源
截图读消息,AI 给 3 条回复,一键填入自己发
JevChat-Windows:聊天窗口旁挂的回复辅助。窗口截图 + 本地离线 OCR 读对方消息 → Jev 判···
