Prerequisites
Before setting up MosBot OS, make sure you have the following installed and available.
Required
Docker and Docker Compose v2
The recommended way to run MosBot OS is via Docker Compose. You need:
- Docker Desktop (macOS/Windows) or Docker Engine (Linux) — version 24+
- Docker Compose v2 — included with Docker Desktop; on Linux install the
docker-compose-plugin
Verify your installation:
docker --version
# Docker version 24.x.x
docker compose version
# Docker Compose version v2.x.x
Git
To clone the repositories:
git --version
# git version 2.x.x
For local development (without Docker)
If you want to run MosBot API or Dashboard outside of Docker:
Node.js 20+
node --version
# v20.x.x or higher
OpenClaw (strongly recommended)
MosBot OS is designed to work with OpenClaw. While MosBot can technically run without it, the core features — agent monitoring, workspace browsing, org chart, and skills — require OpenClaw.
OpenClaw instance
You need a running OpenClaw instance. OpenClaw can run:
- Locally — directly on your machine or in Docker
- In Kubernetes — deployed to a cluster
- On a VPS — on a remote server
See the OpenClaw Integration section for setup guidance.
kubectl (Kubernetes deployments only)
Required if OpenClaw runs in a Kubernetes cluster and you need to port-forward services for local development.
kubectl version --client
System requirements
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 2 GB | 4 GB+ |
| Disk | 5 GB free | 20 GB+ |
| OS | Linux, macOS, Windows (WSL2) | Linux or macOS |
Next steps
Once you have the prerequisites, proceed to the Quickstart guide.