Omnichannel Automation CLI for Hermes Agent

Automate customer conversations and CRM tasks across 30+ messaging channels. Built for Hermes Agent by Nous Research to triage inboxes, tag contacts, and launch chatbot flows autonomously.

Read the Docs GitHub Start for $0

Please make sure there is always a human in the loop.

Quick Start: Install & Configure ChatbotX CLI for Hermes Agent

Install ChatbotX CLI and configure credentials for Hermes Agent autonomous tool execution.

terminal: quick-start

bash / zsh

# 1. Install ChatbotX CLI globally
npm install -g chatbotx

# 2. Configure environment credentials (Settings → Integrations → Workspace token)
export CHATBOTX_API_KEY="YOUR_WORKSPACE_TOKEN"
export CHATBOTX_API_URL="https://app.chatbotx.io/api"

# 3. Verify workspace connection and active channels
chatbotx workspaces get
chatbotx channels list

# 4. Execute customer CRM operations
chatbotx contacts get email:[email protected]
chatbotx contacts tag add email:[email protected] --tagIds <tagId>

Built for Automation

Engineered specifically for autonomous agents, background workers, and terminal execution pipelines.

AI Agent & MCP Ready

Every command returns structured JSON. Designed for LLMs, function calling, and MCP tools with zero token cost overhead.

Omnichannel Messaging

Manage WhatsApp, Telegram, Messenger, Zalo, Instagram, SMS, and WebChat from a single unified command-line tool.

Contact CRM & Resolvers

Resolve, create, and update contacts seamlessly by email, international phone number (+84...), or internal workspace identifier.

Tags & Custom Fields

Dynamically tag contacts, query custom attributes, and maintain synchronized CRM state directly through automation scripts.

Chatbot Flows & Sequences

Trigger interactive multi-step chatbot flows, auto-reply rules, and drip sequences programmatically based on agent logic.

Broadcasts & Inbox Triage

Monitor live open conversations, list target broadcast audiences, and dispatch bulk campaigns with full delivery audit logs.

How It Works

Simple three-step cycle for autonomous discovery, contact execution, and inbox triage.

Discover Workspace

List connected messaging channels, tags, and custom fields to introspect workspace configuration.

chatbotx channels list

# Query tags and fields
chatbotx tags list
chatbotx custom-fields list

Contacts & Flows

Resolve contact details by email or phone, attach segmentation tags, and launch automated chatbot flows.

# Resolve contact and tag
chatbotx contacts get email:[email protected]
chatbotx contacts tag add email:[email protected] --tagIds tag_vip

# Trigger automated flow
chatbotx contacts flow add email:[email protected] --flowId flow_welcome

Inbox & Broadcasts

Monitor open customer conversations across channels, inspect broadcasts, and manage multi-channel dispatches.

# List active unassigned conversations
chatbotx conversations list --status unassigned

# Inspect broadcasts
chatbotx broadcasts list

One Command, Every Channel

Sync CRM contacts, add dynamic tags, and trigger multi-channel flows across WhatsApp, Telegram, and Messenger with simple shell scripts.

examples / multi-platform-broadcast.sh

batch script

# 1. Look up contact by phone or email
chatbotx contacts get phone:+84708123123

# 2. Add VIP segmentation tag
chatbotx contacts tag add phone:+84708123123 --tagIds tag_vip_client

# 3. Update customer custom field
chatbotx contacts custom-field add phone:+84708123123 cf_tier --value "Gold"

# 4. Trigger automated welcome flow or send direct notification
chatbotx contacts flow add phone:+84708123123 --flowId flow_spring_promo
chatbotx contacts message send phone:+84708123123 --text "Your VIP status has been activated!"

# 5. Batch-tag segmented leads from a list
for email in [email protected] [email protected] [email protected]; do
  chatbotx contacts tag add email:$email --tagIds tag_lead_qualified
done

What is Hermes Agent?

Hermes Agent is an open-source AI agent framework by Nous Research, 'the agent that grows with you.' It is a flexible platform for building and running autonomous agents with tool execution and memory capabilities.

🌱

Grows With You

Hermes Agent learns and adapts to your customer communication patterns over time, becoming more effective at triaging support issues the more you use it.

🔓

Open-Source Framework

Fully customizable and built by Nous Research. Inspect the source, extend functionality, and tailor the agent to your exact customer support needs.

⚡

Tool Execution

Hermes Agent executes CLI and MCP tools directly, making it a natural fit for running ChatbotX commands to manage omnichannel customer workflows.

How ChatbotX Works with Hermes Agent

Hermes Agent discovers ChatbotX through its tool execution framework. Once configured, it executes terminal CLI commands to triage customer conversations, tag contacts, and launch flows autonomously.

Automated Triage With Hermes Agent

Instruct Hermes Agent to triage inbox conversations: it connects to ChatbotX, identifies urgent tickets, tags contacts, and routes them to priority resolution flows.

Interactive Session Simulation

Autonomous

You: Scan our unassigned WhatsApp chats in ChatbotX, find any refund requests, and route them to the refunds team.

Hermes: On it. Processing live conversations.
  1. Queried conversations: chatbotx conversations list --status unassigned
     Found 3 unassigned chats; analyzed incoming message text.
  2. Identified contact +84708123123 requesting order refund.
  3. Added tag: chatbotx contacts tag add phone:+84708123123 --tagIds tag_refund_urgent
  4. Triggered resolution flow: chatbotx contacts flow add phone:+84708123123 --flowId flow_refund_triage
  
Done! Refund request isolated, tagged, and routed to refund queue.

Also Works with Claude Code & OpenClaw

ChatbotX Agent is a CLI & MCP tool: it works with any AI agent runtime that can run shell commands, including Anthropic's Claude Code.

Claude Code

Anthropic Terminal Agent

Agentic coding tool by Anthropic that runs in your terminal. Discovers ChatbotX CLI commands, tags contacts, and executes automated customer sequences seamlessly.

Explore Integration Docs

OpenClaw

Skill-Based Agent Runtime

OpenClaw automatically discovers ChatbotX via bundled SKILL.md. Run heartbeat cron jobs or trigger customer flows directly from chat channels.