Production-ready installation guide for Moltbot AI personal assistant.
| File | Description |
|---|---|
MOLTBOT-INSTALLATION-GUIDE.md |
Complete step-by-step installation from zero to running gateway |
MOLTBOT-POST-INSTALLATION.md |
Configuration, channels, skills, and customization |
MOLTBOT-TROUBLESHOOTING.md |
Common errors and solutions |
moltbot-setup.sh |
Automated setup script (optional) |
Follow MOLTBOT-INSTALLATION-GUIDE.md step by step.
# On a fresh Ubuntu 24.04 server as root:
curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/YOUR_REPO/main/moltbot-setup.sh -o setup.sh
chmod +x setup.sh
./setup.sh- Ubuntu 22.04 or 24.04 LTS
- VPS with at least 2GB RAM (4GB+ recommended)
- Root access
- API key from Anthropic, OpenAI, or compatible provider
Moltbot (formerly Clawdbot) is an open-source, self-hosted AI personal assistant. It connects to messaging platforms (WhatsApp, Telegram, Discord, Slack) and executes actions via AI models.
Key Features:
- Multi-channel messaging (WhatsApp, Telegram, Discord, Slack, etc.)
- Persistent memory via Markdown files
- 680+ skills available
- Proactive automation (cron jobs, heartbeats)
- Model-agnostic (Anthropic, OpenAI, local models)
GitHub: https://github.com/moltbot/moltbot
Docs: https://docs.molt.bot
As of January 2026, the npm package moltbot@latest is a placeholder. This guide covers installation from source, which is the correct method.
| Version | Date | Notes |
|---|---|---|
| 1.0.0 | 2026-01-30 | Initial release, Moltbot v2026.1.29, Node.js 24 |
Found an error or have improvements? Open an issue or PR.
MIT — Use freely, attribution appreciated.
Moltbot runs AI agents with system access. Always:
- Use on isolated servers (not personal machines)
- Configure allowlists for messaging channels
- Keep API keys secure
- Monitor logs regularly
- Run security audits
This guide is provided as-is. Test in non-production environments first.