Twenty CRM 连接

技能简介

该技能用于连接自托管的 Twenty CRM 系统，通过 REST 或 GraphQL 接口执行数据读写操作，包括公司、联系人等对象的管理。

业务背景

销售团队使用自托管Twenty CRM管理客户数据时，常需在AI助手与CRM之间手动切换核对信息。该技能打通两者壁垒，支持直接查询联系人、更新公司记录或执行自定义数据操作，减少上下文切换成本，让销售人员在对话界面内完成客户信息管理。

落地案例：客户经理在与AI讨论季度复盘时，想确认某重点客户的最新跟进状态。他直接调用该技能，输入客户公司名称作为筛选条件，系统实时返回Twenty CRM中的联系人列表、上次沟通日期及关联商机阶段。发现信息滞后，他随即在同一对话中发起更新请求，修改客户优先级字段，无需打开CRM网页或切换工具窗口。

能做什么

• 查询和筛选公司、联系人等记录
• 创建、更新、删除 CRM 数据
• 执行自定义 GraphQL 查询
• 批量获取分页结果

使用说明

安装步骤

1. 克隆技能仓库到本地 skills 目录
2. 复制配置文件模板：cp config/twenty.env.example config/twenty.env
3. 编辑 config/twenty.env，填写以下两项：
   • TWENTY_BASE_URL：实例地址，如 https://crm.example.com 或 http://localhost:3000
   • TWENTY_API_KEY：Bearer Token 认证密钥
4. 确保脚本具有执行权限：chmod +x skills/twenty-crm/scripts/*.sh

常用命令示例

• 查询公司列表：skills/twenty-crm/scripts/twenty-rest-get.sh "/companies" 'limit=10'
• 按名称搜索公司：skills/twenty-crm/scripts/twenty-find-companies.sh "acme" 5
• 创建新公司：skills/twenty-crm/scripts/twenty-create-company.sh "Acme Inc" "acme.com" 120
• GraphQL 查询：skills/twenty-crm/scripts/twenty-graphql.sh 'query { companies(limit: 5) { edges { node { id name } } } }'

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥需妥善保管，避免写入版本控制
• Token 可能因会话策略过期，遇 401 错误需重新获取
• 生产环境操作前建议在测试实例验证
• 对象字段名随 Twenty 版本变化，调用前确认当前元数据

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jhumanj/twenty-crm/SKILL.md
来源类型：GitHub 开源技能