全栈

微信 AI 陪伴机器人 SaaS 平台

面向微信陪伴场景的全栈 SaaS 项目，覆盖用户注册登录、AI 角色创建、网页聊天、额度扣减、套餐订单、mock 支付、管理后台、微信绑定和真实微信消息 bridge。

周期: 个人项目｜持续迭代
角色: AI 辅助独立开发
类型: 全栈

查看 GitHub 仓库

我的工作

设计并实现微信 AI 陪伴机器人 SaaS 平台，覆盖用户注册登录、AI 角色创建、网页聊天、额度扣减、套餐订单、mock 支付和管理后台。
基于 FastAPI、SQLAlchemy、PostgreSQL 和 Redis 构建后端服务，使用 Alembic 管理数据库迁移，并补充健康检查、限流、生产环境安全校验和备份脚本。
使用 Next.js 16、React 19、TypeScript 和 Tailwind 实现用户端与管理端页面，包括 AI 创建、聊天、微信绑定、订单、额度流水和后台运营视图。
接入 DeepSeek / mock 回复链路，将网页聊天和微信渠道统一复用同一套聊天服务、额度扣减和失败退款逻辑。
实现 OpenClaw Node.js bridge，对接真实微信扫码连接、长轮询消息、联系人快照、消息转发、幂等处理、失败事件记录和主动触达投递回执。
构建 MCP sidecar 支持图片理解和表情包检索，使微信聊天场景能够扩展多模态理解与趣味化回复能力。
配置 Docker Compose 编排 PostgreSQL、Redis、mcp-sidecar、backend、frontend 和可选 wechat-bridge，并为关键服务加入 healthcheck。
建立 GitHub Actions CI，覆盖后端 pytest、mcp-sidecar pytest、前端构建、openclaw-bridge Node 测试和 Docker Compose 配置检查。

技术流程

用户注册登录后创建 AI 角色并获得初始额度
网页聊天或微信消息进入统一聊天服务
后端校验用户、AI 角色、绑定状态和剩余额度
调用 DeepSeek 或 mock 回复生成 AI 响应，失败时回退额度
订单与 mock 支付流程写入套餐、订单和额度流水
OpenClaw bridge 通过微信扫码登录和长轮询接入真实微信消息
MCP sidecar 为图片理解和表情包检索提供扩展能力
管理后台查看用户、AI、微信连接、订单、消息和额度记录

问题与约束

这个项目的复杂度不在单个聊天页面，而在把 SaaS 账号体系、AI 角色、额度计费、订单、后台运营、微信真实消息收发、MCP 工具能力和生产化部署约束组合成一条可运行链路。实现时需要处理多端状态一致性、微信长轮询的幂等与失败记录、额度扣减的可追溯性，以及生产环境默认密钥、CORS、HTTPS 和 bridge token 等安全边界。

关键技术决策

网页与微信复用同一聊天服务

将网页聊天和 OpenClaw 微信 webhook 汇入同一套聊天服务，统一处理角色上下文、额度扣减、失败退款和消息记录，避免两套渠道逻辑分叉。

Bridge 作为独立 sidecar

把真实微信扫码、token 读取、长轮询、联系人快照和消息投递放在 Node.js bridge 中，后端只接收经过 token 校验的 webhook 与 heartbeat。

生产环境启动前置校验

生产环境拒绝默认 JWT、默认管理员密码、非 HTTPS 前端域名和缺失 bridge token，避免演示配置被误带到公开部署。

MCP 能力保持独立边界

将图片理解和表情包检索放入 MCP sidecar，主后端通过服务层调用，便于后续替换模型、扩展工具或独立测试。

结果与复盘

完成一个可运行的微信 AI 陪伴机器人 SaaS 平台原型：仓库包含前端、后端、OpenClaw bridge、MCP sidecar、Docker Compose、Alembic 迁移、备份脚本、生产环境安全校验和 GitHub Actions CI。CI 覆盖 backend、frontend、bridge、sidecar 与 Compose 配置检查。

项目边界

公开个人项目。当前仍保留 mock 支付接口，未接入真实支付、资质合规、内容安全审核和商业化运营流程；真实微信 bridge 依赖服务端 OpenClaw profile state 和 token，相关凭据不能提交到 Git 或暴露给前端。AI 参与了较多编码和文档生成，本人主要负责方向定义、架构拆分、功能验收、调试与持续迭代。