Moltbot

Moltbot Getting Started Guide

Welcome to the Moltbot getting started guide! Moltbot is a powerful multi-platform AI agent tool. This tutorial will help you quickly install and configure Moltbot for your first intelligent conversation.

What is Moltbot?

Moltbot is an AI agent platform that connects multiple chat platforms with AI through a single Gateway process. It supports:

  • WhatsApp（via Baileys）
  • Telegram（via grammY）
  • Discord（via discord.js）
  • iMessage（macOS only）
  • Mattermost and more via plugins

Think of it as your personal AI assistant that can actually do things across all your messaging apps.

WhatsApp

via Baileys

Telegram

via grammY

Discord

via discord.js

iMessage

macOS only

Moltbot Installation Prerequisites

Before you begin, make sure you have:

RequirementDetails
Node.jsVersion 22 or higher (Download)
pnpmRecommended for source builds (Install)
Brave Search APIRecommended for web search capability
macOSXcode Command Line Tools (if building from source)
WindowsWSL2 strongly recommended

Moltbot Quick Start

1

Install the CLI

The fastest way to install Moltbot:

curl -fsSL https://molt.bot/install.sh | bash

Or install via npm/pnpm globally:

pnpm add -g moltbot # or npm install -g moltbot
2

Run the Onboarding Wizard

This is the recommended way to set up Moltbot. The wizard will guide you through all configuration steps.
moltbot onboard --install-daemon

The wizard will configure:

  • Local or remote Gateway connection
  • Authentication (OAuth or API keys)
  • Messaging providers (WhatsApp/Telegram/Discord/Mattermost)
  • Background daemon service
  • Gateway tokens
3

Verify the Gateway

After onboarding, the Gateway service runs automatically. Verify it's working:

moltbot gateway status

Access the local Dashboard at: http://127.0.0.1:18789/

4

Connect Your First Channel

Choose your preferred messaging platform:

WhatsApp（recommended）：

moltbot channels login

Scan the QR code with your phone to connect.

Telegram / Discord / Mattermost：Configure via the onboarding wizard, or see the Channels Guide

5

Handle DM Safety

When receiving messages from unknown contacts, you'll need to approve pairing:

moltbot pairing approve <channel> <code>

Verify Moltbot Installation

Run these commands to ensure everything is working:

# Check overall status moltbot status # Health check moltbot health # Security audit (recommended before production) moltbot security audit --deep

Moltbot Key Configuration Paths

Keep these locations in mind:

PathPurpose
~/.clawdbot/moltbot.jsonYour personal configuration
~/clawd/Workspace for skills, prompts, memories
http://127.0.0.1:18789/Local Gateway Dashboard

Moltbot Security Checklist

Before going to production, ensure you follow these security practices:
  1. Never give production credentials to your AI agent
  2. Use separate API keys for development and production
  3. Apply least privilege - only enable skills you need
  4. Enable audit logging for all agent actions
  5. Set spending limits on AI provider accounts

Read the full Security Checklist

This is an Unofficial Guide

This website is a community resource and is not affiliated with the official Moltbot team. For official documentation, visit docs.molt.bot

Moltbot Next Steps

Moltbot macOS App Setup

Easiest way to get started with Moltbot on Mac

View guide

Moltbot Channel Integration Guide

Connect Moltbot to WhatsApp, Telegram, Discord

View guide

Moltbot Configuration Reference

Moltbot config files and environment variables

View guide

Moltbot Security Checklist

Essential Moltbot security before production

View guide
Moltbot Getting Started - Multi-Platform AI Chatbot Setup