Hermes Agent Integrationby Nous Research

Hermes Agent + PerfexCRM: Self-Hosted AI Agent for Your CRM

Hermes Agent is an open-source, self-improving AI assistant built by Nous Research with 87,000+ GitHub stars. When paired with the PerfexAPI module, it turns WhatsApp, Telegram, Slack, and Signal into a full CRM interface for PerfexCRM.

Both frameworks connect through the same MCP server built into the module. All 170 CRM operations — create customers, issue invoices, convert leads, reply to tickets, manage projects — become available as natural language commands. MIT licensed, self-hosted, and compatible with the agentskills.io open standard.

Hermes (PerfexCRM)
Self-hosted • MCP connected
Create an invoice for Acme Corp: $2,500 web development, due in 14 days

Invoice #2043 created:

  • • Client: Acme Corp
  • • Amount: $2,500.00
  • • Due: April 29, 2026
  • • Status: Draft

Send now, or review in CRM first?

Send it. And remember: Acme always pays within 7 days.
Invoice sent. Memory updated: Acme Corp pays within 7 days.
87K+
GitHub Stars
170
CRM Operations
7+
Messaging Channels
MIT
Open Source

How Does Hermes Agent Connect to PerfexCRM?

Hermes Agent connects to PerfexCRM through the native MCP server built into our module (v2.8.0+). When you send a message, Hermes interprets your intent, calls the PerfexCRM API, and returns the result in natural language — no custom integration code required.

Your Message
Telegram, WhatsApp, Slack...
Hermes Agent
Self-improving AI (MCP)
PerfexCRM API
170 endpoints via PerfexAPI

Which Messaging Platforms Does Hermes Agent Support?

Hermes Agent connects to 7+ channels from a single gateway with cross-platform conversation continuity. Manage your CRM from whichever app your team already uses.

✈️

Telegram

900M+ users

💬

WhatsApp

2B+ users

💼

Slack

Business teams

🎮

Discord

200M+ users

🔒

Signal

Privacy-first

📧

Email

Any provider

⌨️

CLI / Terminal

Developers

🏠

Home Assistant

Smart home

+ Voice memo transcription, cross-platform conversation continuity, and subagent delegation via the Hermes gateway

What Can You Do With Hermes Agent and PerfexCRM?

Four real-world CRM automation scenarios powered by Hermes Agent's self-improving memory and cron scheduler

Invoice Reminders via WhatsApp

Hey Hermes, which invoices are overdue?
5 overdue invoices totaling $12,450: 1. Acme Corp — $4,200 (15 days) 2. WebCorp — $3,100 (8 days) 3. GlobalTech — $2,400 (5 days) +2 more under $2k
Send reminder to Acme and schedule a follow-up task for Monday
✓ Email reminder sent to Acme Corp ✓ Follow-up task created for Monday 9AM ✓ Task assigned to you

Morning CRM Briefing via Cron

🌅 Good morning! Here is your PerfexCRM briefing for April 15: 📊 Yesterday: • 3 new leads • 2 invoices paid ($8,400) • 1 high-priority ticket opened ⚠️ Needs attention: • 2 tasks overdue • 1 project at 90% completion
Close the completed project and notify the team
✓ Project #42 marked complete ✓ Team notified via Slack ✓ Client invoice generated

Lead Management from Telegram

Create a lead: TechStart Inc, Sarah at sarah@techstart.com, budget $30K, high priority
✓ Lead #147 created • Company: TechStart Inc • Contact: Sarah • Value: $30,000 • Status: Contacted • Priority: High
What is the lead pipeline this week?
This week: 12 leads, $247K total pipeline • 4 in "Contacted" • 5 in "Qualified" • 3 in "Proposal Sent" Top 3 by value: TechStart ($30K), Acme ($45K), Global ($28K)

Self-Improving Support Triage

