Skip to content

🐈 MMClaw

The Ultra-Lightweight, Pure Python Kernel for Multimodal AI Agents.

Home: https://github.com/CrawlScript/MMClaw

English | δΈ­ζ–‡θ―΄ζ˜Ž

Python 3.8+

Note: This project was previously named pipclaw (pre-v0.0.11).

MMClaw is a minimalist, 100% Pure Python autonomous agent kernel. While frameworks like OpenClaw offer great power, they often introduce heavy dependencies like Node.js, Docker, or complex C-extensions.

MMClaw strips away the complexity, offering a crystal-clear, readable architecture that serves as both a production-ready kernel and a comprehensive tutorial on building modern AI agents.

🌟 Key Features

  • 100% Pure Python: No C-extensions, no Node.js, no Docker. If you have Python, you have MMClaw.
  • Minimalist & Readable: A "Batteries-Included" architecture designed to be a living tutorial. Learn how to build an OpenClaw-style agent by reading code, not documentation.
  • Highly Customizable Kernel: Designed as a core engine, not a rigid app. Easily plug in your own logic, state management, and custom tools.
  • Universal Cross-Platform: Runs seamlessly on Windows, macOS, Linux, and minimalist environments like Raspberry Pi.
  • Multi-Channel Interaction: Built-in support for interacting with your agent via Telegram, WhatsApp, and moreβ€”all handled through pure Python integrations.

πŸš€ Quick Start

No compiling, no heavy setup. Just pip and run.

pip install mmclaw
mmclaw run

πŸ›  The Philosophy

The trend in AI agents is moving towards massive complexity. MMClaw moves towards clarity. Most developers don't need a 400,000-line black box. They need a reliable, auditable kernel that handles the agent loop and tool-calling while remaining light enough to be modified in minutes. MMClaw is the "distilled essence" of an autonomous bot.

πŸ”Œ Connectors

MMClaw allows you to interact with your agent through multiple channels:

  • Terminal Mode: Standard interactive CLI (default).
  • Telegram Mode: No external dependencies. Just create a bot via @BotFather and provide your token during setup.
  • Feishu (飞书) Mode: Dedicated support for Chinese users. Features the most detailed step-by-step setup guide in the industry, utilizing long-connections so you don't need a public IP or complex webhooks.
  • WhatsApp Mode: Requires Node.js (v22.17.0 recommended) to run the lightweight bridge. The agent will show a QR code in your terminal for linking.
# To change your mode or LLM settings
mmclaw config

🧠 Providers

MMClaw supports a wide range of LLM providers:

  • OpenAI: GPT-4o, o1, and more.
  • OpenAI Codex: Premium support via OAuth device code authentication (no manual API key management needed).
  • Google Gemini: Gemini 1.5 Pro/Flash, 2.0 Flash.
  • DeepSeek: DeepSeek-V3, DeepSeek-R1.
  • Kimi (Moonshot AI): Native support for Kimi k2.5.
  • OpenAI-Compatible: Customizable Base URL for local or third-party engines (Ollama, LocalAI, etc.).
  • Others: OpenRouter and more.

πŸ“‚ Project Structure

mmclaw/
β”œβ”€β”€ kernel/          # Core agent loop & state logic
β”œβ”€β”€ connectors/      # Telegram, WhatsApp, and Web UI bridges
β”œβ”€β”€ providers/       # LLM connectors (OpenAI, Anthropic, etc.)
└── tools/           # Extensible toolset (Search, Code Exec, etc.)

Developed with ❀️ for the Python community. Let's keep it simple.