Moltbot Setup Guide
Welcome to Moltbot! This guide will help you get up and running with your AI assistant.
Moltbot Quick Start
Key locations (keep your customizations here, safe from updates):
| Path | Purpose |
|---|---|
~/.clawdbot/moltbot.json | Your personal configuration |
~/clawd | Skills, prompts, memories (make it a private git repo) |
Two workflows:
| Workflow | Description |
|---|---|
| Stable | Install the macOS app, let it manage the Gateway |
| Bleeding edge | Run Gateway yourself via pnpm gateway:watch, attach macOS app in Local mode |
Prerequisites
Before you begin, ensure you have:
- Node.js >= 22 (Download)
- pnpm (Install guide)
- Docker (optional, only for containerized setup/e2e)
Most users should start with the macOS App workflow - it's the easiest way to get started.
Choose Your Moltbot Installation
Recommended
Moltbot macOS App Setup
Recommended - Install Moltbot.app and get started in minutes
View guideMoltbot Gateway Development
For developers who want hot reload and full control
View guideMoltbot Linux Deployment
Deploy on Linux servers with systemd
View guideMoltbot Docker Setup
Optional containerized deployment
View guideMoltbot Configuration & Reference
Moltbot Customization Strategy
To ensure updates don't break your setup, keep all customizations outside the moltbot repo:
Config File
Your personal configuration lives at ~/.clawdbot/moltbot.json:
{
"workspace": "~/clawd",
"defaultModel": "claude-sonnet-4-20250514",
"channels": {
"telegram": {
"enabled": true
}
}
}Workspace Directory
Your skills, prompts, and memories live in ~/clawd:
~/clawd/
├── skills/ # Custom skills
├── prompts/ # Custom prompts
├── memories/ # Conversation memories
└── .git/ # Recommended: make it a private repoBootstrap your setup with a single command:This creates the config file and workspace directory for you.
moltbot setupMoltbot Health Check
After setup, verify everything is working:
moltbot healthYou should see all systems reporting green.