Twenty 开源 CRM

由 twentyhq 制作工具包商务

新上架第 2 版 · 更新于 2026-11-09

星标60.6k

一款开源的 CRM，主要采用 AGPLv3 许可，你的团队可以用云端版、自己托管，或者用 TypeScript 应用来扩展它。安装说明涵盖 Docker Compose、源码检出、应用 CLI，以及面向 Claude Code、Codex 和 Cursor 的 MCP 与智能体技能。

Twenty 开源 CRM 是一款 GitHub 上的开源项目，属于商务类，由 Mindket 上架。可免费获取。当前为第 2 版，最近更新于 2026-11-09。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取，以 zip 压缩包下载。

速览

用在

Google 和 Microsoft 的邮箱与日历，还有走 SMTP 的邮箱和走 CalDAV 的日历
工作流：支持记录、手动、定时和 webhook 触发，步骤可以调用 HTTP 地址或运行 JavaScript
按你自己的工作区结构生成的 REST 和 GraphQL API，另有一套管理对象和字段的 Metadata API
一个 MCP 服务器，可接 Claude Desktop、Claude Code、Cursor、ChatGPT 和其他客户端

先运行

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

平台

Claude Desktop桌面应用

Claude Code编程智能体

Cursor代码编辑器

ChatGPTAI 对话

Codex编程智能体

Docker容器

关于

它是什么

Twenty 是一款开源的 CRM，你的团队可以按自己的业务来塑造它。它自带公司（Companies）、联系人（People）、商机（Opportunities）、任务（Tasks）和笔记（Notes），你还可以在旁边添加自定义对象和字段。邮件和日历同步把记录填满，视图和工作流负责日常的活儿，AI 智能体在你的权限模型之内行动。你可以用云端产品，自己托管，或者用 TypeScript 写的应用来扩展它。

你注册云端版，或者启动自己的服务器
连接一个邮箱，让真实的邮件和会议进来
塑造对象和字段，再从 CSV 导入记录
为日常工作建立视图和工作流
需要更多时，用 AI 聊天、接上 MCP 或加一个应用

适合谁

有开发人员、想要一个可以重塑的 CRM 的团队，以及必须把客户数据放在自己服务器上的组织。Meet Twenty 页面直白地说了谁该去看别的产品：想要一个完全不用操心的 CRM 的团队，以及今天就需要几百个现成集成的公司。

谁在用，怎么用

行业	谁在用	怎么用	例子
销售团队	要跟踪商机和联系人的团队	把公司、联系人和商机放在一起，每条记录上都有同步来的邮件	一位销售在 Settings，Accounts 下连接 Google 账号，和某位联系人的邮件、会议就会出现在那条记录上。
初创公司	已经用腻电子表格和 Notion 的技术型创始人	把业务建成自定义对象和字段	一位创始人按 Quickstart 的建议，给 People 加一个 Person Type 字段，而不是另建一个没有邮件历史的对象。
市场进入（GTM）团队	想要自己的线索评分或数据补全的团队	用一个触发器加一串步骤来搭工作流	Workflows 页面把“商机到达某个阶段时发一条 Slack 提醒”列为可以搭的东西之一。
自托管的组织	必须自己掌握数据、注重隐私的团队	运行 Docker Compose 安装，并且不让它暴露在公网	管理员走 Securing 页面上的 Tailscale 路线，把服务器端口绑定到 127.0.0.1，用 sudo tailscale up --hostname=twenty 加入 tailnet，再运行 sudo tailscale serve --bg 3000。
开发者和机构	懂 TypeScript 和 React 的团队	做一个应用，加上对象、逻辑函数和前端组件	开发者用 twenty app init 搭好骨架，让 twenty app dev 一直运行，改过的文件一秒内就会在界面里出现。
用 AI 的团队	通过编程智能体工作的人	把一个 MCP 客户端连到工作区	用户把工作区的 /mcp 地址加到 Claude Code 里，问“最近创建的 5 家公司”，这是 MCP 页面里的一个提示词。

用在哪里

Twenty 在浏览器里打开，可以在云端，也可以在你自己运行的服务器上。它可以通过下面这些方式接到其他工具。