Triage the new support tickets
8 new tickets since last check: • 3 billing → routed to Finance • 2 API integration → routed to Dev (you) • 2 onboarding → routed to Success • 1 urgent (server down) → flagged for immediate response
Remember: always escalate server downtime tickets directly to me via Signal
✓ Learned and saved to memory. From now on, any ticket matching "server down", "downtime", or "outage" will auto-notify you on Signal.

What CRM Operations Are Available Through Hermes Agent?

All 170 PerfexAPI endpoints are exposed as MCP tools, automatically discoverable by Hermes on first connection.

Customers

  • List & search customers
  • Create new customers
  • Update customer info
  • List customer contacts
  • View customer invoices

Invoices & Payments

  • Check overdue invoices
  • Create invoices with line items
  • Record payments
  • Send payment reminders
  • Generate revenue reports

Leads & Sales

  • View lead pipeline
  • Create & qualify leads
  • Convert leads to customers
  • Track lead activities
  • Update lead status

Support Tickets

  • View open tickets
  • Reply to tickets
  • Assign to staff
  • Update ticket status
  • Analyze ticket trends

Projects & Tasks

  • Check project progress
  • Create & assign tasks
  • View milestones
  • Log timesheets
  • Upload project files

And 14 More Resources

  • Contracts & proposals
  • Estimates & credit notes
  • Expenses & items
  • Staff management
  • Notes & contacts

How to Install Hermes Agent and Connect It to PerfexCRM

From zero to self-hosted CRM AI in under 10 minutes — three commands and you are done.

1

Install Hermes Agent

One command to install Hermes on Linux, macOS, or Windows (WSL2)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2

Configure PerfexCRM MCP

Add the PerfexAPI MCP server to your Hermes config file

# ~/.hermes/config.yaml
mcp_servers:
  perfexcrm:
    url: "https://your-crm.com/api/v1/mcp"
    headers:
      X-API-KEY: "your-api-key"
3

Connect & Chat

Link a messaging channel and start managing your CRM with natural language

hermes channels add telegram
hermes start

Prerequisites

  • PerfexCRM 2.3.0+ with the PerfexAPI module installed (v2.8.0+ for MCP support) — see installation guide
  • Linux, macOS, or WSL2 on Windows (Hermes does not run natively on Windows)
  • API key created in PerfexCRM Admin > API & Webhooks > API Keys — see API docs
One-command migration

Migrating From OpenClaw to Hermes Agent

Already using OpenClaw? Hermes Agent ships with a built-in migration command that imports your entire setup in one step.

# Preview what will migrate (safe, no changes)
hermes claw migrate --dry-run

# Run the migration
hermes claw migrate

# Everything transfers automatically:
# ✓ SOUL.md (persona)
# ✓ MEMORY.md (learned facts)
# ✓ Skills (including openclaw-imports/)
# ✓ API keys (PerfexAPI, etc.)
# ✓ Messaging configs
# ✓ TTS assets
# ✓ Command allowlists

Your existing PerfexCRM integration continues working without reconfiguration because both frameworks connect through the same MCP server. Hermes implements the agentskills.io open standard, so your OpenClaw skills are ported automatically to ~/.hermes/skills/openclaw-imports/ and remain functional.

Hermes Agent vs OpenClaw — Which Should You Choose?

Both frameworks connect to PerfexCRM through the same MCP server. Use one, the other, or both — they coexist without conflict.

FeatureHermes AgentOpenClaw
LicenseMITMIT
GitHub Stars87,000+313,000+
Built byNous ResearchCommunity
Messaging platforms7+ (TG, WA, Slack, Discord, Signal, Email, CLI)20+ platforms
MCP supportNative (stdio + HTTP)Native
Self-improving memoryYes (SOUL.md, MEMORY.md)Basic
Built-in cron schedulerYesNo
Skills standardagentskills.io (open)ClawHub
Windows supportWSL2 onlyNative
Best forSelf-hosting, memory-driven workflows, cron briefingsBroad messaging coverage (20+ platforms), Windows native

Frequently Asked Questions

What is Hermes Agent by Nous Research?

