快速上手 twenty 开源 CRM从部署到定制完整指南【免费下载链接】twentyThe open alternative to Salesforce, designed for AI.项目地址: https://gitcode.com/GitHub_Trending/tw/twenty主流商业 CRM 一年订阅费动辄上千美元数据还锁在别人的表结构里想换系统先花几个月导数据而免费替代品往往字段僵化、API 残缺。twenty 开源 CRM 给出的答案是数据模型你自己定义、工作流自动化可视化编排、AI 原生内建而且代码完全在你手里。这篇文章覆盖从 5 分钟部署、核心能力、四条定制路径到高频报错速查的完整流程。 为什么值得看它商业 CRM 的痛点很具体每用户每月几十美元的订阅费、导出数据要提工单、想加一个字段得等供应商发版。twenty 的定位一句话Salesforce 的开源替代专为 AI 设计——它把联系人、交易、工作流这些核心能力全部开放在可自托管的代码里而不是锁在 SaaS 黑盒中。对你来说这意味着三件事成本归零只剩服务器开销数据在自家 PostgreSQL 里随时可迁改任何行为都是改代码、提 PR而不是填功能请求表。 跑起来5 分钟部署 twenty 开源 CRM最简路径是一行命令curl -fsSL https://gitcode.com/GitHub_Trending/tw/twenty/raw/branch/main/packages/twenty-docker/scripts/1-click.sh | bash它会装好 Docker、拉取twentycrm/twenty镜像并起 4 个容器server、worker、PostgreSQL 16、Redis想用指定版本就加前缀如VERSIONv0.32.4 bash 1-click.sh。上面这张图是 Helm 部署的组件拓扑Docker Compose 部署同理server 和 worker 各占一个容器数据落 PostgreSQL队列走 Redis。跑完后浏览器访问http://localhost:3000出现登录/注册界面即成功健康检查打http://localhost:3000/healthz返回 200 就放心。本地开发环境clone 后 yarn 起栈git clone https://gitcode.com/GitHub_Trending/tw/twenty cd twenty yarn install yarn nx serve twenty-front这套命令走 Nx 构建系统起完整前后端前提是 Node 24.5 和 yarn 4首次编译约 1-2 分钟期间终端无输出属正常。生产部署Compose 与 K8sDocker Compose 清单里server服务映射3000:3000端口db是 postgres:16redis带noeviction策略规模化部署换 Kubernetes 清单 即可。仓库关键目录packages/twenty-front/React 前端视图与设置页packages/twenty-server/NestJS 后端引擎与核心模块packages/twenty-docs/全套文档源mdx仓库内直接可读packages/twenty-apps/官方应用示例可直接装进工作区 能做什么three 个场景拆解核心能力twenty 的价值不在功能数量而在数据模型、自动化和 AI 这三件事都开放给了你。自定义对象与字段业务对象不进代码库能力定义工作区的数据模型完全由你在 UI 里定义不需要改任何代码。三步操作设置页「Objects」→ 新建对象如「项目」→ 配字段与关联。预置了公司、联系人、交易你加一个「合同」对象并与交易关联后它立刻出现在表格、看板、日历视图里权限和过滤器同步生效。业务场景SaaS 团队加「项目」和「合同」两个对象销售在交易下挂合同项目里关联开票记录——全程没动一行代码。工作流触发器写法事件到动作全可视能力定义用「触发器 → 过滤 → 动作」链条把业务事件变成自动化。三步操作Workflows 页点 New → 选触发器如记录状态变化→ 挂动作创建记录、发通知、调外部 API可视化编辑器里直接跑通再发布发布前可以校验每一步。业务场景当交易状态变为Won时工作流自动创建合同对象、给负责人发通知、调外部计费 API——触发器写法就是这套可视化 DSL逻辑全在 workflow 引擎模块里。AI 原生命令菜单里的 Skills 与 Agents能力定义AI 不是套壳聊天框而是以 Skills/Agents 形式内建命令菜单/直接调用。三步操作打开任意记录 → 敲/打开命令菜单 → 选一个内置 Agent比如总结客户历史或起草跟进邮件。业务场景打开一个联系人的详情页敲/总结Agent 读该联系人的时间线活动回吐一段历史摘要和下一步建议它调用的能力来自 code-interpreter 等后端模块。 改起来四条定制路径定制 twenty 只需要四条路改配置、改数据模型、写应用、调 API全部有明确入口。改配置动 3 个环境变量# packages/twenty-docker/.env部署时生成 SERVER_URLhttps://crm.example.com # 公网访问地址 ENCRYPTION_KEY*** # 至少 32 字节 REDIS_URLredis://redis:6379改完重启容器生效APP_SECRET、EMAIL_SMTP_HOST按需补充Compose 清单里每个变量都有注释。加字段或对象用 twenty-sdk 声明式定义import { defineMyObject } from twenty-sdk; export const myContract defineMyObject({ nameSingular: contract, fields: [ { name: amount, type: number }, { name: deal, type: relation, target: deal }, ], });这段放在应用里随包发布字段立即出现在对象上深挖看 apps 文档的extending-objects.mdx。写插件或应用三步脚手架npx create-twenty-applatest my-twenty-app cd my-twenty-app yarn twenty dev脚手架生成项目、自动拉一个本地 Docker 版 twenty 并认证dev模式热重载 自动刷新类型化客户端。现成示例直接读 postcard 应用 的源码最快。调 APIREST 与 GraphQL 双通道curl -H Authorization: Bearer 你的API_KEY \ http://localhost:3000/api/rest/v1/peopleREST 适合外部系统同步GraphQL 适合前端细粒度查询capabilities 文档 里apis.mdx和webhooks.mdx分别覆盖调用与回调。 卡住了高频问题速查症状原因解法yarn twenty dev提示 Docker 不可用Docker 守护进程没启动docker info确认然后yarn twenty docker:logs看容器日志应用鉴权失败请求全部 401本地 API Key 过期或换过工作区重新执行yarn twenty remote:add完成认证编辑器里twenty-sdk类型没生成dev 进程没在跑客户端没刷新保持yarn twenty dev常驻它会自动生成类型化客户端3000 端口被占页面打不开本机已有服务占位改 Compose 的3000:3000映射为3001:3000后重启首次启动终端无输出超过 5 分钟server 在跑 PostgreSQL 初始化迁移属正常用curl http://localhost:3000/healthz轮询返回 200 即就绪 接着玩资源与参与文档packages/twenty-docs/ 仓库内全套 mdx开发者文档入口在developers/目录社区官方 Discorddiscord.gg/cx5n4Jzs57核心开发每周开会决策过程公开贡献读 AGENTS.md 和 CLAUDE.md 了解协作约定PR 提到 main 分支即可fork 下来改一个SERVER_URL环境变量两分钟就能跑通你的第一台私有 twenty再或者把 postcard 应用 装进工作区跑一遍里面的逻辑函数定制路径就全通了。【免费下载链接】twentyThe open alternative to Salesforce, designed for AI.项目地址: https://gitcode.com/GitHub_Trending/tw/twenty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考