内容大纲
一个能「干活」的多平台 AI 机器人管理系统
如果你正在找一套开箱即用、能同时接入微信、QQ的机器人管理平台——微信端做你的专属 AI 个人助理，QQ 端管理群秩序，还能卖卡密变现、让用户自己上传插件——那这套系统值得你花三分钟看完。
奶狗 WeBot 是一套自托管（self-hosted）机器人管理平台，后端 Node.js + Express，前端 React 现代化后台，内置 SQLite 零外部数据库。它不是一个"玩具"机器人，而是一整套机器人 SaaS 骨架：多机器人、多用户、插件市场、AI、记忆、MCP、QQ 群治理、支付卡密，全都有。
一、多平台接入，一套系统两大生态
- 微信（个人助理）：基于微信 iLink 官方开放平台，一对一私聊场景，AI 助理、记忆、知识库、语音图片、插件功能全部可用，官方合规，不怕封号风险。
- QQ 官方机器人：WebSocket 网关长连接，AppID + Secret 鉴权，自动心跳、断线重连、会话恢复，多机器人并行。群聊 + 私聊双场景，唯一的群管理能力所在。
- 统一插件接口：插件系统通过统一的上下文接口桥接，写一次插件，微信个人助理 / QQ 群聊私聊通道复用。
二、现代化技术栈，跑得动、装得简单
| 层 | 技术 | 为什么选它 |
|---|---|---|
| 运行环境 | Node.js ≥ 20 | 轻量、生态丰富 |
| 后端框架 | Express 4 | 成熟稳定、中间件丰富 |
| 数据库 | 内置 SQLite（可选 MySQL / PostgreSQL） | 零外部数据库，下载即跑 |
| 前端 | React 18 + Vite + TypeScript + Tailwind + shadcn/ui + Radix | 现代化界面、组件化、类型安全 |
| 语音识别 | 本地 Whisper（ONNX）或云端转写 | 语音消息直接变成 AI 对话 |
| 部署 | 内置 PM2 配置（ecosystem.config.js） | 一行命令守护进程、开机自启 |
安装步骤就三步：装依赖 → 构建前端 → 启动。没有数据库配置、没有 Redis、没有外部服务依赖。
三、核心功能全景
1. AI 智能助手（smart）—— 不用记口令的对话式助手
- 自然语言交互：不需要任何指令前缀，直接说人话，AI 自动判断意图。
- 意图自动识别：AI 会自己决定是搜知识库、设提醒、查新闻、看图片还是闲聊。
- 函数调用（Function Calling）：聊天直接变成办事，AI 能调用知识库、提醒、简报等工具。
- 语音消息：微信语音自动转文字 → AI 回复，老人小孩都能用。
- 图片识别：识图、分析、转存知识库，一套流程走完。
- 多轮记忆：30 分钟内上下文连贯，对话像真人。
- 额度管理：每次调用消耗 Token，后台精确计量，商业化可控。
- 模型自由：兼容 OpenAI 协议的任意 API，地址、Key 后台可配。
2. 超级记忆（memory）—— 机器人替你记住重要的事
- 自动把聊天里的链接、账号、地址、纪念日、笔记整理成每用户一份的 Markdown 文件。
- 隐私优先：默认关闭，用户主动开启才记录；随时可编辑、导出、清空。
- 每用户隔离：用户只能看到自己的记忆，管理员可在后台审阅全部。
- 微信里说「开启记忆 / 我的记忆 / 导出记忆」即可管理，网页也能直接编辑。
3. MCP 客户端 —— 让 AI 长出无限双手
- 连接多个 MCP（Model Context Protocol）服务器，自动发现工具并暴露给 AI 调用。
- 相当于给 AI 任意挂接外部能力：数据库、API、浏览器、自动化……全免费。
4. IMA 知识库 / 笔记 —— 给机器人装一个"私域大脑"
- 搜索、写入、导入网页与图片，构建专属知识库。
- 笔记系统：列表、搜索、读取、创建，随手记录。
- 和 AI 打通：对话里提问，AI 从你的知识库找答案。
5. 插件市场 —— 一个可卖钱的插件生态
- 官方插件仓库 + 第三方插件上传，一键安装、启用、定价。
- 支持多种收费模式：免费 / 付费买断 / 积分兑换等。
- 插件开发规范完备，配套中文开发指南，上手就能写自己的插件。
- 每台机器人 / 每个群可独立配置插件白名单，权限灵活。
6. 完整用户系统 + 商业化闭环
- 注册 / 登录 / 邮箱验证、OAuth 第三方绑定、TOTP 两步验证。
- 签到积分、会员等级、邀请注册。
- 充值支付、余额消费、明细账单。
- 卡密系统：后台批量生成兑换码，用户「兑换 key」到账 Token，卖会员、卖额度的标准玩法。
- 授权激活：整套系统自带许可证服务器，商业授权买断制，防止转售破解。
7. 强大管理后台
- 用户管理、机器人管理、系统设置、AI 配置、卡密管理、公告发布、每日简报推送。
- 实时控制台：消息处理、AI 思考、插件错误全链路日志可视化。
- 勿扰模式（DND）、AI 健康检查、验证码保护。
四、插件全家桶（开箱即用的 20+ 功能）
| 类别 | 插件 | 功能 |
|---|---|---|
| AI / 大脑 | smart · memory · mcp · openclaw · ima-knowledge | 智能对话、超级记忆、MCP 工具、OpenClaw Agent、知识库笔记 |
| 消息自动化 | reminder · reply · rss · push · daily-briefing | 定时提醒、关键词回复、RSS 订阅、Webhook 推送、每日早报 |
| 生活工具 | weather · horoscope · gold-price · recipe · vehicle · douyin · anniversary | 天气、星座、黄金价格、菜谱、车辆查询、抖音解析、周年纪念 |
| 效率工具 | delta-password · lookup · mail · wordpress | 密码查询、信息查询、邮件收发、WordPress 管理 |
| 智能家居 | home-assistant | 自然语言控制全屋设备 |
| 商业 | token-card · market | 卡密兑换、插件市场 |
| 客服 | customer-service | 在线客服：外部网站/App 接入，AI 自动应答，人工接管 |
| 企业协作 | qqbot | QQ 官方机器人 |
五、QQ 群安全治理 —— 机器人也能当"群管"
- 违禁词拦截：群级独立词库 + 平台内置词库双层过滤，撤回 + 警告 + 阶梯禁言，满 5 次永久拉黑。
- 入群验证：新成员自动收到数学题验证，三选一按钮答题，答错逐级禁言，答对自动洗白。
- 黑名单体系：验证失败与违禁词共用黑名单，退群重进也逃不掉，只能群管手动解除。
- 口令认领群主：答对口令的人成为群主人，可发禁言指令。
- 定时推送：按群定时推送内容，带频率限流保护。
- 防自伤设计：机器人发出的消息同样过敏感词过滤，警告文案不含违禁词原文，机器人自己不会成为被举报的"传播者"。
六、工程架构解析（代码目录全功能分析）
server.js / worker.js —— 双进程架构
- server.js：Express 主服务，同时托管前端静态资源、JSON API、文档站、Webhook 回调。
- worker.js：独立消息轮询工作进程，可拆开部署，主进程与 Worker 分工明确。
- ecosystem.config.js：PM2 一键部署配置，崩溃自动拉起。
lib/ —— 核心能力库
| 文件 | 职责 |
|---|---|
| db.js | SQLite 数据库连接与封装，全项目数据底座 |
| ilink.js | 微信 iLink 开放平台 API 封装 |
| plugins.js | 插件扫描 / 加载 / 分发 / 白名单 / 调用链编排 |
| sensitive-filter.js | 全局敏感词引擎（双层词库、白名单、命中检测） |
| settings.js | 系统配置读取与合并 |
| auth.js / oauth.js / totp.js | 登录认证、OAuth 绑定、两步验证 |
| license.js | 商业授权校验，防转售防破解 |
| captcha.js | 验证码生成与校验 |
| mailer.js | 邮件发送（注册验证 / 通知） |
| media.js | 媒体消息（图片 / 语音 / 文件）处理 |
| msg-events.js | 消息事件总线（处理中 / 出错实时推送前端控制台） |
| ai_health.js / ai_url.js | AI 健康检查、AI API 地址管理 |
| cron.js / dnd.js | 定时任务调度、勿扰时段 |
| bot.js | 机器人实例管理 |
routes/ —— API 路由层
- api.js：用户端全部业务 API（用户 / 机器人 / 消息 / 支付 / 签到）。
- admin.js：管理后台 API（用户 / 机器人 / 卡密 / 系统配置 / 公告）。
- market.js：插件市场 API（列表 / 安装 / 定价 / 上传）。
- qqbot.js：QQ 机器人管理 API（群配置 / 违禁词 / 入群验证 / 推送）。
- push.js / pluginAssistant.js：推送通道、AI 插件开发助手。
- license-server.js：授权验证服务端。
services/ —— 业务服务
- worker.js：消息拉取 + 插件分发主循环。
- pay.js：支付服务（充值 / 回调 / 对账）。
web/ —— React 管理后台（30+ 页面）
- 用户端：首页落地页、个人中心、充值、消费明细、积分签到、邀请、商城、卡密兑换。
- 管理端：控制台、用户管理、机器人管理、插件市场、上传插件、卡密管理。
- AI 侧：智能助手对话页、Token 用量、自动化任务、用户记忆面板、MCP 配置、AI 开发助手。
- 系统侧：登录 / 注册 / OAuth 绑定 / 授权激活 / 公告 / 文档 / 隐私条款 / 服务协议。
docs/ —— 文档中心
- 插件开发指南（v3.0 中文完整版）、安装部署指南、消息加密规范，站点内直接可读。
七、工程亮点总结
- 零外部依赖：一个进程 + 一个 SQLite 文件，下载就能跑，适合个人站长和小团队。
- 插件化架构：20+ 内置插件 + 市场生态，功能无限扩展，还能卖插件赚钱。
- AI 原生：意图识别、函数调用、语音图片、MCP、记忆，是真正"能干活的机器人"而不是关键字回复。
- 商业闭环：用户 → 签到 → 充值 → 消费 → 卡密 → 插件收费 → 授权买断，一条龙变现。
- QQ 群治理能力：违禁词、验证、黑名单、阶梯惩罚，机器人自带安全审计。
- 工程健壮：双进程、PM2 守护、断线重连、消息防重、会话重试、前端类型安全。
八、适用人群
- 想要专属 AI 个人助理的微信用户：AI 对话、记忆、知识库、语音图片，一个机器人随身带。
- 想治理 QQ 群的群主：违禁词拦截、入群验证、黑名单、AI 答疑一套搞定。
- 想搭建机器人付费服务的站长：用户系统、支付、卡密、授权全部内置。
- 想卖插件的开发者：插件市场 + 收费模式 + 中文开发文档。
- 想给企业做 AI 助手的技术团队：多平台接入 + MCP + 知识库 + 智能家居。
技术栈：Node.js 20+ · Express · SQLite · React 18 · Vite · TypeScript · Tailwind CSS · shadcn/ui · PM2
商业授权：买断制，禁止二次销售、转售与破解。
