Getting Started with Nanobot: Build Your First AI Agent - KI

In dieser Anleitung erfahren Sie, wie Sie Nanobot einrichten, es mit WhatsApp verbinden und mit OpenAI GPT-5.3-Codex betreiben, um einen praktischen, immer aktiven KI-Agenten zu schaffen.

Einleitung

Auf der Suche nach einer Alternative zu OpenClaw stieß ich auf Nanobot. Nicht, weil OpenClaw nicht nützlich ist, sondern weil es für den täglichen Gebrauch oft zu schwerfällig und aufgebläht wirkt. Ich wollte eine Lösung, die leichtgewichtig, einfach einzurichten und unkompliziert mit WhatsApp zu verbinden ist, ohne durch viele komplizierte Schritte gehen zu müssen. So entdeckte ich Nanobot auf GitHub und bemerkte, dass viele Nutzer auf YouTube darüber sprachen.

In diesem Tutorial werden wir die Architektur von Nanobot untersuchen und erläutern, wie es funktioniert. Anschließend gehen wir in sechs einfachen Schritten durch die Installation, Einrichtung und den Prozess der Verbindung mit WhatsApp, damit Sie es als 24/7-KI-Agenten für eine Vielzahl von Aufgaben nutzen können.

Nanobot als Ihren ersten KI-Agenten nutzen

Nanobot ist eine hervorragende Wahl für einen ersten KI-Agenten, da es die gesamte Einrichtung einfach hält und gleichzeitig die Funktionen unterstützt, die im praktischen Einsatz wichtig sind. Es kann mit Messaging-Plattformen wie WhatsApp, Telegram, Slack, Discord, Feishu, QQ und E-Mail verbunden werden und arbeitet mit einer Vielzahl von Modellanbietern und Modellkontextprotokoll (MCP) Tool-Servern. Dies bietet Anfängern eine klare Möglichkeit, zu verstehen, wie ein Agent strukturiert ist, ohne mit einem System zu beginnen, das zu komplex erscheint.

Die Architektur von Nanobot hebt sich auch als Alternative zu OpenClaw hervor, da sie praktische Integrationen und eine alltägliche Nutzbarkeit von Anfang an bietet. Neben den Messaging-Kanälen unterstützt es das Aufrufen von Tools, Web-Suchen, geplante Aufgaben, Sprachtranskription, Echtzeit-Streaming von Fortschritten und mehrere Anbieteroptionen, was es einfacher macht, es in einen nützlichen persönlichen Assistenten zu verwandeln, anstatt nur ein Demoprojekt zu sein.

Schritt 1: Installation von uv

Beginnen Sie mit der Installation von uv, das von Nanobot verwendet wird, um die Python-Umgebung und Abhängigkeiten zu verwalten. Überprüfen Sie anschließend, ob die Installation erfolgreich war, indem Sie die Version abfragen.

curl -LsSf https://astral.sh/uv/install.sh | sh

Überprüfen Sie die Installation:

uv --version

Ausgabe:

uv 0.10.9 (f675560f3 2026-03-06)

Schritt 2: Installation von Nanobot

Sobald uv installiert ist, verwenden Sie es, um das Nanobot-Paket zu installieren. Dies fügt die Befehlszeilenschnittstelle (CLI) von Nanobot hinzu, sodass es direkt über das Terminal gestartet werden kann.

uv tool install nanobot-ai

Schritt 3: Ihr Nanobot-Projekt initialisieren

Führen Sie als Nächstes den Onboarding-Befehl aus, um Nanobot zu initialisieren.

nanobot onboard

Dies erstellt die grundlegende lokale Einrichtung, einschließlich des Standardkonfigurationsverzeichnisses unter ~/.nanobot und des Arbeitsbereichs, den Nanobot zur Speicherung seiner Dateien verwendet. Nach diesem Schritt ist Nanobot bereit für die Konfiguration von Anbietern, Modellen und Kanälen.

Schritt 4: Ihre Nanobot-Konfiguration hinzufügen

Navigieren Sie zu Ihrer ~/.nanobot/config.json-Datei und kopieren Sie die folgende Konfiguration. Ersetzen Sie vor dem Speichern die Platzhalterwerte durch Ihren eigenen OpenAI-API-Schlüssel, das Modell und Ihre WhatsApp-Nummer.