Google 和 Microsoft 的邮箱与日历，还有走 SMTP 的邮箱和走 CalDAV 的日历
工作流：支持记录、手动、定时和 webhook 触发，步骤可以调用 HTTP 地址或运行 JavaScript
按你自己的工作区结构生成的 REST 和 GraphQL API，另有一套管理对象和字段的 Metadata API
一个 MCP 服务器，可接 Claude Desktop、Claude Code、Cursor、ChatGPT 和其他客户端
应用：能加上对象、逻辑函数和前端组件，可以私下部署，也可以上架 Twenty 应用市场
官方的智能体技能，用来开发应用，用 skills CLI 安装，或者作为 Codex 插件安装

运行方式

路线	你运行什么	文档怎么说
云端	什么都不用运行，在 app.twenty.com 注册	先选一个试用，Stripe 确认之后再设置工作区名称和个人资料，随时可以取消
Docker Compose	安装脚本，或者下载下来的 .env 和 docker-compose.yml	用于生产托管或自托管，至少 2GB 内存，Docker Compose 要保持最新
源码检出	Git、Node 26.5.1 或之后的 26.x（根目录 package.json 的 engines）、Yarn 4、PostgreSQL 和 Redis	Local Setup 页面是写给贡献者和好奇的开发者的，用 nx 启动服务器、worker 和前端
本地应用环境	twenty local start 命令	在 Docker 里运行网页界面、API、worker 和数据库，用于开发应用，默认监听回环地址的 2020 端口

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按制作者的 README 和文档，给每种运行方式和每个智能体各写了一页。云端路线不需要安装。自己的服务器只要一条命令。

先准备好这些

需要	说明
云端	一个浏览器，以及 Google、Microsoft 或邮箱登录
Docker Compose	一台装好 Docker 和 Docker Compose 的服务器或电脑，至少 2GB 内存
应用	Node.js 24（24.5 起）或 Node.js 26（26.5.1 起），不包括 Node 25，通过 Corepack 用 Yarn 4，再加 twenty CLI。开发应用官方只支持 macOS 和 Linux，Windows 上要在 WSL 2 里进行
源码检出	Git、Node 26.5.1 或之后的 26.x、Yarn 4、nvm、PostgreSQL 和 Redis，不能用 npm
MCP	一个你能登录的工作区，和一个支持 streamable HTTP 服务器的 MCP 客户端

如果服务器上还没装 Docker 和 Docker Compose，先装上。
运行下面这条命令。
在你自己的电脑上打开 http://localhost:3000。在服务器上，用 curl http://localhost:3000 检查。
把 .env 文件里的 SERVER_URL 设成大家访问用的地址，然后重启。

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

Docker Compose 页面在同一行前面加上 VERSION 来固定版本，例如 VERSION=v2.38.1。它必须是发布在 Docker Hub 上的完整发布标签，v2 或 latest 这样的别名不被接受。改过 SERVER_URL 之后要重启，页面给的是下面这两行。

docker compose down
docker compose up -d

如何使用

Quickstart 说先从邮箱开始，因为真实的数据能让你的团队在改动其他东西之前就先用上。

打开 Settings，再打开 Accounts，连接一个 Google 或 Microsoft 账号。别的服务商可以在同一页通过 SMTP 添加邮箱，通过 CalDAV 添加日历。在自托管的服务器上，管理员要先在 Settings，Admin Panel，Configuration Variables 下设置一个 Google Cloud OAuth 客户端或一个 Azure 应用。Setup 页面里的日历和邮件 cron 任务，接着必须在 worker 里运行。Microsoft 用户需要 Microsoft 365 许可，个人 Microsoft 账号暂不支持。
打开 Settings，再打开 Data Model。给 People、Companies 和 Opportunities 加字段，其余的建成自定义对象。
按 Cmd+K 或 Ctrl+K 打开命令菜单，导入一个 CSV。先下载示例文件，并且先给邮箱和域名去重。
然后建视图和工作流。一个工作流由触发器、步骤和变量组成。

什么会启动工作流

触发器	何时触发
记录事件	一条记录被创建、更新、删除或 upsert
手动	用户在一条记录、多条记录或全局点一个按钮
定时	按 cron 语法写的重复间隔
Webhook	外部系统发来一个 HTTP POST

AI 聊天会回答关于你的记录的问题。智能体通过角色工作，所以要在 Settings，再 Members，再 Roles 下设置它们的访问范围。AI 页面给了这几个提示词。

What opportunities are closing this month?
Which deals have been in Negotiation for more than 30 days?
Summarize my interactions with this person

示例

你想看看本月哪些商机会成交。你注册云端版，连接邮箱，把商机连同成交日期从 CSV 导入。然后打开 AI 聊天，这样问：

