MMCLAW
The agent kernel built for clarity.

A 1,700-line, pure Python autonomous agent — lightweight by design, not by accident. No Node.js, no Docker, no C-extensions. Just install and run.

🐍 Pure Python ✈️ Telegram 🪶 Feishu 💬 WhatsApp 🐧 QQ Bot OpenAI Gemini DeepSeek Kimi Ollama OpenRouter 🪟 Win / 🍎 Mac / 🐧 Linux
pip install mmclaw
terminal
$ pip install mmclaw
Installed

$ mmclaw run
Connector: Feishu
LLM: DeepSeek
Agent ready
~1,700lines
0C-exts
Win / Mac
/ Linux
Why MMClaw

Lightweight, not minimal.

Full-featured enough to ship real agents. Small enough to read over lunch.

🐍
Pure Python
Zero C-extensions, zero native binaries. If Python runs on your machine, MMClaw runs on your machine — laptop, server, or Raspberry Pi.
No build steps
1,700 Lines
The entire kernel fits in a single reading session. Step through the agent loop in your debugger. No magic, no black boxes.
Fully auditable
🔧
Kernel, Not App
A core engine built for extension. Swap providers, wire in custom tools, plug in your own state logic — in minutes, not hours.
Extensible
📡
Chat Connectors
Terminal, Telegram, Feishu, WhatsApp, QQ Bot — mix and match, same codebase. Long-polling throughout; no public IP, no webhooks needed.
Multi-connector
🌐
Browser Automation
Optional Playwright integration for real browser control — navigate, click, fill forms, scrape content, and maintain persistent login sessions across restarts. Enable via mmclaw config.
Playwright
🧠
Persistent Memory
Tell your agent to remember preferences, facts, or context — recalled automatically across all future sessions. Global memory persists beyond any single conversation.
Cross-session
🌐
Any LLM
OpenAI, Gemini, DeepSeek, Kimi, Claude, OpenRouter, and any OpenAI-compatible endpoint. Switch with a single config line.
Provider-agnostic
📖
Living Tutorial
The codebase is a teaching artifact. Learn the full agent loop and tool-calling protocol by reading real, production-grade Python.
Learn by reading
LLM Support

One kernel, any brain.

Switch providers with a single config change. No rewrites, no adapter layers.

OpenAI
OpenAI Codex
Google Gemini
DeepSeek
Kimi (Moonshot)
Anthropic Claude
OpenRouter
Any OpenAI-Compatible
Connectors

Mix & match connectors.

Use one or multiple connectors at once. Long-polling and direct connections only — no public IP, no webhooks, no infrastructure overhead.

⌨️
Terminal
The default. An interactive CLI with zero setup — fastest path from install to working agent conversation.
Default
✈️
Telegram
Create a bot via @BotFather, add your token, done. A personal AI assistant on Telegram with no extra dependencies.
Pure Python
🪶
Feishu / 飞书
First-class Feishu support with a step-by-step guide. Long-connection polling — works behind any firewall, no public IP required.
No Public IP
💬
WhatsApp
A minimal Node.js bridge prints a QR code in your terminal. Scan it and your agent is live on WhatsApp in under a minute.
Needs Node.js
🐧
QQ Bot
Connect to China's most popular chat platform. Reach your users on QQ with the same agent kernel, zero extra configuration.
Pure Python
Quick Start

Zero to agent in 60 seconds.

Two commands. No runtimes, no images, no config files to hunt down. Just pip and run.

pip install mmclaw
mmclaw run
terminal
# Step 1 — install
$ pip install mmclaw
Done

# Step 2 — run
$ mmclaw run
Connector: Terminal
LLM: OpenAI
Agent ready