melgarafael DeskcommCRM

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 端口 root@你的IP

把 端口 和 你的IP 换成你自己的。如果主机商没有提到任何端口，那就是默认端口（22），可以省略：

ssh root@你的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）。
• 用你选择的邮箱和密码创建第一个管理员。
• 启动整个技术栈，自动配置 HTTPS，并在最后检查健康状况。
• 安装自动化的 cron（没有它，WHEN/IF/THEN 规则会卡在队列里）和更新代理，正是它让屏幕上出现“立即更新”按钮。

再次运行不会破坏任何东西——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”。也有用于按细分行业搭建客户、分析指标、调优代理提示词和贡献的指南（AGENTS.md，“助手指南”一节）。

通过界面（推荐）

当有新版本时，侧边栏菜单底部会亮起“新版本”——只对服务器所有者显示，因为通知无法更新的人只是噪音。点击后你会进入 设置 → 更新，那里会显示变更内容、自动备份数据库，并跟踪每个阶段（备份 → 代码 → 数据库 → 上线）直到完成。无需 SSH。

如果新版本上线后出问题，代理会自行回退到之前的镜像，并把这次回退写入 .env——没有它，下一次重启会带回那个应用……