Hermes Agent is an open-source, self-improving AI assistant built by Nous Research that connects to Telegram, WhatsApp, Slack, Discord, Signal, Email, and CLI from a single gateway process. Released under the MIT license on GitHub (NousResearch/hermes-agent) with over 87,000 stars, it supports the Model Context Protocol (MCP) and implements the agentskills.io open standard. It is the self-hosted, terminal-native alternative to closed AI agent platforms, designed to live on your server, remember what it learns, and get more capable the longer it runs.

Can Hermes Agent connect to PerfexCRM?

Yes. Hermes Agent connects to PerfexCRM through the MCP server built into the PerfexAPI module (v2.8.0+). Once configured in ~/.hermes/config.yaml, all 170 PerfexCRM endpoints become available as Hermes tools automatically. You can create customers, invoices, leads, tickets, projects, and contracts from any supported messaging channel using natural language commands. No custom integration code is required — the MCP protocol handles tool discovery and execution.

Does Hermes Agent support MCP (Model Context Protocol)?

Yes. Hermes Agent has first-class MCP support with two transport types: stdio (local subprocess) and HTTP (remote endpoints). This means it can connect to any MCP-compatible service, including the PerfexAPI MCP server, by adding an entry to ~/.hermes/config.yaml. The MCP integration includes auto-discovery of available tools, per-server tool filtering, MCP sampling, and dynamic capability updates.

How do I migrate from OpenClaw to Hermes Agent?

Hermes Agent ships with a built-in migration command: hermes claw migrate. Running this command imports your existing OpenClaw state in one step — skills, memory, personas (SOUL.md), API keys, command allowlists, messaging configs, and TTS assets all transfer automatically. Use the --dry-run flag first to preview what will migrate. Existing OpenClaw skills are auto-imported and remain functional because Hermes implements the agentskills.io standard. Your PerfexCRM integration continues working without reconfiguration.

Is Hermes Agent free?

Yes. Hermes Agent is completely free and open source under the MIT license. You self-host it on your own server, VPS, or even a Raspberry Pi. There are no usage limits, no cloud fees, and no vendor lock-in. The only cost to use it with PerfexCRM is the PerfexAPI module ($49 one-time), which provides the 170 REST API endpoints and MCP server that Hermes connects to. Optional costs include AI model API fees if you do not use a local model like Llama or Mistral.

Can I run Hermes Agent on Windows?

Hermes Agent requires WSL2 (Windows Subsystem for Linux) on Windows — it does not run natively on Windows. Installation on WSL2 takes about 10 minutes and provides a full Linux environment where Hermes runs normally. On macOS and Linux, Hermes runs natively without WSL. If you need native Windows support, OpenClaw is a better alternative and also connects to PerfexCRM through the same MCP server. Both frameworks can coexist on the same PerfexCRM instance.

What is the difference between Hermes Agent and OpenClaw?

Hermes Agent and OpenClaw are both open-source AI agent frameworks that connect to messaging platforms, but with different design philosophies. Hermes focuses on self-improving memory, terminal-native workflows, built-in cron scheduling, and agentskills.io standard compatibility. OpenClaw emphasizes broader messaging platform coverage (20+ platforms vs 7+ for Hermes) and the ClawHub skill marketplace. Both work with PerfexCRM via the same MCP server, so you can use either one or both simultaneously.

How much does it cost to run Hermes Agent with PerfexCRM?

Total cost: $49 one-time for the PerfexAPI module. Hermes Agent itself is free (MIT license). PerfexCRM costs $59 one-time on CodeCanyon if you do not already have it. AI model costs depend on your choice — Claude and GPT-4 run on usage-based pricing (roughly $5-20/month for typical CRM use), or you can run a local model like Llama 3 or Mistral for zero ongoing cost. Total minimum setup: $108 for PerfexCRM + PerfexAPI, with no recurring fees for the CRM stack itself.

Last updated: April 2026

Give PerfexCRM an AI Brain on Every Messaging App

Get PerfexAPI, install Hermes Agent, and start managing your CRM through natural conversation in under 10 minutes.