
Most people use one AI in one chat window. You ask a question, you get an answer, and the next chat starts from zero.
A team of AI agents works in a different way. You make one bot for each job, for example a researcher, an editor and an inbox manager. Each bot has its own computer, its own memory, its own apps and its own schedule. You talk to each bot like a contact in a chat app.
OpenMausBot is a free, open-source app that gives you this team. It runs on Mac, Windows and Ubuntu, and the bots use the Claude or ChatGPT plan that you pay for now. This guide gives you each step, from the install to your first scheduled task. You do not need to write code.
Short answer: to build a team of AI agents, install Claude Code or Codex and sign in. Then install the free OpenMausBot app, make one bot for each job and give each bot a task. Each bot can use its own virtual computer, keep notes between tasks and run on a schedule.
- The app is free and open source (Apache 2.0 license). Your Claude or ChatGPT plan pays for the AI work.
- It works on macOS, Windows (x64) and Ubuntu 24.04. Ubuntu support is a beta.
- A bot asks you before a risky action, for example a shell command or a change to a file.
- The free app works while your computer is on. Cloud plans that keep your bots at work with the computer off cost $15, $49 or $99 a month.
- A cloud computer from Boat is a paid service after its trial. A Local VM on your own computer has no cloud fee.
What a team of AI agents is
An AI agent is an AI that does a task for you. It does more than answer a question. It can open web pages, read them, use apps and write files. Then it sends you the result.
A team of AI agents is a group of agents with one job each. This gives you four advantages over one chatbot for all of your work:
- Clear jobs. A bot with one job needs short, clear instructions. Its notes stay about that job only.
- Separate memory. Each bot keeps its own notes between tasks. Your inbox bot does not fill your research bot with email details.
- Separate computers. Each bot can work on its own virtual computer. One bot can search the web while a second bot works on a file.
- Schedules. A bot can do a task at a set time, for example every morning at 5 AM. You do not have to send a new message.
Large companies make products of this kind too. The OpenMausBot README says that four closed products became available in seven weeks of 2026. They are Grok Bot from xAI, Muse from Meta, dots from OpenAI and Cue by Manus. The README also says that each of them keeps the model, the computer and your data on the side of its maker. OpenMausBot keeps them on your computer.
What OpenMausBot is
OpenMausBot is a desktop app by Milind Soni. The project website also names Omkar Satpute as a creator. On 18 November 2026, the GitHub page had more than 24,700 stars. The newest version was 0.1.169, released on 17 November 2026.
Each bot in the app is a real agent. It is Claude Code or Codex, and it runs on your computer. You can give each bot its own name, model, computer and apps.
The app has two parts. A small server on your computer controls the agents. The chat app shows your bots like contacts in a message app. Your chats, keys and events stay in a folder on your computer (~/.openmausbot), not in a cloud.
The app has two names. The website of the maker calls it MausBot. The GitHub page and the installer files call it OpenMausBot. Before that, the project had the name OpenGrokBot. It is not related to xAI, Meta, OpenAI or Manus.
The maker also gives a warning: OpenMausBot has no crypto token. If a coin uses the OpenMausBot, Maus or SupaMaus name, the coin is not from this project.
Before you start
| You need | Details |
|---|---|
| A computer | macOS (Apple silicon or Intel), Windows x64, or Ubuntu 24.04 x64. Ubuntu is a beta, with GNOME as the supported desktop. |
| An agent engine | Claude Code, Codex or the Grok command-line app, installed and signed in. A command-line app is a text tool that you use in a terminal window. |
| An AI plan | Claude Pro costs $20 a month, or $17 a month if you pay for a year. ChatGPT Plus costs $20 a month and includes the Codex command-line app. |
| Disk space | The installer is about 270 to 340 MB. |
| Optional | A Boat API key for cloud computers. Docker or Podman for a Local VM. A Composio project key for some apps. |
Start with one engine and one bot. The download page of the maker says the same: your first task needs no connected apps and no cloud computer.
Stage 1: Install an agent engine
OpenMausBot does not include an AI model. Each bot uses an agent engine that you install on your computer. Choose the engine for the plan that you have.
Option A: Claude Code, with a Claude plan
- Open a terminal. On a Mac, open the Terminal app. On Windows, open PowerShell. You do not need administrator rights.
- On a Mac or on Linux, type this line and press Enter:
curl -fsSL https://claude.ai/install.sh | bash - On Windows, type this line in PowerShell and press Enter:
irm https://claude.ai/install.ps1 | iex - The install shows no progress while it downloads. When it stops, open a new terminal window and type
claude --version. You should see a version number. - Type
claudeand press Enter. Sign in with your Claude account.
If the terminal says that claude is not found, the install folder is not on your PATH yet. The PATH is the list of folders where your computer looks for commands. The Claude Code setup guide shows the fix.
Option B: Codex, with a ChatGPT plan
- Install Node.js if you do not have it.
- Type this line in a terminal and press Enter:
npm install -g @openai/codex - On a Mac with Homebrew,
brew install --cask codexalso works. - Type
codexand select Sign in with ChatGPT.
The Codex pricing page lists the command-line app on the Plus plan ($20 a month) and higher plans. The Free and Go plans list Codex in the desktop app only.
If you are not sure, let the app help you. Its first screen has an engine check. The check helps you install and sign in to one engine, for example Claude Code or Codex.
Stage 2: Install OpenMausBot
Get the installer from the latest release on GitHub or from the download page of the maker. The file names say OpenMausBot.
On a Mac
- Download OpenMausBot.dmg for a Mac with Apple silicon (M-series chips). For an older Intel Mac, download OpenMausBot-intel.dmg.
- Open the .dmg file and drag OpenMausBot to your Applications folder.
- Open the app from Applications. macOS can ask you to confirm that you want to open an app from the web. The Mac app has a signature from the maker and a security check from Apple.
On Windows
- Download OpenMausBot-setup.exe.
- Run it. The installer does not need administrator rights.
- Windows SmartScreen shows "unknown publisher", because the installer does not have a code signature yet. Make sure that the file came from the GitHub release page. Then click More info, then Run anyway.
On Ubuntu
- Download OpenMausBot-amd64.deb.
- Type this line in a terminal, or double-click the file:
sudo apt install ./OpenMausBot-amd64.deb - On a Linux system that is not Ubuntu, download the .AppImage file. Make it executable and run it.
Stage 3: Connect the engine
- Open OpenMausBot. The first screen does the engine check.
- If your engine is in the list, select it.
- If your engine is not in the list, finish its install and its sign-in. Then do the engine check again.
- Later, you can find the same check in App settings > Agent engines.
You can also connect an API key from OpenAI, OpenRouter and other services. But the setup guide of the project says that API-key connections support chat only at this time. For bots that use tools and computers, sign in with Claude Code or Codex.
Stage 4: Make one bot for each job
- Select New or share, then New bot.
- Give the bot a name that tells its job, for example Script Researcher.
- Choose the engine and a model. You can change the model of a bot later, also in the middle of a chat.
- Add a work folder only if the bot works with files.
- Do the same for each job.
Start with two or three bots. Here are three example jobs for a small business or a creator:
- Script Researcher. Finds topics, facts and sources for your posts and videos.
- Video Editor. Works on the files in one project folder.
- Inbox Manager. Reads and sorts your email, after you connect Gmail (Stage 9).
Send each bot a short job description as its first message. Memory is on by default, so the bot keeps notes about its job. Copy this text and change it for each bot:
You are my Script Researcher. Your job is to find new AI tools and the facts about them. For each tool, give the name, the maker, the link, the price and one sentence about what it does. Use only facts from pages that you opened. Give the link for each fact. If you are not sure about a fact, tell me.Prefer a one-click copy? The setup steps and the notes to read before you start are on our free OpenMausBot page.
Stage 5: Give a bot its first task
Start with a small task. The maker suggests this test. It needs no apps and no computer:
Help me plan tomorrow morning. I have two hours to reply to emails, write a project update, and prepare for a meeting. Suggest how much time to spend on each task and put them in a simple schedule.When that works, give your research bot a real task:
Find all the new AI tools of this week. Open each source page and read it. Send me a list with the name, the link and one sentence about each tool.The reply comes into the chat as the bot writes it. Small labels show which tools the bot runs. Sometimes the bot wants to run a shell command, change a file or ask you a question. Then a card comes into the chat with Allow and Deny. Read each card before you click.
Stage 6: Give a bot a computer
A bot that searches the web or uses apps on a screen needs a computer. Open the Computer panel of the bot and choose where it runs:
| Option | What it is | Cost and limits |
|---|---|---|
| Cloud | A remote Linux computer with a desktop and a terminal, from Boat | Needs a Boat API key. Boat is a paid service after its trial. |
| Local VM | An isolated virtual computer inside your own computer | Needs a container tool, for example Docker or Podman. No cloud fee. |
| This computer | The bot controls your own desktop | Mac and Windows. On Ubuntu, only on Xorg and only after you allow it. Not available on Ubuntu Wayland. |
With a cloud computer, the panel shows a live view of the screen of the bot while it works. Click Open desktop to take control in your browser.
Start with Cloud or Local VM. These keep the bot away from your own files and accounts. Give a bot your own computer only when you trust the job and you read the approval cards.
Stage 7: Control what each bot remembers
By default, each bot keeps notes between tasks. The notes are plain text files in a folder on your computer, one folder for each bot. The main file is MEMORY.md. At the start of each task, the app loads the first 200 lines or the first 24 KB of that file, whichever is smaller.
- To see or edit the notes, open Bot Settings > Memory. Each change has a one-click undo.
- To stop memory for one bot, set the Let this bot use memory switch to off while the bot is idle.
- If a bot reads a key, a token or a password, the app removes it from the note before it saves the file.
Keep MEMORY.md short. If a note is after line 200 or after 24 KB, the bot does not see it at the start of a task.
Stage 8: Put a bot on a schedule
Tell the bot the schedule in plain words. For example:
Every morning at 5 AM, find the new AI tools of the last 24 hours and send me a list. Use the America/New_York time zone.The bot makes the schedule in the same turn. A card in the chat shows the rule, the time zone and the next three dates, with Edit, Pause and Undo. Triggers, the first item in the sidebar, shows all of your schedules with a calendar and the run history.
- A schedule can run once, on selected weekdays, or every 5 to 1,440 minutes.
- If the last run is not finished, the app skips the next run. Slow tasks do not make a long queue.
- On the free app, a schedule runs only while your computer is on and the app runs.
Stage 9: Connect your apps
Bots can use Gmail, Slack, GitHub, Notion, Linear and more than 500 other apps. The connection goes through Composio, a service that connects apps to AI agents.
- Open Connected apps in OpenMausBot.
- Choose an app, for example Gmail. Give the account a label, for example work or personal.
- Finish the sign-in in your normal browser. Every bot can then use the app as a tool.
- To connect a second account of the same app, choose Add account and give it a different label.
The Composio guide of the project shows two ways to connect. By default, the desktop app uses the connection service of OpenMausBot. You can also use your own Composio project key. Get it on the API Keys page of your Composio project (it starts with ak_). Then save it in Settings > API keys, under Self-host connected apps. Some apps connect only with your own key. But with your own key, a bot cannot start on an app event, for example a new email, at this time.
An app event is a trigger like "when I get an email from this client, write a draft reply". The app checks Gmail for new events every 15 minutes.
What it costs
| Item | Price | Notes |
|---|---|---|
| OpenMausBot app | $0 | Free and open source, Apache 2.0 license. Unlimited bots. |
| Claude Pro, for Claude Code | $20 a month, or $17 a month billed yearly | Usage limits apply every 5 hours and every week. |
| ChatGPT Plus, for Codex | $20 a month | Includes the Codex command-line app. Usage limits apply. |
| Boat cloud computer | Paid after its trial | Only if you choose Cloud for a bot. |
| MausBot Cloud Starter | $15 a month | 5 bots awake and 2 at work at the same time. 100 computer-hours a month. |
| MausBot Cloud Pro | $49 a month | All bots awake, about 3 to 4 at work at the same time. 300 computer-hours a month. |
| MausBot Cloud Max | $99 a month | About 8 or more bots at work at the same time. 800 computer-hours a month. |
No plan includes the use of the AI model. The pricing page says that you connect your own Claude or ChatGPT account, or an API key, and your provider bills you for the use.
Each bot that works uses your Claude or ChatGPT limits. A team of five bots can use your plan faster than one chat. Start with one or two bots and look at your usage after the first week.
No time to build a team like this for your business? Our AI automation service builds and runs AI workflows for you.
Limits and common problems
- Your engine is not in the list. Finish the install and the sign-in of Claude Code or Codex. Then refresh the engine check in App settings.
- Windows shows "unknown publisher". The Windows installer does not have a code signature yet. Download it only from the GitHub release page or the download page of the maker.
- Bots stop when the laptop sleeps. The free app works only while the computer is on. For bots that work day and night, you need a Cloud plan or your own server. The README shows how to run a server with
npx openmausbot serve. - Ubuntu is a beta. Bot control of your own desktop is off by default on Xorg and not available on Wayland. Cloud and Local VM work on both.
- The project is young. The README calls its status "early but real". The phone apps are available only through the Discord server of the project. Some hosted features are still in progress.
- Keys in the terminal version. If you install it with
npx openmausbot, the app saves API keys as plain text in a privateconfig.jsonfile. The desktop app encrypts your AI provider keys through your operating system.
Alternatives, and when to choose them
The OpenMausBot README compares the app with the closed products. Here is what it says about each one, on 18 November 2026:
- Grok Bot (xAI). A group of bots on one shared cloud computer. Grok models only. You need a SuperGrok or Cursor plan.
- Muse (Meta). One personal agent on a cloud computer from Meta. Available in the US and Canada only.
- dots (OpenAI). An agent that is always on, inside ChatGPT. GPT models only, on the Pro and Business Premium plans.
- Cue by Manus. Agents with their own phone number, email and wallet. You need an invite.
Choose a closed product if you want no setup and you already pay for that plan. Choose OpenMausBot if you want your data on your own computer, a different model for each bot, or the plan that you have now.
You may not need a team at all. If you have one job at a time, one Claude Code or Codex session is enough. A team helps when you have several jobs that repeat each week.
Who this guide is not for
- People who only want a quick answer. A normal chat with Claude or ChatGPT is faster for that.
- People with no Claude plan, no ChatGPT plan and no API key.
- Companies that allow only signed Windows installers on their computers.
- People who want bots that work 24 hours a day at no cost. That needs a Cloud plan or a server that is always on.
Frequently asked questions
Is OpenMausBot free?
Yes. The app is free and open source under the Apache 2.0 license, with unlimited bots. Your Claude or ChatGPT plan pays for the AI work. Cloud plans for bots that work with your computer off cost $15, $49 or $99 a month, and they are optional.
Do I need to code to build a team of AI agents?
No. You download the app and type one or two install lines for Claude Code or Codex. After that, you talk to each bot in plain words, the same as in a chat app.
Does OpenMausBot work on Windows?
Yes. It works on Windows x64, macOS and Ubuntu 24.04. The Windows installer does not have a code signature yet, so Windows SmartScreen shows "unknown publisher". Download it only from the GitHub release page.
Do the bots work when my computer is off?
Not on the free app. The free app works while your computer is on. The MausBot Cloud plans give your bots an always-on cloud workspace, so schedules run with your laptop closed.
Is it safe to let an AI agent use my computer?
A bot asks before a risky action, for example a shell command or a file change, with an Allow or Deny card. For more safety, give the bot a Cloud computer or a Local VM, not your own desktop.
What is the difference between OpenMausBot and MausBot?
There is no difference. It is the same app. The website of the maker calls it MausBot. The GitHub page and the installer files call it OpenMausBot.
Sources
- OpenMausBot on GitHub: README, install table, license and stars
- OpenMausBot latest release (0.1.169)
- MausBot download page and first-task guide
- MausBot pricing: free app and Cloud plans
- OpenMausBot guide: bot memory
- OpenMausBot guide: routine schedules
- OpenMausBot guide: connect apps through Composio
- OpenMausBot guide: terminal setup
- Claude Code setup guide
- Codex command-line app on GitHub
- Codex pricing
- Claude plans and prices