melgarafael/DeskcommCRM · 上手攻略
- 仓库：melgarafael/DeskcommCRM
- 链接：https://github.com/melgarafael/DeskcommCRM
- 分类：CRM · AI 销售 · WhatsApp · Self-hosted
- 作者：Tom
- 更新：2026-08-28
是什么
DeskcommCRM 是一个开源的AI 销售操作系统（AI Sales OS），运行在你的自有服务器上，把 AI 智能体 + WhatsApp 渠道 + CRM 管理功能合为一体。
名字来自 Desk（办公桌）+ comm（商业）：把整个销售团队的工作"装进一张桌子"，人 + AI 协同操作。
核心定位：Kommo、Octadesk、Intercom 的开源替代方案，不做 SaaS 订阅、无限席位、无限 WhatsApp 号码，数据全在你自己服务器。
解决什么问题
中小商家做销售数字化面临两难：花大钱买 SaaS CRM（按月付费、席位费、feature lock）还是自己搭系统（技术门槛高、维护成本大）。
DeskcommCRM 用一键安装脚本解决了这个矛盾：
- 非技术用户：一条命令装完整生产系统，包含 WhatsApp 集成
- 开发者：开源可审计、可自托管、有 MCP 接口让 AI 智能体真正"操控"CRM
- 多语言/多地区：葡萄牙语/英语/西班牙语多语言界面，LGPD 合规（适合巴西市场）
典型痛点： - 想用 WhatsApp 做销售但没有系统化管理线索的工具 - 需要 AI 辅助做线索 Qualification、Follow-up、推送，但不想把所有数据交到第三方 - 团队用 CRM 但信息散落在 WhatsApp 聊天记录里，AI 和人无法协同
快速安装
前置准备
| 需要准备 | 说明 |
|---|---|
| VPS + Docker | 推荐 4 GB RAM，支持 Docker 的任意 VPS |
| 域名 | A 记录指向 VPS IP，如 crm.suaempresa.com |
| Supabase 账号 | 免费额度足够起步（Postgres + Auth + Storage） |
| AI 密钥 | OpenRouter / Anthropic / OpenAI 三选一 |
| WhatsApp 号码 | 用于连接渠道 |
方式一：一条命令安装（推荐）
# 在你自己的电脑上运行（macOS / Linux / WSL），它会告诉你需要买什么 VPS
curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/hostgator-setup-kit/comecar.sh | bash
这个脚本不实际安装，只做分析并输出你需要购买的 VPS 规格和安装命令。
方式二：直接安装到 VPS
ssh 登录你的 VPS，然后：
git clone https://github.com/melgarafael/DeskcommCRM.git
cd DeskcommCRM
bash hostgator-setup-kit/install.sh
安装过程会交互式询问： - 域名 - Supabase 凭证（3 个 key + Session pooler 连接串） - AI 供应商选择 - 管理员邮箱和密码
自动完成的事： - 生成所有技术密钥（无需你发明） - 创建 Postgres 扩展 + 完整 schema - 创建第一个管理员账号 - 启动完整 stack + 自动 HTTPS - 安装自动化 cron（WHEN/IF/THEN 规则靠它驱动）和自动更新 agent
💡 如果你在安装前 export 了
SUPABASE_ACCESS_TOKEN，脚本会自动在 Supabase 创建项目、等待就绪、获取全部凭证，全程无需手动操作。
非交互模式（自动化部署）
cp .env.hostgator.example .env
# 填好 .env 中的所有变量
bash hostgator-setup-kit/install.sh --yes
已有代理/反向代理的 VPS
如果 VPS 已经自带反向代理（Hostinger、Coolify、Dokploy 等），安装脚本会自动检测，不会冲突，而是通过已有代理发布。
其他托管平台
理论上任何带 Docker 的 VPS 都能跑，详情见 hostgator-setup-kit/README.md。
核心用法
启动后第一步
- 打开
https://<你的域名>（HTTPS 证书约 1 分钟生效） - 用管理员账号登录
- （可选）在「设置 → 安全」中开启双因素认证（首次登录不强制）
- 在 onboarding 流程中用 WhatsApp 扫描二维码连接账号
管理界面模块
| 模块 | 包含功能 |
|---|---|
| Inbox | WhatsApp 对话，AI 和人在同一界面协作 |
| Radar | 冷却线索预警（长时间无回复的 open deal） |
| Kanban | Pipeline 可视化，每个 deal 的销售阶段 |
| Funis | 自定义 pipeline 名称（叫"Lead"还是"Cliente"/"Paciente"） |
| Agentes | AI 智能体配置（多个 agent、Provider 切换、RAG 知识库） |
| Follow-ups | 自动跟进规则，触发时机可按 pipeline 阶段定制 |
| Webhooks | 收数据（入站 webhook）/发自动化/查执行日志 |
| RAG / Conhecimento | 每个租户的向量知识库 |
| Automations | WHEN/IF/THEN 规则引擎 |
AI 智能体核心操作（MCP 接口）
CRM 完整暴露 MCP 接口，AI 智能体可以直接： - 读取、更新联系人信息 - 移动 Pipeline 阶段 - 触发自动化 - 记录销售动作到审计日志
更新系统
方式 A（图形界面，推荐）： - 管理员登录后，检测到新版本时底部菜单亮起"新版本"按钮 - 点击进入「配置 → 更新」→ 显示变更说明 → 自动备份 → 逐步执行 → 完成 - 如果新版本有问题，自动回滚到上一版本
方式 B（命令行）：
cd /caminho/do/DeskcommCRM
bash hostgator-setup-kit/update.sh
脚本执行顺序：检查版本 → 备份数据库 → 下载新代码 → 更新 schema（幂等）→ 拉取新镜像 → 健康检查。
⚠️ 更新目标永远是正式发布版本（v1.2.3 格式），不是 main 最新 commit。
备份和恢复
# 备份（建议每天一次 cron）
bash hostgator-setup-kit/backup.sh
# 恢复
bash hostgator-setup-kit/restore.sh
# 健康检查
bash hostgator-setup-kit/healthcheck.sh
⚠️ Supabase 免费计划不自动备份，务必自己跑 cron 备份脚本。
故障排除
| 症状 | 排查 |
|---|---|
| 安装脚本报错 | 确认 Docker 已运行 + VPS 端口 80/443 未被占用 |
| 更新按钮不亮 | 确认 cron 自动化 agent 在运行（update agent 检查频率：每 5 分钟） |
| WhatsApp 连接失败 | 确认账号未因频繁操作被 WhatsApp 临时封禁（工具内有 throttle + jitter 防 ban） |
| 自动化不触发 | 检查 event-log-drain cron 是否运行（每小时检查一次） |
典型适用场景
- 销售团队用 WhatsApp 做生意：电商、诊所、房产、课程销售——把 WhatsApp 对话直接变成 CRM 线索
- 需要 AI 辅助但不想上 SaaS：数据主权敏感、东南亚/拉美/欧洲市场的多语言团队
- 多租户需要隔离：不同品牌/子公司共用实例，数据完全隔离（RLS）
- AI Agent 驱动的工作流：需要 AI 智能体不只是"回复聊天"而是真正执行 CRM 操作（移动 Pipeline、写任务、发跟进）
坑与注意
- Supabase 免费版无自动备份：一定要配 cron 跑
backup.sh，数据丢失无法恢复。 - WhatsApp QR code 连接有封号风险：文档提到有 throttle + jitter + 时间窗口防 ban 机制，但高频率操作仍可能触发 WhatsApp 限制。官方 Cloud API（Meta channel）是更稳定的替代方案，但需要已批准的 Message Template。
- LGPD 针对巴西市场：RLS + 匿名化 + 审计日志 + 5 年保留期设计，适合巴西业务，但其他地区需核实当地数据法规。
- 多语言界面：文档主要是葡萄牙语，英文 README 存在但部分内容缺失，介意需配合翻译工具。
- 预 1.0 阶段：非生产环境建议先在测试实例验证更新流程，特别是数据库 schema 变更。
与同类对比
| 方案 | 部署方式 | AI 能力 | 数据主权 | 适合规模 | |
|---|---|---|---|---|---|
| DeskcommCRM | Self-hosted / VPS | 内置 Agent + MCP | 原生 WAHA + Cloud API | 完全自有 | SMB |
| Kommo | SaaS | 基础 | 原生 | 第三方托管 | SMB-C |
| Octadesk | SaaS | 基础 | 集成 | 第三方托管 | SMB |
| Intercom | SaaS | AI Chatbot | 集成 | 第三方托管 | 中大型 |
| Custom (n8n + Supabase) | Self-hosted | 视配置 | 视配置 | 完全自有 | 技术团队 |
结论： DeskcommCRM 是目前 self-hosted 方案里 AI 集成度最高的 WhatsApp CRM，支持 MCP 让 AI 真正操作 CRM 而不只是"聊天"，适合不想上 SaaS 但又需要 AI Native 销售工具的团队。
一句话推荐结论
需要在 WhatsApp 上做销售、需要 AI 辅助跟进线索、又不信任把数据交给 SaaS 提供商——DeskcommCRM 是目前最完整的开源 self-hosted 方案，一条命令装好，AI 智能体直接操作系统 CRM。