DEV Community

tf_geometric
tf_geometric

Posted on

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

#agents #ai #openclaw

🐈 MMClaw

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

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

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
Enter fullscreen mode Exit fullscreen mode

πŸ›  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
Enter fullscreen mode Exit fullscreen mode

πŸ“‚ 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.)
Enter fullscreen mode Exit fullscreen mode

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

Top comments (0)