nanobot/MULTI_BOT_SETUP.md

Running Multiple Nanobot Gateways with Docker

This guide shows you how to run multiple nanobot gateway instances, each with its own Telegram bot.

Quick Start

Step 1: Setup Config Directories

Run the setup script:

./multi-bot-setup.sh

Or manually:

# Create directories
mkdir -p ~/.nanobot-user1
mkdir -p ~/.nanobot-user2
mkdir -p ~/.nanobot-user3

# Copy your base config (if you have one)
cp ~/.nanobot/config.json ~/.nanobot-user1/config.json
cp ~/.nanobot/config.json ~/.nanobot-user2/config.json
cp ~/.nanobot/config.json ~/.nanobot-user3/config.json

Step 2: Configure Each Bot

Edit each config file with different Telegram bot tokens:

~/.nanobot-user1/config.json:

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz",
      "allowFrom": ["123456789"]
    }
  }
}

~/.nanobot-user2/config.json:

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "9876543210:XYZabcDEFghiJKLmnopQRSuvwx",
      "allowFrom": ["987654321"]
    }
  }
}

~/.nanobot-user3/config.json:

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-5"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "5551234567:LMNopqRSTuvwXYZabcdefGHIjkl",
      "allowFrom": ["555123456"]
    }
  }
}

Step 3: Run with Docker Compose (Recommended)

# Build the image (first time only)
docker compose -f docker-compose.multi.yml build

# Start all bots
docker compose -f docker-compose.multi.yml up -d

# View logs
docker compose -f docker-compose.multi.yml logs -f

# Stop all bots
docker compose -f docker-compose.multi.yml down

# Start/stop individual bots
docker compose -f docker-compose.multi.yml start nanobot-user1
docker compose -f docker-compose.multi.yml stop nanobot-user2

Step 4: Run with Docker Run Commands (Alternative)

If you prefer docker run commands:

# Build the image first
docker build -t nanobot .

# Run bot 1
docker run -d \
  --name nanobot-user1 \
  -v ~/.nanobot-user1:/root/.nanobot \
  -p 18790:18790 \
  --restart unless-stopped \
  nanobot gateway

# Run bot 2
docker run -d \
  --name nanobot-user2 \
  -v ~/.nanobot-user2:/root/.nanobot \
  -p 18791:18790 \
  --restart unless-stopped \
  nanobot gateway

# Run bot 3
docker run -d \
  --name nanobot-user3 \
  -v ~/.nanobot-user3:/root/.nanobot \
  -p 18792:18790 \
  --restart unless-stopped \
  nanobot gateway

Managing Containers

View Logs

# All bots
docker compose -f docker-compose.multi.yml logs -f

# Specific bot
docker logs -f nanobot-user1

# Or with docker-compose
docker compose -f docker-compose.multi.yml logs -f nanobot-user1

Stop/Start Containers

# Stop all
docker compose -f docker-compose.multi.yml down

# Start all
docker compose -f docker-compose.multi.yml up -d

# Restart specific bot
docker restart nanobot-user1

# Stop specific bot
docker stop nanobot-user1
docker start nanobot-user1

Check Status

# List all running containers
docker ps | grep nanobot

# Check logs for errors
docker logs nanobot-user1 --tail 50

Port Mapping

Each bot uses a different host port:

• User 1: Port 18790 → Container port 18790
• User 2: Port 18791 → Container port 18790
• User 3: Port 18792 → Container port 18790

The gateway port inside the container is always 18790, but mapped to different host ports to avoid conflicts.

Creating Telegram Bots

For each user, create a separate bot:

1. Open Telegram, search @BotFather
2. Send /newbot
3. Follow prompts to create a bot
4. Copy the token
5. Add it to the respective config file

Troubleshooting

Bot not responding

# Check if container is running
docker ps | grep nanobot-user1

# Check logs for errors
docker logs nanobot-user1

# Verify config is correct
cat ~/.nanobot-user1/config.json | jq '.channels.telegram'

Port already in use

If you get port conflicts, change the port mappings in docker-compose.multi.yml:

ports:
  - "18890:18790"  # Change 18790 to 18890

Config not loading

Make sure the volume mount is correct:

# Verify config exists
ls -la ~/.nanobot-user1/config.json

# Check if it's readable
docker exec nanobot-user1 cat /root/.nanobot/config.json

Adding More Bots

To add more bots:

1. Create new directory: mkdir -p ~/.nanobot-user4
2. Copy config: cp ~/.nanobot-user1/config.json ~/.nanobot-user4/config.json
3. Edit config with new bot token
4. Add new service to docker-compose.multi.yml (copy existing service, change name and port)
5. Run: docker compose -f docker-compose.multi.yml up -d nanobot-user4