whatisgithub

What is mxclaw?

md-mushfiqur123/mxclaw — explained in plain English

Analysis updated 2026-06-24

11TypeScriptAudience · developerComplexity · 4/5Setup · hard

In one sentence

A self-hosted gateway that connects AI models to your messaging accounts on 14 platforms including Discord, Telegram, Slack, and WhatsApp, so an AI agent can read and reply to messages from your own machine.

Mindmap

mindmap
  root((mxclaw))
    Platforms
      Discord
      Telegram
      Slack
      WhatsApp
      iMessage
    AI Providers
      OpenAI
      Anthropic
      Groq
      Ollama local
    Agent Tools
      Shell commands
      Browser control
      Image generation
      Scheduled tasks
    Setup
      CLI wizard
      Config file
      Health check
      Background service
    Access Control
      Pairing codes
      Channel allowlists
      Mention only mode
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up an AI assistant that automatically reads and replies to your Discord or Telegram messages without using a cloud service.

USE CASE 2

Route messages from multiple chat apps to different AI models with a fallback chain if one provider fails.

USE CASE 3

Run a local AI agent that can execute shell commands, browse the web, and generate images on your behalf.

USE CASE 4

Build a personal AI bot across multiple messaging platforms that remembers conversation history between sessions.

What is it built with?

TypeScriptNode.js

How does it compare?

md-mushfiqur123/mxclawanousss007/ng-blatuiblockedpath/pi-xai-oauth
Stars111111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderateeasy
Complexity4/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires separate account credentials and connection steps for each messaging platform through a CLI wizard.

So what is it?

mxclaw (described in its README as hmm-whatsstatus) is a self-hosted gateway that connects AI models to your messaging accounts. Instead of using a cloud service to run an AI assistant that can read and reply in your chats, you run this on your own machine and point it at your accounts on Discord, Telegram, Slack, WhatsApp, iMessage, Signal, and 10 other platforms. Messages arriving on any of those platforms get routed to an AI agent, which replies back through the same channel. The project supports 14 messaging platforms and 17 AI providers, including OpenAI, Anthropic, Google Gemini, Groq, and local options like Ollama and LM Studio. You configure which AI model handles each channel, and can set up a fallback chain so that if the first provider fails, the system automatically tries the next one. Conversation history is saved locally so the agent remembers context across sessions. Agents can do more than just chat. They can execute shell commands, control a browser, generate images, schedule recurring tasks, read and write files, and spawn sub-agent sessions. Each tool has a configurable approval level: some require explicit confirmation before running, others run automatically for the account owner, and there is a mode that runs everything without asking. Setup uses a command-line wizard that walks through connecting platforms and configuring which AI handles each one. A configuration file at a standard location holds all credentials and bindings. A health check command diagnoses any configuration problems. Once running, the gateway can be installed as a background service through the system's native mechanism on macOS, Linux, or Windows. Access control is handled through pairing codes and per-channel allowlists. In group chats the agent only responds when directly mentioned. Unknown senders receive a short code they must submit through a control dashboard before the agent will respond to them.

Copy-paste prompts

Prompt 1
Help me write a mxclaw config file that connects my Discord account to Claude, only responds when mentioned in group chats, and falls back to Ollama if Claude is unavailable.
Prompt 2
Using mxclaw, how do I configure WhatsApp and Telegram to use the same AI model but keep their conversation histories separate?
Prompt 3
Show me the mxclaw setup steps to install it as a background service on Ubuntu Linux so it restarts automatically on reboot.
Prompt 4
What mxclaw config settings let shell command tools require my explicit approval while image generation runs without asking?
Prompt 5
Help me use the mxclaw health check command to diagnose why my iMessage connection is failing on macOS.

Frequently asked questions

What is mxclaw?

A self-hosted gateway that connects AI models to your messaging accounts on 14 platforms including Discord, Telegram, Slack, and WhatsApp, so an AI agent can read and reply to messages from your own machine.

What language is mxclaw written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

How hard is mxclaw to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is mxclaw for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.