What opportunities are closing this month?

聊天能访问你的工作区数据，所以它会根据你的记录回答。聊天会消耗工作区的 AI credits。

新手与专家

新手：CRM 是团队存放公司、联系人和商机的地方。在 Twenty 里，它们就是 Companies、People 和 Opportunities 这几个对象，而工作区是存放你团队数据的空间。自托管的意思是，服务器运行在你自己控制的电脑上。

专家：大部分设置在应用里，位于 Settings，Admin Panel，Configuration Variables 下。PG_DATABASE_URL、SERVER_URL 和加密密钥这类基础设施设置，只能在 .env 文件里设，而 IS_CONFIG_VARIABLES_IN_DB_ENABLED=false 会把所有设置都挪到那里。ENCRYPTION_KEY 用来加密保存在库里的 OAuth 令牌、应用变量和 TOTP 密钥。丢了它，就等于丢了数据库里每一个密钥的访问权。

Securing 页面把一个实例分成私有区、给 /webhooks、/s 和 /emailing 用的公开区，以及给云端 AI 连接器用的 /mcp、/oauth 和 /.well-known 区。工作流 webhook 只检查工作区和工作流是否存在，所以任何知道网址的人都能触发它。在生产环境里，逻辑函数和代码解释器的驱动一开始是禁用的，而 LOCAL 驱动没有沙箱。

Apps 页面说，逻辑函数在与主机隔离的 Node.js 进程里运行，前端组件通过 Remote DOM 在 Web Worker 里运行。在自托管的服务器上，隔离程度取决于驱动：Setup 页面说 LOCAL 没有沙箱，并且为不受信任的代码点名了 LAMBDA。一个应用只能看到它的角色允许的内容。README 里用代码定义一个对象是这样的。

import { defineObject, FieldType } from 'twenty-sdk/define';

export default defineObject({
  nameSingular: 'deal',
  namePlural: 'deals',
  labelSingular: 'Deal',
  labelPlural: 'Deals',
  fields: [
    { name: 'name', label: 'Name', type: FieldType.TEXT },
    { name: 'amount', label: 'Amount', type: FieldType.CURRENCY },
    { name: 'closeDate', label: 'Close Date', type: FieldType.DATE_TIME },
  ],
});

通过 MCP，文档说先调用 learn_tools 取得工具的结构，再调用 execute_tool。

注意事项

服务器由你来运行，所以照看它是你的事。下面这些来自仓库和文档。

许可证：主要是 AGPLv3，另有 LICENSE 文件所称的 Twenty Application Exception 这一额外许可。以 /* @license Enterprise */ 开头的文件属于商业许可，文件里说生产使用需要和 Twenty 约定的条款，以及有效的 Enterprise Edition 订阅。twenty CLI、各个 SDK、twenty-ui 和 packages/twenty-apps 下的应用是 MIT。GitHub 把许可证标成 Other，所以在你为别人运行修改过的副本之前，先读 LICENSE 文件
备份：Docker Compose 页面给了一行 pg_dump 和一行恢复命令。它说要测试恢复，把副本放在异地，并且加密
升级：先备份，用 docker compose down 停掉 Twenty，改 .env 里的 TAG，再运行 docker compose up -d。服务器在启动时运行迁移。2.34 及更新的版本需要 PostgreSQL 15 或更新，早于 v1.23 的实例必须先一个大版本一个大版本地升到 v1.23
全新安装：页面对 Postgres 密码错误给的办法是 docker compose down --volumes，它会永久删除所有数据库数据。只在还没存任何东西时用
暴露：Securing 页面说要让实例远离公网，只开放你需要的路径。IP 白名单检查的是请求来自哪个网络，不是谁发的
MCP 密钥：API 密钥能访问工作区数据。别放进版本控制，并且给它一个适合这项工作的角色
源码检出：用 yarn，不要用 npm。Node 26 不再自带 Corepack，所以要先装它
对外发送的数据：这些说明用到的页面没有描述自托管服务器的使用数据。Setup 页面说，AI 文件附件会以用 SERVER_URL 拼出的链接交给模型，所以 SERVER_URL 是 localhost 或私有地址时，AI 聊天和智能体只能处理文本。助手通过 MCP 读到的内容都会发给那个助手
套餐：Quickstart 提供需要绑卡的 30 天试用，或者不需要绑卡的 7 天试用。工作流、AI 智能体和 AI 聊天共用一份 credits 余额，Usage Limits 页面可以限制花费。这些说明不写价格

