Omnichannel Automation CLI for Nanoclaw
Automate customer conversations across 30+ messaging channels. Built for Nanoclaw to manage contacts, assign tags, and launch chatbot flows directly from WhatsApp, Telegram, Slack, and Discord.
Please make sure there is always a human in the loop.
Quick Start: Install & Run ChatbotX CLI with Nanoclaw
Deploy ChatbotX CLI inside your Nanoclaw container and execute customer operations directly from chat apps.
# 1. Install ChatbotX CLI globally inside container
npm install -g chatbotx
# or add skill: npx skills add sunghajung43/chatbotx
# 2. Configure workspace token in container (Settings → Integrations → Workspace token)
export CHATBOTX_API_KEY="YOUR_WORKSPACE_TOKEN"
export CHATBOTX_API_URL="https://app.chatbotx.io/api"
# 3. Verify workspace access and list active channels
chatbotx workspaces get
chatbotx channels list
# 4. Resolve customer contact and trigger chatbot flow
chatbotx contacts get phone:+84901234567
chatbotx contacts flow add phone:+84901234567 --flowId <flowId>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 listContacts & 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_welcomeInbox & 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 listOne Command, Every Channel
Sync CRM contacts, add dynamic tags, and trigger multi-channel flows across WhatsApp, Telegram, and Messenger with simple shell scripts.
# 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
doneWhat is Nanoclaw?
Nanoclaw is a lightweight, container-based alternative to OpenClaw by Qwibit AI. It connects to WhatsApp, Telegram, Slack, Discord, and Gmail, featuring built-in memory and state management.
Container-Based
Nanoclaw runs in Docker containers, making deployment simple and reproducible. Spin up your customer service agent anywhere with a single container image.
Multi-Platform Chat
Connects to WhatsApp, Telegram, Slack, Discord, and Gmail. Interact with your agent from whichever chat platform you prefer.
Memory & Context
Nanoclaw remembers customer preferences and past interactions. Built-in memory means it gets better at handling customer questions over time.
How ChatbotX Works with Nanoclaw
Nanoclaw executes ChatbotX CLI commands inside its lightweight container environment, allowing you to trigger flows, check inbox status, and update CRM tags directly from chat apps.
Manage Customer Flows From Any Chat App
Message Nanoclaw from WhatsApp, Telegram, Slack, or Discord: it connects to ChatbotX, resolves contact records, and executes flows straight from your mobile chat app.
You (via Telegram): Send the 20% discount coupon flow to customer phone +84708123123.
Nanoclaw: Processing your request via ChatbotX API.
1. Looking up contact: chatbotx contacts get phone:+84708123123
Found: Alice Nguyen (c_49201)
2. Adding promotional tag: chatbotx contacts tag add phone:+84708123123 --tagIds tag_coupon_20
3. Dispatching flow: chatbotx contacts flow add phone:+84708123123 --flowId flow_coupon_delivery
Done! Discount coupon flow sent to Alice Nguyen via WhatsApp.Also Works with Claude Code & OpenClaw
ChatbotX Agent is a CLI & MCP tool: it works with any AI agent that can run shell commands, including Claude Code and OpenClaw.
Claude Code
Terminal Coding AgentAnthropic's terminal agent that completes development and automation tasks autonomously. Reads ChatbotX tool definitions and schedules content from natural language.
OpenClaw
Personal AI AgentLightweight personal AI agent that connects to WhatsApp, Telegram, and terminal workflows. Supports ChatbotX via skill definitions.
Command Reference Matrix
Complete list of CLI commands available to your autonomous agents and scripts.
Supported Channels & Runtimes
Connect your channels in ChatbotX once, then automate customer conversations to any of them via CLI or agent.