Hoe Nanobot AI-assistent op een VPS te draaien

Nanobot is een ultracompacte persoonlijke AI-assistent (slechts ~3.400 regels code!) geïnspireerd door OpenClaw. Hij is perfect voor zelf-hosting op een goedkope VPS — je krijgt je eigen 24/7 AI-assistent die bereikbaar is via Telegram, Discord of WhatsApp. Deze gids begeleidt je door de volledige installatie.

Wat is Nanobot?

🐈 Nanobot is een minimalistische AI-agent die serieuze kracht in een klein pakket stopt:

• Ultracompact: 99% kleiner dan volwaardige alternatieven
• Multi-kanaal: Chat via Telegram, Discord, WhatsApp of Feishu
• Tool-ondersteuning: Webzoeken, code-uitvoering, bestandsbeheer
• Geplande taken: Automatiseer dagelijkse routines
• Geheugen: Onthoudt context tussen gesprekken
• Lokale LLM-ondersteuning: Draai met vLLM voor volledige privacy

GitHub: github.com/HKUDS/nanobot

VPS-vereisten

Nanobot is lichtgewicht, dus je hebt niet veel nodig:

Vereiste	Minimum	Aanbevolen
RAM	1GB	2GB
CPU	1 vCPU	2 vCPU
Opslag	10GB	20GB
OS	Ubuntu 22.04	Ubuntu 24.04
Python	3.10+	3.12

Beste budgetvps-opties:

• Hostinger KVM1: $4,99/maand (4GB RAM) ⭐ Beste prijs-kwaliteit
• Hetzner CX22: €3,79/maand (2 vCPU, 4GB RAM)
• Vultr Cloud: $5/maand (1 vCPU, 1GB RAM)

Stap 1: Eerste serverinstallatie

Log via SSH in op je nieuwe VPS en voer deze commando’s uit:

# Update system
sudo apt update && sudo apt upgrade -y

# Install Python and pip
sudo apt install python3 python3-pip python3-venv -y

# Install uv (fast Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

Stap 2: Nanobot installeren

Kies een van de volgende installatiemethoden:

Optie A: Via uv (aanbevolen)

uv tool install nanobot-ai

Optie B: Via pip

pip install nanobot-ai

Optie C: Vanuit broncode (nieuwste functies)

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

Stap 3: Initialiseren en configureren

Voer het onboarding-commando uit:

nanobot onboard

Dit maakt ~/.nanobot/config.json aan. Bewerk het bestand met je API-sleutels:

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-YOUR-KEY-HERE"
    }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4"
    }
  },
  "tools": {
    "web": {
      "search": {
        "apiKey": "BSA-YOUR-BRAVE-KEY"
      }
    }
  }
}

API-sleutels ophalen:

• OpenRouter: openrouter.ai/keys (voor LLM-toegang)
• Brave Search: brave.com/search/api/ (optioneel, voor webzoeken)

Stap 4: Testen of het werkt

Voer een snelle test uit:

nanobot agent -m "Hello! What can you help me with?"

Je zou een reactie van de AI moeten zien. Als het werkt, ben je klaar voor de volgende stap!

Stap 5: Telegram-bot koppelen

De beste manier om met Nanobot te chatten is via Telegram:

1. Een Telegram-bot aanmaken:

• Open Telegram en zoek naar @BotFather
• Stuur /newbot en volg de instructies
• Kopieer het bot-token

2. Je gebruikers-ID ophalen:

• Zoek naar @userinfobot op Telegram
• Je numerieke gebruikers-ID wordt weergegeven

3. Configuratie bijwerken:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

4. De gateway starten:

nanobot gateway

Stuur nu een bericht naar je bot op Telegram — Nanobot reageert! 🎉

Stap 6: Als service draaien (24/7)

Maak een systemd-service aan om Nanobot te laten draaien nadat je de verbinding verbreekt:

sudo nano /etc/systemd/system/nanobot.service

Plak het volgende:

[Unit]
Description=Nanobot AI Assistant
After=network.target

[Service]
Type=simple
User=YOUR_USERNAME
WorkingDirectory=/home/YOUR_USERNAME
ExecStart=/home/YOUR_USERNAME/.local/bin/nanobot gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Inschakelen en starten:

sudo systemctl daemon-reload
sudo systemctl enable nanobot
sudo systemctl start nanobot

Status controleren: sudo systemctl status nanobot

Vergeet niet om je VPS te beveiligen voordat je hem blootstelt aan het internet.

Docker-alternatief

Voorkeur voor Docker? Hier is een snelle installatie:

# Create config directory
mkdir -p ~/.nanobot

# Create config.json with your settings
nano ~/.nanobot/config.json

# Run with Docker
docker run -d \
  --name nanobot \
  --restart always \
  -v ~/.nanobot:/root/.nanobot \
  ghcr.io/hkuds/nanobot:latest \
  gateway

Logboeken bekijken: docker logs -f nanobot

Kostenoverzicht

Maandelijkse kosten:

Component	Kosten
VPS (Hostinger)	$4,99
OpenRouter API	~$5-20 (verbruiksafhankelijk)
Brave Search	Gratis tier beschikbaar
Totaal	~$10-25/maand

Tips om kosten te verlagen:

• Gebruik anthropic/claude-haiku voor eenvoudige taken (~10x goedkoper)
• Gebruik minimax/minimax-m2 als budgetoptie
• Draai een lokale LLM met vLLM voor $0 API-kosten (vereist VPS met 8GB+ RAM)

Veelgestelde vragen

Wat is het verschil tussen Nanobot en OpenClaw?

Nanobot is geïnspireerd door OpenClaw maar 99% kleiner (~3.400 regels vs 430k+ regels). Het is ontworpen voor eenvoud en aanpasbaarheid, terwijl OpenClaw meer geavanceerde functies biedt.

Kan ik Nanobot op een VPS van $5 draaien?

Ja! Nanobot is zeer lichtgewicht. Een VPS met 1GB RAM is voldoende voor normaal gebruik. Voor zwaardere workloads of meerdere kanalen, kies 2GB+ RAM.

Welk LLM-model moet ik gebruiken?

Voor de beste resultaten gebruik je Claude claude-sonnet-4 of claude-opus-4-5 via OpenRouter. Voor budgetgebruik kun je minimax-m2 proberen of een lokale LLM draaien met vLLM.

Zijn mijn gegevens privé?

Je gesprekken lopen via de LLM-provider (OpenRouter/OpenAI). Voor volledige privacy kun je een lokale LLM draaien met vLLM op een krachtigere VPS (8GB+ RAM) — zie onze gids beste VPS voor Ollama voor lokale LLM-hosting.

Kan ik Discord of WhatsApp gebruiken in plaats van Telegram?

Ja! Nanobot ondersteunt Telegram, Discord, WhatsApp en Feishu. Raadpleeg de GitHub-repo voor kanaalsspecifieke installatie-instructies.