README 和文件

README

Twenty：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Twenty、它的 twenty CLI 和它的智能体技能都来自 Twenty 的仓库：https://github.com/twentyhq/twenty

这些说明不是 Twenty 的维护者写的，也没有得到他们的认可。仓库把自己描述为“The open alternative to Salesforce, designed for AI.”，意思是：Salesforce 的开源替代品，为 AI 而设计。文档在 https://docs.twenty.com

许可证：混合。LICENSE 文件（https://github.com/twentyhq/twenty/blob/main/LICENSE）说，这个项目主要采用 GNU Affero 通用公共许可证 v3.0，另有一项它称为 Twenty Application Exception 的额外许可，并有两个例外：

以注释 /* @license Enterprise */ 开头的文件采用商业许可，不是 AGPLv3。这份许可说，它们只有在同意 Twenty 的条款并持有有效的 Twenty Enterprise Edition 订阅时才可用于生产，而为了开发和测试，你无需订阅也可以复制和修改它们。
有些软件包改用 MIT 许可证：twenty CLI、twenty-sdk、twenty-client-sdk、create-twenty-app、twenty-shared、twenty-ui 组件库，以及 packages/twenty-apps 下的应用。

GitHub 的仓库页面把许可证标成“Other”。在你为别人运行修改过的副本之前，请先读 LICENSE 文件。

会安装什么

云端：什么都不装。你在 https://app.twenty.com 注册。来源见 https://docs.twenty.com/getting-started/quickstart.md
用 Docker Compose 自托管：.env 和 docker-compose.yml 这两个文件，以及 compose 文件启动的容器。Docker Compose 页面提到了名为 server 和 worker 的服务，以及一个 twenty-postgres 容器，并说 REDIS_URL 在 docker-compose.yml 里有默认值。来源见 https://docs.twenty.com/developers/self-host/capabilities/docker-compose.md
源码检出，给贡献者用：仓库、PostgreSQL、Redis，以及 yarn 安装的 Node 包。来源见 https://docs.twenty.com/developers/contribute/capabilities/local-setup.md
应用：用 npm 全局安装的 twenty CLI，以及一个包含 twenty-sdk 和 twenty-client-sdk 的项目。来源见 https://docs.twenty.com/developers/extend/apps/getting-started/quick-start.md
智能体技能：五个技能，由 skills CLI 安装到你的智能体里，每个都带着它需要的参考文档，或者一个名为 twenty 的 Codex 插件。来源见 https://github.com/twentyhq/twenty/blob/main/SKILLS.md
MCP：不用安装。你在智能体的配置里加一条服务器条目。来源见 https://docs.twenty.com/user-guide/ai/capabilities/mcp.md

事先需要准备

云端：一个浏览器，以及 Google、Microsoft 或邮箱登录。
Docker Compose：一台装好并更新到最新 Docker 和 Docker Compose 的服务器或电脑，至少 2GB 内存。页面警告说，内存太少可能导致进程崩溃。
应用：Node.js 24（24.5 起）或 Node.js 26（26.5.1 起），应用的故障排查页面给出的是 engines.node: ^24.5.0 || ^26.5.1，并通过 Corepack 使用 Yarn 4。应用指南说，开发应用官方只支持 macOS 和 Linux，在 Windows 上要在 WSL 2 里进行。来源见 https://docs.twenty.com/developers/extend/apps/getting-started/quick-start.md
源码检出：Git、Node 26.5.1 或之后的 26.x（根目录 package.json 的 engines）、Yarn 4 和 nvm。这里不能用 npm，指南说要用 yarn。
MCP：一个你能登录的 Twenty 工作区，以及一个支持 streamable HTTP 服务器的 MCP 客户端。

主要安装命令

要装在你自己的服务器上，Docker Compose 页面给了一行命令。在服务器上运行它：

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

来源见 https://docs.twenty.com/developers/self-host/capabilities/docker-compose.md

各路线和各智能体的说明

setup/cloud-and-first-steps.md：注册、连接邮箱、塑造数据模型、导入记录
setup/docker-compose.md：自托管、SERVER_URL、备份、升级，以及让实例保持私有
setup/local-development.md：从源码检出运行 Twenty
setup/build-an-app.md：twenty CLI、本地服务器和发布应用
setup/claude-code.md：在 Claude Code 里使用 MCP 和智能体技能
setup/codex.md：MCP、智能体技能和 Codex 插件
setup/cursor.md：在 Cursor 里使用 MCP 和智能体技能
setup/other-agents.md：Claude Desktop、ChatGPT、其他任何 MCP 客户端，以及 API

