explaingit

md-mushfiqur123/mxclaw

11TypeScriptAudience · developerComplexity · 4/5Setup · hard

TLDR

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

Things people build with this

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.

Tech stack

TypeScriptNode.js

Getting it running

Difficulty · hard Time to first run · 1h+

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

In plain English

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.
Open on GitHub → Explain another repo

← md-mushfiqur123 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.