{\n \"providers\": {\n \"openai\": {\n \"apiKey\": \"sk-REPLACE_ME\"\n }\n },\n \"agents\": {\n \"defaults\": {\n \"model\": \"openai/gpt-5.3-codex\",\n \"provider\": \"openai\"\n }\n },\n \"channels\": {\n \"whatsapp\": {\n \"enabled\": true,\n \"allowFrom\": [\"1234567890\"]\n }\n }\n}

Bevor Sie speichern, bearbeiten Sie:

apiKey mit Ihrem echten OpenAI-API-Schlüssel
model, falls Sie ein anderes Modell verwenden möchten
allowFrom mit Ihrer eigenen WhatsApp-Nummer

Ein wichtiger Hinweis: Jüngste Probleme mit Nanobot zeigen, dass die Formatierung von allowFrom in WhatsApp in der Praxis leicht inkonsistent sein kann. Einige Nutzer berichten, dass es besser funktioniert, wenn das „+“-Zeichen weggelassen wird, abhängig von ihrer spezifischen Konfiguration.

Schritt 5: Nanobot mit WhatsApp verbinden

Bevor Sie den WhatsApp-Anmeldevorgang starten, stellen Sie sicher, dass Node.js und npm auf Ihrem Computer installiert sind, da die WhatsApp-Brücke über einen Node-basierten Prozess läuft.

Starten Sie zunächst den Anmeldevorgang in einem Terminal:

nanobot channels login whatsapp

Dies generiert einen QR-Code, den Sie in WhatsApp unter Einstellungen → Verknüpfte Geräte scannen müssen. Sobald das Gerät verknüpft ist, öffnen Sie ein zweites Terminal und starten das Nanobot-Gateway:

nanobot gateway

Dies ist der Prozess, der den Kanal am Laufen hält, sodass Nanobot WhatsApp-Nachrichten empfangen und darauf reagieren kann.

Schritt 6: Testen Sie Ihren KI-Agenten auf WhatsApp

Um den Agenten zu testen, benötigen Sie ein zweites Telefon. Diese zweite Telefonnummer sollte bereits in der allowFrom-Liste in Ihrer Konfigurationsdatei hinzugefügt worden sein. Wenn Sie eine Nachricht an die erste Telefonnummer senden, die mit Nanobot verbunden ist, sollte sie über WhatsApp antworten.

In diesem Beispiel fragt die Eingabeaufforderung, was in der Welt passiert. Nanobot verarbeitet dann die Anfrage, führt eine Websuche durch, wenn die Tools aktiviert sind, und gibt eine detaillierte Zusammenfassung basierend auf den neuesten Informationen zurück.

Während das Gateway-Terminal läuft, können Sie den gesamten Workflow des Agenten in Echtzeit beobachten. Dazu gehört das Empfangen der Nachricht, das Aufrufen von Tools, das Generieren der Antwort und das Zurücksenden der Antwort, was es einfacher macht, zu bestätigen, dass alles korrekt funktioniert.

Fazit

Die Einrichtung von Nanobot hat mir gezeigt, dass der Aufbau eines persönlichen KI-Agenten nicht übermäßig kompliziert sein muss, auch wenn es nicht ganz reibungslos verlief. Ich schätzte, wie schnell ich von einer Terminaleinrichtung zu einem funktionierenden, mit WhatsApp verbundenen Agenten wechseln konnte, der in der Praxis nützliche Antworten liefert.

Allerdings stieß ich auf einige kleinere Hürden. Unter Windows, wenn Node.js oder npm bereits in einer bestimmten Konfiguration installiert war, konnte das Python-Skript manchmal npm im Terminal nicht korrekt erkennen, was die anfängliche Einrichtung etwas verwirrend machte. Zudem machte der Mangel an umfangreicher WhatsApp-Dokumentation es nicht sofort offensichtlich, dass die Schnittstelle funktioniert, indem sie direkt mit dem verbundenen Gerät kommuniziert, anstatt über eine separate Bot-Chat-Schnittstelle.

Trotz dieser kleinen Probleme bleibt Nanobot ein starker Ausgangspunkt für alle, die ihren ersten KI-Agenten erstellen möchten. Es bietet eine grundlegende Agentenerfahrung, ohne die Überlastung schwererer Alternativen. Sobald die Einrichtung funktioniert, wird der Wert sofort deutlich, da es die Lücke zwischen einfachen Terminalbefehlen und einem wirklich hilfreichen persönlichen Assistenten überbrückt.

Abid Ali Awan (@1abidaliawan) ist ein zertifizierter Datenwissenschaftler, der es liebt, Maschinenlernmodelle zu entwickeln. Derzeit konzentriert er sich auf die Erstellung von Inhalten und das Schreiben technischer Blogs über Maschinenlernen und Datenwissenschaftstechnologien. Abid hat einen Master-Abschluss in Technologiemanagement und einen Bachelor-Abschluss in Telekommunikationsengineering. Seine Vision ist es, ein KI-Produkt zu entwickeln, das mithilfe eines Graph-Neural-Netzwerks für Studenten, die mit psychischen Erkrankungen kämpfen, Unterstützung bietet.

Mehr zum Thema

„`

Bildquelle: Bildquelle: Lukas auf Unsplash

Codex Künstliche Intelligenz Nanobot OpenAI WhatsApp

KI Snack