更新或卸载

对 Docker Compose 安装，升级指南说要先备份数据库，用 docker compose down 停掉 Twenty，改 .env 里的 TAG 值，再用 docker compose up -d 重新启动。服务器会在启动时自己运行升级迁移。步骤见 setup/docker-compose.md。

twenty CLI 对本地开发服务器有自己的命令（twenty local upgrade、twenty local stop、twenty local reset），对已安装的应用也有（twenty app uninstall）。它们在 setup/build-an-app.md 里。

这些说明用到的文档页面里，没有给自托管服务器写卸载页面。故障排查页面在全新安装时用 docker compose down --volumes，并警告说它会永久删除所有数据库数据。请先备份。

使用数据和对外连接

这些说明用到的页面没有描述自托管服务器的使用数据。Setup 页面说，每个配置变量都在管理面板的 Settings → Admin Panel → Configuration Variables 下有说明，而少数基础设施设置只能写在 .env 文件里。来源见 https://docs.twenty.com/developers/self-host/capabilities/setup.md

npx skills add 运行的是另一个 skills CLI（https://skills.sh/），它不是 Twenty 的工具。它收集什么，请读它自己的页面。

助手通过 MCP 读到的内容都会发给那个助手，而它的服务商怎么处理，取决于服务商自己的政策。MCP 连接沿用已登录用户的权限，或者你给 API 密钥指定的角色的权限。

来源

仓库 README：https://github.com/twentyhq/twenty/blob/main/README.md
LICENSE：https://github.com/twentyhq/twenty/blob/main/LICENSE
智能体技能列表：https://github.com/twentyhq/twenty/blob/main/SKILLS.md
智能体技能软件包 README：https://github.com/twentyhq/twenty/blob/main/packages/twenty-agent-skills/README.md
智能体技能 manage-app：https://github.com/twentyhq/twenty/blob/main/packages/twenty-agent-skills/skills/manage-app/SKILL.md
MCP 的智能体技能设置：https://github.com/twentyhq/twenty/blob/main/packages/twenty-agent-skills/references/use-twenty-mcp/setup.md
Quickstart：https://docs.twenty.com/getting-started/quickstart.md
Meet Twenty：https://docs.twenty.com/getting-started/introduction.md
Key features：https://docs.twenty.com/getting-started/key-features.md
Data Model：https://docs.twenty.com/getting-started/core-concepts/data-model.md
Workflows：https://docs.twenty.com/getting-started/core-concepts/workflows.md
Apps：https://docs.twenty.com/getting-started/core-concepts/apps.md
AI：https://docs.twenty.com/user-guide/ai/overview.md
Docker Compose：https://docs.twenty.com/developers/self-host/capabilities/docker-compose.md
Setup：https://docs.twenty.com/developers/self-host/capabilities/setup.md
Upgrade guide：https://docs.twenty.com/developers/self-host/capabilities/upgrade-guide.md
Securing your instance：https://docs.twenty.com/developers/self-host/capabilities/security.md
Troubleshooting：https://docs.twenty.com/developers/self-host/capabilities/troubleshooting.md
Local setup：https://docs.twenty.com/developers/contribute/capabilities/local-setup.md
Apps quick start：https://docs.twenty.com/developers/extend/apps/getting-started/quick-start.md
Local environment：https://docs.twenty.com/developers/extend/apps/getting-started/local-server.md
Apps troubleshooting：https://docs.twenty.com/developers/extend/apps/getting-started/troubleshooting.md
Publishing：https://docs.twenty.com/developers/extend/apps/operations/publishing.md
MCP server：https://docs.twenty.com/user-guide/ai/capabilities/mcp.md
APIs：https://docs.twenty.com/developers/extend/api.md

文件

README.md  8 KB
setup/build-an-app.md  7 KB
setup/claude-code.md  6 KB
setup/cloud-and-first-steps.md  6 KB
setup/codex.md  4 KB
setup/cursor.md  3 KB
setup/docker-compose.md  12 KB
setup/local-development.md  5 KB
setup/other-agents.md  5 KB

9 个文件，共 56 KB，以 zip 压缩包下载。