melgarafael DeskcommCRM

🇧🇷 葡萄牙语 · 🇺🇸 英语 · 🇪🇸 西班牙语

🛠️ DeskcommCRM — 面向 WhatsApp 的 AI 销售操作系统，开源

在 WhatsApp 上接待、筛选并完成销售的 AI 智能体——运行在你自己服务器上的开源 CRM 之中。无月费，无功能锁定，数据归你所有。Kommo、Octadesk 和 Intercom 的开源替代方案。

⚡ 安装 · 🔄 更新 · 🧭 概览 · 🏗️ 架构 · 🤝 贡献 · 🗺️ 路线图

☁️ 用一条命令在生产环境运行这个 CRM

DeskcommCRM 与 HostGator 合作开发：hostgator-setup-kit/ 只需一条命令即可在 VPS 上安装完整的 CRM（应用 + WhatsApp + 数据库），生产环境 runbook 也已默认采用该环境。

👉 以合作折扣订阅 HostGator VPS——数据中心位于圣保罗，非常适合 24/7 运行 WhatsApp。（合作伙伴链接——通过它订阅可支持本项目，且价格更优惠）

还没有服务器？在你的电脑上（macOS、Linux 或 WSL）运行以下命令。它会告诉你该购买哪个套餐——依据 runbook 中的具体数字，而不是一句“看情况”——并为你返回适合你情况的正确命令：

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/hostgator-setup-kit/comecar.sh | bash

（更想先读再执行？克隆仓库并运行 bash hostgator-setup-kit/comecar.sh——未经你确认，它不会安装任何东西。）

⚡ 在你的 VPS 上安装（主要路径）

1. 进入你的 VPS

在你的电脑上打开终端（Windows 上是 PowerShell；Mac 或 Linux 上是 Terminal），用托管商通过邮件发给你的 IP 和端口连接：

ssh -p PORTA root@SEU_IP

将 PORTA 和 SEU_IP 替换为你自己的。如果托管商没有提到任何端口，那就是默认端口（22），可以省略：ssh root@SEU_IP。

它会要求输入密码。输入时屏幕上不会显示任何内容——连星号都没有。这不是卡住了：是终端在隐藏密码。输入（或粘贴）后按回车。

首次连接时它会问 Are you sure you want to continue connecting?——回答 yes。这是服务器第一次向你自我介绍。

2. 运行安装程序

进入 VPS 后：

git clone https://github.com/melgarafael/DeskcommCRM.git
cd DeskcommCRM
bash hostgator-setup-kit/install.sh

就这样。你不需要安装 Node，不需要 pnpm，也不需要编译任何东西——应用镜像已经准备好了。如果缺少 Docker，安装程序会询问并自行安装。

你需要准备的东西

| 项目 | 从哪里获取 | | --- | --- | | 带 Docker 的 VPS | HostGator（合作）——或任何带 Docker 的 VPS。推荐 4 GB 内存 | | 域名 | 一条指向 VPS IP 的 A 记录（例如：crm.suaempresa.com.br） | | 数据库 | supabase.com 上的免费账户——3 个密钥 + Session pooler 的连接字符串 | | AI | 一个 OpenRouter、Anthropic 或 OpenAI 的密钥——安装程序会问你要用哪个 | | WhatsApp | 你的号码，在 onboarding 中通过二维码连接（或 Meta 的官方渠道） |

💡 Supabase 可以由安装程序本身创建。在运行前导出一个 SUPABASE_ACCESS_TOKEN，它就会创建项目、等待数据库健康、获取 4 项凭据，并通过测试真实连接来发现 pooler 主机——无需复制粘贴。

安装程序为你做的事

它只问你自己的东西（域名、密钥、管理员密码），在继续之前验证每个回答——密钥错误它会当场拒绝，而不是三步之后——其余的交由它处理：

自行生成所有技术密钥（你不需要编造任何密码）。
创建 Postgres 扩展并应用完整 schema（supabase/baseline.sql）。
用你选择的邮箱和密码创建第一个管理员。
启动整个 stack，自动配置 HTTPS，并在最后检查健康状况。
安装自动化 cron（没有它，QUANDO/SE/ENTÃO 规则会卡在队列中）和更新代理，正是它让屏幕上存在“立即更新”按钮。

再次运行不会破坏任何东西——install.sh 是幂等的：不会重复创建 cron，不会重建用户，会从上次中断处继续。

非交互模式：将 .env.hostgator.example 复制为 .env，填写后运行 bash hostgator-setup-kit/install.sh --yes。

其他托管商？（Hostinger、Coolify、Dokploy、CapRover……）

可以。如果你的 VPS 自带一个反向代理占用了 80/443 端口，安装程序会自行检测并通过它发布 CRM，而不是尝试启动一个放不下的 Caddy。在一种特定情况下——代理使用 --network host，就像 Hostinger 那样——它会询问而不是猜测，因为在错误代理后面发布，会“成功”安装一个哑巴站点。详情见 hostgator-setup-kit/README.md。

首次访问

打开 https://<你的域名>（锁标志大约 1 分钟后出现），用管理员登录，如果你想启用两步验证，请准备好 Google Authenticator 或 Authy——它是可选的，位于设置 › 安全；首次登录不要求它。在 onboarding 中，用你的号码的 WhatsApp 扫描二维码。

🤖 更想让 AI 帮你安装？

把 hostgator-setup-kit/ 文件夹丢进在 VPS 内运行的 Claude Code 聊天中，然后说“帮我安装 DeskcommCRM”。它会读取该套件的 CLAUDE.md——其中包含步骤和已梳理的陷阱——并用葡萄牙语引导整个过程。

🔄 更新

出新版本了？有两条路径，第一条不需要终端。

在已克隆仓库的情况下，安装指南已经内置——.agents/skills/deskcomm-instalar/——并会在该文件夹中打开的 Claude Code、Codex、Cursor、OpenCode 或 Antigravity 中自动加载。只需说“我想在我的 VPS 上安装 CRM”。还有用于按细分市场构建客户、分析指标、调整智能体 prompt 和贡献的指南（AGENTS.md，“助手指南”部分）。

通过界面（推荐）

当有新版本时，侧边栏菜单的页脚会亮起“新版本”——只对服务器所有者显示，因为通知无法更新的人是噪音。点击后你会进入设置 → 更新，其中显示变更内容、自行备份数据库，并跟踪每个阶段（备份 → 代码 → 数据库 → 上线）直到完成。无需 SSH。如果新版本上线后出问题，代理会自行回退到之前的镜像，并将这次回退记录到 .env——没有它，下一次重启会带来那个应用……