一、这是什么？
Chatwoot 是一个开源的全渠道客户支持平台（Omnichannel Helpdesk）。
简单来说：你开公司做电商/SaaS/在线服务，需要一个统一的客服工作台收邮件、收网站聊天、收 WhatsApp 消息、分配给客服同事处理——Chatwoot 就是干这个的，而且免费、可自托管、数据完全自己掌控。
📊 关键数据
| GitHub Stars | 31K+ |
| 总提交数 | 6,364 次（极高活跃度） |
| 当前版本 | v4.15.1（2026-06-17） |
| 开源协议 | MIT License（完全自由，可商用） |
| 仓库地址 | github.com/chatwoot/chatwoot |
二、它解决什么痛点？
商业客服系统有几个老问题：
- 贵——Intercom、Zendesk 按坐席数收费，10 个客服一年轻松过 10 万
- 数据不在自己手里——客户对话数据存在第三方服务器
- 不能深度定制——业务流程跑通了想改，告诉你这是「企业版功能」
- 渠道割裂——邮件、聊天、WhatsApp 在不同系统里切换
Chatwoot 一次解决：
- 零授权费——MIT 协议，源码可改可商用
- 自托管——Docker 部署在自己的服务器
- 全渠道统一——一个工作台收所有渠道消息
- 可深度定制——源码开放，业务流程自己改
三、核心功能模块
1. 全渠道消息聚合
| 渠道 | 支持状态 |
|---|---|
| 网站实时聊天 | ✅ 官方 widget |
| 邮件支持 | ✅ 完整支持，含附件流式处理 |
| ✅ 官方渠道 | |
| Facebook Messenger | ✅ 官方渠道 |
| Twitter/X | ✅ 官方渠道 |
| Telegram | ✅ |
| SMS | ✅ |
| API 渠道 | ✅ OpenAPI 文档 |
2. 自动化与 AI
- AI Agent (Captain)——OpenAI 集成，LLM 自动回复
- SLA 自动化——自动评估、分配、跟踪
- 情感分析——自动识别客户情绪
- 工作流引擎——ActionService 业务规则自动化
3. 报告与分析
- 实时仪表板——今日会话量、平均响应时长、客户满意度
- 报告下钻——点击柱状图查看具体对话细节
- 多语言支持——含 RTL 语言界面
4. 帮助中心
- 客户自助文档站点，自定义域名
- 文章搜索（Elasticsearch），多语言门户
- Captain 支持 RAG——基于帮助中心文章的检索增强生成
四、技术架构
| 层级 | 技术栈 |
|---|---|
| 后端语言 | Ruby 3.4.4 |
| 后端框架 | Rails 7 |
| 前端框架 | Vue 3 + Vite |
| 状态管理 | Pinia |
| Node 版本 | v24.13 LTS |
| 任务队列 | Sidekiq + Sidekiq-cron |
| 主数据库 | PostgreSQL |
| 搜索引擎 | Elasticsearch |
| 缓存 | Redis |
| 测试 | RSpec + Vitest + Playwright |
架构亮点：全栈现代化——Ruby 后端 + Vue 3 前端，比老牌客服系统的 jQuery 老古董干净太多。前后端分离（Vite 替代 Webpacker），AI 原生（Captain 不是外挂插件，是核心模块），仓库根目录有 AGENTS.md 和 CLAUDE.md 专门给 AI 编程代理写的协作规范。
五、怎么部署？
方式一：Docker（推荐）
git clone https://github.com/chatwoot/chatwoot.git cd chatwoot cp .env.example .env # 编辑 .env，配置数据库密码、Redis 等 docker-compose up -d
方式二：自托管 systemd
仓库 deployment/ 目录提供完整 systemd service 配置（web + worker），适合生产环境裸机部署。
cwctl upgrade # 一键升级、备份、监控
方式三：Heroku / Clever Cloud
仓库根目录有 app.json，点击 Heroku Deploy Button 就能部署。
方式四：GitHub Codespaces
仓库有 .devcontainer/ 配置，可直接在浏览器里试用开发环境。
方式五：官方 Cloud 版
chatwoot.com 提供托管服务，按月付费，不想运维的选择。
六、谁在用？
不太适合
- 完全没技术团队的公司——建议用 Cloud 版
- 10 人以下超小团队——免费版 SaaS 可能更省事
- 只要邮件工单——简单邮件转发规则就够
七、横向对比
| 维度 | Chatwoot | Zendesk | Intercom | Freshdesk |
|---|---|---|---|---|
| 价格（10坐席） | 0（自托管） | ~$5,000/年 | ~$7,000/年 | ~$2,000/年 |
| 开源 | ✅ MIT | ❌ | ❌ | ❌ |
| 可自托管 | ✅ | ❌ | ❌ | ❌ |
| 渠道数 | 10+ | 5+ | 5+ | 6+ |
| AI Agent | ✅ Captain | ✅ 付费 | ✅ 付费 | ✅ Freddy |
| API 完整度 | 高 | 高 | 中 | 中 |
结论：如果你的团队有 1 个懂 DevOps 的人，Chatwoot 是性价比最高的选择。如果完全没技术背景，选 Cloud 版或 Freshdesk。
八、近期更新亮点
| 时间 | 功能 |
|---|---|
| 2026-07-02 | 报告下钻 RTL 修复、SLA 屏蔽联系人处理 |
| 2026-06-29 | AI Agent trace 属性——LLM 调试可观测性 |
| 2026-06-24 | Cloudflare RealtimeKit 迁移——视频通话更稳定 |
| 2026-06-16 | 语音通话 widget 品牌定制 |
节奏：几乎每天都有新提交，对自托管项目来说这种维护强度很罕见。
九、避坑指南
自托管前必看
- 资源需求——至少 2 核 4GB 内存（推荐 4 核 8GB），PostgreSQL + Redis + Elasticsearch 三件套都要装
- Elasticsearch——至少 1GB 堆内存，文档量大需要更多
- CDN 必备——网站聊天 widget 加载慢会影响转化
- 备份策略——PostgreSQL 每日备份，Elasticsearch 定期重建
升级注意
- 项目走 develop 分支持续滚动，生产环境建议用 tags 而非分支
cwctl工具是自托管升级利器，能自动停服、迁移、启动- 升级前看 CHANGELOG，注意数据库迁移
商业使用
- MIT 协议可商用——但要在 About 页面保留版权声明
- AI Agent (Captain) 接入 OpenAI 需要海外信用卡，国内团队可换成 DeepSeek/通义千问
- 中文支持需要单独配置翻译文件（默认 i18n 不全）
- 移动端只有响应式 Web，没有原生 App
十、API 与扩展
完整的 OpenAPI 3.0 文档（swagger/ 目录），可对接第三方 CRM、数据分析平台、自定义工作流、移动端 App。
Webhook
- 新消息触发、对话状态变化触发、客户满意度评价触发
AI Agent 集成
- Captain 支持自定义 LLM（不限于 OpenAI）
- 支持 RAG（基于帮助中心文章的检索增强生成）
十一、上手 30 分钟路线
- 5 分钟——访问 chatwoot.com 注册 Cloud 试用版，看界面
- 10 分钟——GitHub 读 README，了解部署方式
- 10 分钟——Codespaces 启动开发环境，跑起来本地实例
- 5 分钟——配置一个网站聊天 widget，集成到测试页面
选型决策树
- 团队 < 5 人 + 无运维 → 用 Cloud 版或 Freshdesk
- 团队 5-50 人 + 有运维 → 自托管 Chatwoot（最佳性价比）
- 团队 > 50 人 + 复杂业务 → 评估企业版 SLA/报告功能
- 隐私要求高 → 强制自托管
十二、总结
Chatwoot 的核心价值：
- 不是更便宜，而是更可控——数据在自己手里，业务流程自己定
- 不是更多功能，而是更开放——MIT 协议 + 完整 API = 无锁定
- 不是社区玩具，而是企业级产品——31K Stars + 几乎每天更新 + 完整企业版
如果你的客服数据是核心资产，Zendesk/Intercom 的授权费+数据托管是隐形税，Chatwoot 是开源世界里最成熟的替代方案。