raganork-md

轻量框架快速搭 WhatsApp 机器人,插件扩展自动回复

开源 🏷️定价信息待确认 🚫 站点已失效 对话助手 🍴 复刻 2241 🐛 待处理 7 👀 关注 85
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1152
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

raganork-md 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队souravkl11
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态🚫 站点已失效
是否开源是
开源协议GPL-3.0
主要语言JavaScript
技术栈/模型raganork,whatsapp-bot
GitHub 星标★ 1152
上线时间2021-09-14 00:00:00
代码更新2026-11-15
仓库体积87.3 MB
本站数据更新2026-11-15
维护状态活跃
收录时间2026-10-02
浏览次数1

项目介绍

raganork-md 是一个基于 JavaScript 的轻量级多功能 WhatsApp 机器人框架,主要面向希望快速搭建自动化 WhatsApp 助手的开发者。它封装了 WhatsApp Web 的通信能力,让用户无需从零处理登录、消息收发和事件监听,就能通过插件式结构扩展功能。核心能力包括自动回复、群组管理、媒体下载、命令触发、定时任务等常见场景,并支持模块化加载自定义脚本。相比重量级框架,它强调低资源占用和易部署,适合个人或小团队在服务器或树莓派上运行。项目提供基础命令系统和配置入口,用户可基于示例快速添加自己的业务逻辑,如客服问答、通知推送或社群运营工具。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1152

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:本地安装 6 步

环境要求

  • Node.js 20 或更高版本
  • Git
  • FFmpeg
  • Yarn 包管理器
  • PM2 进程管理工具
  • PostgreSQL 数据库(仅云平台部署时需要)

安装与启动步骤

  1. 1全局安装工具

    先安装 Yarn 和 PM2。Yarn 用于装依赖,PM2 用于后台守护进程;需要已装好 Node.js 20+ 和 FFmpeg。

    npm install -g yarn pm2
  2. 2克隆项目仓库

    把 raganork-md 源码拉到本地并进入项目目录,后续命令都在该目录内执行。

    git clone https://github.com/souravkl11/raganork-md.git
    cd raganork-md
  3. 3安装项目依赖

    在项目根目录用 Yarn 安装依赖,网络较慢时可耐心等待或配置镜像源。

    yarn install
  4. 4获取会话字符串

    打开 README 中给出的官网 https://rgnk.site 按引导生成 SESSION 字符串,这是机器人登录所需的凭证。

  5. 5创建 .env 配置

    在项目根目录新建 .env 文件,按提示写入会话、机器人名称、命令前缀和主人号码等配置。

    cat > .env << 'EOF'
    SESSION=RGNK~d7a5s66
    BOT_NAME=Your Bot Name
    HANDLERS=.,!
    SUDO=919876543210
    EOF
  6. 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

★ 705 2026-08-09
apfel 开源

Mac 上免费本地 AI,无需联网,即刻体验。

The free AI already on your Mac. CLI tool, OpenAI-compatible server, and interactive···

★ 6608 2026-08-09
gemini_multipdf_chat 开源

上传多个 PDF,直接对话提问,快速获取答案。

Gemini PDF Chatbot: A Streamlit-based application powered by the Gemini conversation···

★ 225 2026-08-09
hugging-chat-api 开源

用 Python 几行代码调用 HuggingChat,快速搭建聊天机器人。

HuggingChat Python API

★ 939 2026-08-09
WhatsAppBotTut 开源

跟着教程,用 Python 快速搭建 WhatsApp 聊天机器人

Tutorial to create WhatsApp Bot using Twilio and Python

★ 146 2026-08-09
HacxGPT-CLI 开源

命令行里畅聊无阻,绕过审查直达AI答案

Open-source CLI for unrestricted AI - Access powerful models without censorship

★ 1164 2026-08-09
llama-gpt 开源

本地跑起ChatGPT,数据不出门,隐私百分百

A self-hosted, offline, ChatGPT-like chatbot. Powered by Llama 2. 100% private, with···

★ 10923 2026-08-09
AmigaGPT 开源

让 Amiga 老电脑也能聊 ChatGPT 和画图

AmigaOS 3.1/4.1 and MorphOS application for chatting with ChatGPT or generating imag···

★ 80 2026-08-09
jev-chat-windows 开源

截图读消息,AI 给 3 条回复,一键填入自己发

JevChat-Windows:聊天窗口旁挂的回复辅助。窗口截图 + 本地离线 OCR 读对方消息 → Jev 判···

★ 890 2026-09-28