csr1010/wappy-kit

这是什么？

核心功能

• 01通过一条 `npm create` 命令生成 WhatsApp 智能体项目。
• 02支持 Anthropic、OpenAI、Gemini 及本地 Ollama 模型，使用自己的密钥。
• 03默认将对话与导入的知识保存在本地 SQLite/LibSQL 中。
• 04可选择 Cognee 作为自托管或云端的知识图谱后端。
• 05附带只读的 Gmail 与 Google Calendar 工具示例。

适用场景

• 搭建可跨对话记住上下文的私人 WhatsApp 助手。
• 在不上传第三方云端的前提下，基于自己的笔记或文档进行问答。
• 原型开发可在 WhatsApp 上使用的客服或预订机器人。
• 结合本地 Ollama 模型运行完全离线的智能体。

快速上手

1. 1

   用安装器生成项目

   npm create @wappy_ai/agent
2. 2

   复制环境变量示例并填入模型密钥和 WhatsApp 凭据

   cp .env.sample .env
3. 3

   安装依赖

   npm install
4. 4

   启动开发服务器和隧道，然后将输出的 URL 设置为 Meta 的 webhook

   npm run dev

使用前须知

• !项目仍处于 1.0 之前的早期阶段，可能会有变动。
• !需要 Node.js 22 或更高版本，以及 Meta 的 WhatsApp Cloud API 应用。
• !运行智能体需要你自己的模型 API 密钥，或本地 Ollama 环境。

标签

常见问题

wappy-kit 是什么？

开源 TypeScript SDK，用于在 WhatsApp 上搭建运行在本地、可自带模型与数据的 AI 智能体。 Wappy 是一个 TypeScript SDK 和项目生成器，用于搭建通过官方 WhatsApp Cloud API 与用户对话的 AI 智能体。运行 `npm create @wappy_ai/agent` 会生成一个已接好智能体循环、记忆、工具调用和回复格式化的项目，模型密钥由你自己提供，支持 Anthropic、OpenAI、Gemini，也可以使用本地 Ollama 模型。

wappy-kit 可以免费使用吗？用的什么许可证？

wappy-kit 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

wappy-kit 还在维护吗？

活跃维护中。wappy-kit 最近一次提交是在 2026年10月21日。

wappy-kit 适合用来做什么？

搭建可跨对话记住上下文的私人 WhatsApp 助手。 在不上传第三方云端的前提下，基于自己的笔记或文档进行问答。 原型开发可在 WhatsApp 上使用的客服或预订机器人。 结合本地 Ollama 模型运行完全离线的智能体。

wappy-kit 怎么安装和运行？

用安装器生成项目: npm create @wappy_ai/agent 复制环境变量示例并填入模型密钥和 WhatsApp 凭据: cp .env.sample .env 安装依赖: npm install 启动开发服务器和隧道，然后将输出的 URL 设置为 Meta 的 webhook: npm run dev

在哪里获取 wappy-kit？

源代码和安装说明在 GitHub 上：https://github.com/csr1010/wappy-kit