🐈 PipClaw

February 9, 2026 Β· View on GitHub

Important Note: Starting from version 0.0.11 (versions after 0.0.10), this project has been renamed to MMClaw. Please visit the new repository for all future updates and versions.

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

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

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

Python 3.8+

PipClaw 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.

PipClaw 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 PipClaw.
  • 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 pipclaw
pipclaw run

πŸ›  The Philosophy

The trend in AI agents is moving towards massive complexity. PipClaw 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. PipClaw is the "distilled essence" of an autonomous bot.

πŸ”Œ Connectors

PipClaw 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
pipclaw config

πŸ“‚ Project Structure

pipclaw/
β”œβ”€β”€ 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.