sulla

用 JavaScript 快速开发 WhatsApp 机器人,几行代码即可收发消息

sulla 是一个基于 JavaScript 的 WhatsApp 聊天机器人 API 库,旨在让开发者通过简洁的接口快速构建 WhatsApp 机器人。它封装了 WhatsApp Web 的底层交互,提供消息收发、群组管理、媒体处理等核心能力,解决了非官方 API 接入复杂、维护成本高的问题。项目采用事件驱动模型,支持监听消息、成员变动等事件,并内置了会话管理和多设备支持,适合个人开发者和小团队快速搭建自动化客服、通知机器人等应用。其 API 设计直观,文档示例丰富,降低了 WhatsApp 机器人开发的门槛。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1309
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队danielcardeenas
所属国家
官网地址
定价模式free
价格说明开源库,MIT 许可证,完全免费,需自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言JavaScript
技术栈/模型bot,chatbot,framework,whatsapp,whatsapp-api,whatsapp-bot
GitHub 星标★ 1309
30天Star增速
HF 下载量
上线时间2019-06-10 00:00:00
最近更新2026-09-21 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 5 步

环境要求

  • 已安装 Node.js 与 npm(README 未指定具体版本)
  • 项目基于 puppeteer,环境中需能下载并运行 Chromium
  • 一个可扫码登录的 WhatsApp 手机账号

安装与启动步骤

  1. 1安装 sulla 依赖

    在 Node.js 项目目录中执行,README 给出的唯一安装命令,会作为依赖写入 package.json。

    npm i sulla --save
  2. 2编写机器人脚本

    新建一个 js 文件,粘贴 README 的 Getting started 示例:create() 启动实例,onMessage 监听消息并对 Hi 回复。

  3. 3运行脚本生成二维码

    用 Node 运行你保存的脚本文件(文件名以你实际创建的为准),sulla 会创建 WhatsApp Web 实例。

    node index.js
  4. 4扫码登录账号

    未登录时终端会打印二维码,用手机 WhatsApp 扫描即可,sulla 会记住会话,之后无需重复认证。

  5. 5按需创建多会话

    若要同时运行多个机器人,向 create() 传入不同会话名,例如 create('sales') 与 create('support')。

关键配置

配置项必填说明示例
sessionName(create 参数)否传给 create() 的会话名,用于同时运行多个独立 WhatsApp 会话sales

如何确认成功

脚本运行后终端出现二维码,手机扫码登录成功;发送内容为 Hi 的消息,会收到 " Hello from sulla!" 回复。

常见问题

Q:每次启动都要重新扫码吗?

A:不需要。README 说明 sulla 会记住会话,无需每次都做认证。

Q:能同时运行多个 WhatsApp 账号吗?

A:可以。给 create() 传入不同的会话名,例如 sales、support,即可同时创建多个会话。

Q:这个项目还在活跃维护吗?

A:作者表示 2.3.5 版本后自己投入时间有限,建议关注 README 推荐的 venom、wppconnect、wa-automate 等分支。

Q:需要什么 Node.js 版本?

A:README 未给出具体版本要求,只说明用 npm 安装、基于 puppeteer。

注意事项

  • 本项目基于 puppeteer,首次运行会涉及 Chromium 相关下载,需保证网络可用。
  • 完整 API 列表见仓库 src/api/layers 与 src/lib/wapi/functions,README 只列出了基础用法。
  • 多会话会各自保存会话数据,管理多个账号时注意区分会话名。

核心亮点

  • API 设计简洁,事件驱动模型,上手快,示例代码丰富
  • 内置多设备支持和会话管理,适配 WhatsApp 最新机制
  • 提供媒体收发、群组管理等常用功能,覆盖主流聊天机器人场景

不足之处

  • 依赖非官方 Web 协议,存在账号被限制的风险
  • 文档/社区待观察

适用场景

  • 个人开发者快速搭建 WhatsApp 自动回复机器人
  • 小型团队构建内部通知或客服分流工具
  • 教育项目演示聊天机器人交互逻辑

替代项目

whatsapp-web.js、Baileys、Venom-bot

项目介绍

sulla 是对话助手领域的开源项目,由 danielcardeenas 开发,2019 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,309)位列前 30%,在对话助手分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-21。开源库,MIT 许可证,完全免费,需自行部署使用。

它主要面向的使用场景是:个人开发者快速搭建WhatsApp自动回复机器人。同类可对比的替代方案包括 whatsapp-web.js、Baileys、Venom-bot。

上一篇:bedrock-chat

下一篇:awesome-assistants

同类项目推荐

open-webui 开源

给本地模型配个漂亮聊天室,全家都能用

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

★ 152821 2026-08-09
prompts.chat 开源

海量好提示词,抄了就能让 AI 更听话

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the commun···

★ 170999 2026-08-09
elia 开源

终端里用键盘快速聊 AI,多模型切换不打断思路

A snappy, keyboard-centric terminal user interface for interacting with large langua···

★ 2479 2026-08-09
NextChat 开源

一个界面聊遍所有主流AI模型,支持全平台部署,轻快又私密。

✨ Zero-config AI chat assistant. No API key needed — sign up and instantly chat wi···

★ 88802 2026-08-09