Learning Path
MonoClaw can do a lot — CLI assistant, Telegram/Discord bot, task automation, and more. This page helps you figure out where to start and what to read based on your experience level and what you're trying to accomplish.
Start Here
If you are new to MonoClaw, begin with the Quickstart guide to run your first conversation. Everything below assumes you have a working setup.
How to Use This Page
- Know your level? Jump to the experience-level table and follow the reading order for your tier.
- Have a specific goal? Skip to By Use Case and find the scenario that matches.
- Just browsing? Check the Key Features table for a quick overview of everything MonoClaw can do.
By Experience Level
| Level | Goal | Recommended Reading | Time Estimate |
|---|---|---|---|
| Beginner | Get up and running, have basic conversations, use built-in tools | Quickstart → CLI Usage → Configuration | ~1 hour |
| Intermediate | Set up messaging bots, use advanced features like memory, cron jobs, and skills | Sessions → Messaging → Tools → Skills → Memory → Cron | ~2–3 hours |
| Advanced | Build custom tools, create skills, contribute to the project | Architecture → Adding Tools → Creating Skills → Contributing | ~4–6 hours |
By Use Case
"I want a CLI coding assistant"
Use MonoClaw as an interactive terminal assistant for writing, reviewing, and running code.
- Quickstart
- CLI Usage
- Code Execution
- Context Files
- Tips & Best Practices
Tip
Pass files directly into your conversation with context files. Mona can read, edit, and run code in your projects.
"I want a Telegram/Discord bot"
Deploy Mona as a bot on your favorite messaging platform.
- Quickstart
- Configuration
- Messaging Overview
- Telegram Setup
- Discord Setup
- Voice Mode
- Security
"I want to automate tasks"
Schedule recurring tasks, run batch jobs, or chain agent actions together.
- Quickstart
- Cron Scheduling
- Batch Processing
- Delegation
- Hooks
Tip
Cron jobs let Mona run tasks on a schedule — daily summaries, periodic checks, automated reports — without you being present.
"I want to build custom tools/skills"
Extend Mona with your own tools and reusable skill packages.
- Plugins
- Tools Overview
- Skills Overview
- MCP (Model Context Protocol)
- Architecture
- Adding Tools
- Creating Skills
Tip
For most custom tool creation, start with plugins. The Adding Tools page is for built-in MonoClaw core development, not the usual user/custom-tool path.
"I want to use it as a Python library"
Integrate MonoClaw into your own Python applications programmatically.
- Quickstart
- Python Library Guide
- Architecture
- Tools
- Sessions
Key Features at a Glance
Not sure what's available? Here's a quick directory of major features:
| Feature | What It Does | Link |
|---|---|---|
| Tools | Built-in tools the agent can call (file I/O, search, shell, etc.) | Tools |
| Skills | Installable plugin packages that add new capabilities | Skills |
| Memory | Persistent memory across sessions | Memory |
| Context Files | Feed files and directories into conversations | Context Files |
| MCP | Connect to external tool servers via Model Context Protocol | MCP |
| Cron | Schedule recurring agent tasks | Cron |
| Delegation | Spawn sub-agents for parallel work | Delegation |
| Code Execution | Run Python scripts that call MonoClaw tools programmatically | Code Execution |
| Browser | Web browsing and scraping | Browser |
| Hooks | Event-driven callbacks and middleware | Hooks |
| Batch Processing | Process multiple inputs in bulk | Batch Processing |
What to Read Next
Based on where you are right now:
- New to MonoClaw? → Head to the Quickstart to run your first conversation.
- Completed the Quickstart? → Read CLI Usage and Configuration to customize your setup.
- Comfortable with the basics? → Explore Tools, Skills, and Memory to unlock the full power of the agent.
- Setting up for a team? → Read Security and Sessions to understand access control and conversation management.
- Ready to build? → Jump into the Developer Guide to understand the internals and start contributing.
- Want practical examples? → Check out the Guides section for real-world projects and tips.
Tip
You don't need to read everything. Pick the path that matches your goal, follow the links in order, and you'll be productive quickly. You can always come back to this page to find your next step.