Set Up ChatbotX MCP by Platform - ChatbotX Documentation

Choose the tab for the AI assistant or MCP client you use.

Install Node.js v22 and OpenClaw

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22
curl -fsSL https://openclaw.ai/install.sh | bash

Configure OpenClaw

openclaw configure

Install the ChatbotX skill

Install the official ChatbotX skill from ClawHub:

openclaw skills install chatbotx

Configure your environment variables:

CHATBOTX_API_KEY=YOUR_WORKSPACE_TOKEN
CHATBOTX_API_URL=https://app.chatbotx.io/api

If you are running a self-hosted instance of ChatbotX, configure CHATBOTX_API_URL to point to your custom domain: https://app.yourdomain.com/api.

If your server uses a self-signed certificate, add:

CHATBOTX_ALLOW_SELF_SIGNED_CERT=true

Start and check

openclaw gateway start
openclaw mcp list
openclaw logs --follow

Install Hermes

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc

Run the setup wizard

hermes setup

Connect ChatbotX MCP Server

hermes mcp add chatbotx --url "https://app.chatbotx.io/mcp/sse?token=YOUR_WORKSPACE_TOKEN"
hermes config set mcp_servers.chatbotx.transport sse

If you are self-hosting ChatbotX, replace the URL with: "https://app.yourdomain.com/mcp/sse?token=YOUR_WORKSPACE_TOKEN".

Set up systemd

sudo systemctl daemon-reload
sudo systemctl enable --now hermes
hermes mcp list
journalctl -u hermes -f

Install Claude Code

npm install -g @anthropic-ai/claude-code

Add ChatbotX MCP

You can connect Claude Code using either SSE (remote) or stdio (local):Option A: Remote (SSE) Connection

claude mcp add chatbotx -t sse -H "x-workspace-token: YOUR_WORKSPACE_TOKEN" -s user https://app.chatbotx.io/mcp/sse

Note: If self-hosted, use https://app.yourdomain.com/mcp/sse.Option B: Local (stdio) Connection

claude mcp add chatbotx -e CHATBOTX_API_KEY=YOUR_WORKSPACE_TOKEN -e CHATBOTX_API_URL=https://app.chatbotx.io/api -e CHATBOTX_MCP_TRANSPORT=stdio -s user -- node /path/to/dist/index.mjs

Note: If self-hosted, use https://app.yourdomain.com/api for the API URL.

Check status

claude mcp list
claude mcp get chatbotx

{
  "servers": {
    "chatbotx": {
      "type": "sse",
      "url": "https://app.chatbotx.io/mcp/sse",
      "headers": {
        "x-workspace-token": "YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}

Note: If you are self-hosting, replace https://app.chatbotx.io/mcp/sse with https://app.yourdomain.com/mcp/sse.

[mcp_servers.chatbotx]
url = "https://app.chatbotx.io/mcp/sse"
enabled = true

[mcp_servers.chatbotx.http_headers]
"x-workspace-token" = "YOUR_WORKSPACE_TOKEN"

Note: If you are self-hosting, replace https://app.chatbotx.io/mcp/sse with https://app.yourdomain.com/mcp/sse.

{
  "mcpServers": {
    "chatbotx": {
      "serverUrl": "https://app.chatbotx.io/mcp/sse",
      "headers": {
        "x-workspace-token": "YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}

Note: If you are self-hosting, replace https://app.chatbotx.io/mcp/sse with https://app.yourdomain.com/mcp/sse.

{
  "mcpServers": {
    "chatbotx": {
      "httpUrl": "https://app.chatbotx.io/mcp/sse",
      "headers": {
        "x-workspace-token": "YOUR_WORKSPACE_TOKEN"
      }
    }
  }
}

If your Gemini CLI version does not accept httpUrl, try serverUrl.Note: If you are self-hosting, replace https://app.chatbotx.io/mcp/sse with https://app.yourdomain.com/mcp/sse.

https://app.chatbotx.io/mcp/sse?token=YOUR_WORKSPACE_TOKEN

Choose no additional authentication if the token is already included in the URL.Note: If you are self-hosting, replace https://app.chatbotx.io/mcp/sse with https://app.yourdomain.com/mcp/sse.

Additional Guide: Create and Secure a Telegram Bot

Both OpenClaw and Hermes allow you to interact with your AI assistant using Telegram. To set this up, you need a Telegram Bot Token and your personal Chat ID for security.

Step 1: Create a Telegram Bot

Open the Telegram app, search for the official @BotFather (verified with a blue checkmark), and click Start.
Send the /newbot command.
Enter a display name for your bot (e.g., ChatbotX Assistant).
Enter a unique username ending in bot (e.g., chatbotx_mcp_bot).
Copy the Telegram Bot Token provided (e.g., 123456789:ABCdefGhIJKlmNoPQRs...).

Step 2: Retrieve Your Chat ID for Security

To prevent unauthorized users from executing commands on your ChatbotX workspace via the Telegram bot, restrict bot access to your Telegram account using your Chat ID:

Search for @userinfobot on Telegram and click Start.
Copy the Id number returned in the message.
Save this Chat ID in your OpenClaw or Hermes configuration wizard to restrict access.

​Additional Guide: Create and Secure a Telegram Bot

​Step 1: Create a Telegram Bot

​Step 2: Retrieve Your Chat ID for Security

Additional Guide: Create and Secure a Telegram Bot

Step 1: Create a Telegram Bot

Step 2: Retrieve Your Chat ID for Security