twenty-crm

What This Skill Does

The twenty-crm skill provides a robust bridge between your OpenClaw agent and a self-hosted instance of Twenty CRM. Twenty is a modern, open-source customer relationship management platform that offers both RESTful and GraphQL APIs for deep integration. This skill allows your agent to perform full CRUD (Create, Read, Update, Delete) operations on CRM objects such as companies, people, and opportunities. By leveraging standardized scripts, the skill handles the complexities of authentication and payload formatting, enabling the agent to manage your sales pipeline, log interactions, and retrieve business data directly from your infrastructure.

Installation

To integrate this skill, ensure you have the OpenClaw CLI installed and run the command: clawhub install openclaw/skills/skills/jhumanj/twenty-crm. After installation, you must configure your environment by creating a config/twenty.env file. Populate this file with your TWENTY_BASE_URL (the location of your instance) and TWENTY_API_KEY (a valid Bearer token generated within your Twenty dashboard). These credentials allow the scripts to communicate securely with your instance without hardcoding secrets in your workflow files.

Use Cases

This skill is designed for automation enthusiasts looking to streamline their sales processes. Common use cases include: 1) Automatically importing leads from web forms or emails into the CRM; 2) Updating company data periodically via cron jobs or agent-triggered cleanup; 3) Querying customer history before a meeting; and 4) Synchronizing data between your CRM and other internal tools or databases through the agent's logic layer.

Example Prompts

1. "Find all companies in the CRM that contain the name 'Acme' and print a list of their IDs."
2. "Create a new company in Twenty CRM named 'TechInnovate' with the website 'techinnovate.io' and set the employee count to 150."
3. "Run a GraphQL query to count the total number of companies currently stored in my Twenty instance."

Tips & Limitations

• Authentication: If you encounter a 401 Unauthorized error, your API token may have expired. Generate a new one in the Twenty UI and update your env file.
• Schema Variations: Since Twenty is highly customizable, your specific instance's object names might differ. Always verify field names against your instance's GraphQL schema if a query fails.
• Network Security: Ensure your Twenty instance is reachable by the environment where OpenClaw is running. If you are using a local localhost URL, the agent must be running on the same host machine.
• Performance: For large datasets, prefer GraphQL queries over REST GET requests to minimize data transfer and payload sizes.