nanobot: ein selbst gehosteter, leichtgewichtiger, erweiterbarer persönlicher Agent

Alles Wissenswerte über HKUDS/nanobot: eine Python-Umgebung, um einen persönlichen Agenten im Browser, Terminal oder in Messaging-Apps auszuführen, mit Speicher, Werkzeugen, MCP und Automatisierung.

---

Was nanobot ist

nanobot ist ein quelloffenes, selbst hostbares Framework für persönliche Agenten. Sein Kern führt eine Agentenschleife aus: Er empfängt Nachrichten von einer WebUI, dem Terminal oder Chat-Kanälen; fragt ein Modell ab; und fügt bei Bedarf Werkzeuge, Speicher oder Skills als Kontext hinzu. Das Ergebnis kann als lokales Gateway oder langlebiger Server betrieben werden.

Das Repository dokumentiert eine WebUI, Dateiwerkzeuge, einen Shell-Interpreter, Websuche und -abruf, MCP, Cron, Bildgenerierung, Subagenten, Langzeitspeicher, Modell-Routing und eine OpenAI-kompatible API. Die dokumentierten Kanäle umfassen Telegram, Discord, Slack, WeChat, E-Mail und Mattermost.

Der Ursprung: eine bewusst kleine Alternative

GitHub verzeichnet die Erstellung des Repositorys am 1. Februar 2026. Die Hacker-News-Diskussion, die direkt auf das Repository verlinkt, präsentierte es vier Tage später als ultra-leichte Alternative zu OpenClaw; sie erreichte 257 Punkte und 128 Kommentare.

Die Dokumentation selbst erklärt die Design-Motivation: einen lesbaren Kern zu bewahren und Speicher, Deployment, Automatisierung, Werkzeuge und Kanäle hinzuzufügen, ohne ihn in eine monolithische Plattform zu verwandeln. Diese Haltung reagiert auf eine praktische Spannung bei persönlichen Agenten: Verbindungen und persistente Arbeit anzubieten, ohne von jedem Nutzer zu verlangen, einen großen Stack oder fremde Infrastruktur zu übernehmen.

Das Projekt schreibt seinen Ursprung im README nicht öffentlich einer einzelnen Person zu. CONTRIBUTING.md nennt Re-bin als Projektverantwortlichen für Merges und chengyongru als Reviewer, der Pull Requests genehmigen kann.

Philosophie und Prinzipien

• Leichtgewichtig mit ausreichender Fähigkeit: Der Kern bleibt klein und lesbar, integriert aber die für den dauerhaften Betrieb nötigen Komponenten.

• Eigentum am Stack: Der Nutzer kann den Dienst inspizieren, anpassen und selbst hosten, statt von einer geschlossenen Plattform abhängig zu sein.
• Persistente Arbeit: Ziele, Werkzeuge, Speicher und Chat-Kontext überdauern eine einzelne Konversation.

• Wahl von Modell und Kanal: unterstützt OpenAI-kompatible Anbieter, lokale Modelle, Fallback-Alternativen und mehrere Chat-Kanäle.
• Klarheit beim Beitragen: Der Leitfaden verlangt kleine, klare, entkoppelte, dauerhafte Lösungen und vermeidet unnötige Abstraktionen oder Reformatierungen.

Wie es funktioniert

Das Gateway bündelt die Eingangskanäle, die Sitzung und die Agentenschleife. Das Modell entscheidet, wann ein Werkzeug aufgerufen wird; Speicher und Skills werden als Kontext einbezogen. Die WebUI erlaubt es, persistente Themen von temporären Chats zu trennen, Werkzeugaufrufe, Dateiänderungen, Diffs und Befehlsergebnisse zu inspizieren und Modell oder Arbeitsbereich direkt aus der Konversation zu wechseln.

Die stabile Version v0.3.0, veröffentlicht am 25. Juli 2026, heißt „The Agency Release”. Ihre Notizen kündigen Inline-Subagenten, Modell-Preset-Auswahl pro Sitzung, geführtes Onboarding in der WebUI und Live-Anwendung von Konfigurationsänderungen an.

Offizieller und halboffizieller Status

nanobot ist ein HKUDS-Projekt, das offiziell über sein Repository, seine Dokumentation nanobot.wiki und das PyPI-Paket nanobot-ai vertrieben wird, wo Version 0.3.0 und der Installationsbefehl aufgeführt sind.

Es wurde kein Beleg für eine Aufnahme in einen offiziellen Marktplatz von Anthropic, OpenAI, Cursor oder einem anderen Agenten-Anbieter gefunden. Es gibt jedoch dokumentierte technische Integration mit MCP und eine OpenAI-kompatible API; das deutet auf Interoperabilität hin, nicht auf Unterstützung, Zertifizierung oder Standardstatus dieser Anbieter.

Das Ökosystem

Kanäle, Erweiterungen und First-Party-Dienste

Die Dokumentation positioniert nanobot als Integrationspunkt für MCP, lokale oder OpenAI-kompatible Anbieter, Automatisierungen, WebUI, ein Python-SDK und eine OpenAI-kompatible API. Sie verlinkt außerdem anbieterspezifische Leitfäden, Deployment, Chat-Kanäle, Speicher, Automatisierungen und Werkzeuge.

Innerhalb von HKUDS wurden thematisch nahe Projekte identifiziert, keine erklärten Abhängigkeiten von nanobot: HKUDS/AutoAgent (ein No-Code-Agenten-Framework), HKUDS/OpenHarness (ein Agenten-Harness mit persönlichem Assistenten), HKUDS/ClawTeam (Schwarmintelligenz), HKUDS/AnyTool (eine Werkzeugnutzungsschicht) und HKUDS/LightRAG (retrieval-augmentierte Generierung). Die Recherche fand in deren Metadaten keine Erklärung, die sie zu verpflichtenden Komponenten von nanobot machen würde; sie sollten als Schwesterprojekte derselben Organisation verstanden werden, nicht als automatisch installierte Module.

Forks, Ports und Community-Werkzeuge

Die Forks-API zeigt Ableitungen mit einer expliziten Beziehung in ihrer Beschreibung.

• shenmintao/NanoMate (87 Sterne): kombiniert nanobot mit SillyTavern und bewirbt einen Begleiter-Modus.
• YH7916/Interview-Copilot (4 Sterne): beschrieben als Interview-Copilot basierend auf nanobot.
• KeLuoJun/QuantBot (2 Sterne): eine Anpassung für quantitative Finanzunterstützung.
• forzyh/nanobot-zh-annotated (2 Sterne): eine kommentierte chinesische Ausgabe, eine Form der Community-Lokalisierung.
• luoluocodex/nanobot-ts (keine Sterne in der abgerufenen Suche): als TypeScript-Migration von nanobot deklariert.
• SChapelais/NanoRAG-for-Nanobot und chapelaissamuel/NanoRAG-for-Nanobot (keine Sterne in der abgerufenen Suche): präsentiert als abhängigkeitsfreies RAG, inspiriert von HKUDS, für extrem eingeschränkte Umgebungen.
• Shudh/nanobot-community-docker und orrinwitt/nanobot-docker (keine Sterne in der abgerufenen Suche): inoffizielle Community-Docker-Images; das zweite behauptet, zusätzliche Dienstprogramme und MCP-Server zu enthalten.

Das sind Forks, Ports, Dokumentation oder Paketierung von Drittanbietern, keine offiziellen Erweiterungen. Die Suche fand auch chinesische Lernleitfäden und Bildungsanpassungen, was multilinguale Community-Aktivität bestätigt, aber keine Überprüfung eines offiziellen Erweiterungskatalogs erlaubte.

Zahlen des Repos

Messung: 11. August 2026; GitHub-API.

Metrik	Wert
Sterne	46.859
Forks	8.288
Echte Abonnenten	205
Hauptsprache	Python
Lizenz	MIT
Erstellung	1. Februar 2026
Letzter Release	v0.3.0, 25. Juli 2026
Feld open_issues_count	701

Die von der API zurückgegebenen führenden Contributor waren Re-bin (1.687 Beiträge), chengyongru (801), Athemis (47), axelray-dev (42) und yorkhellen (36).

Es gibt zwei Vorbehalte: watchers_count in der allgemeinen Antwort spiegelt die Sternzahl wider, weshalb subscribers_count als tatsächliche Abonnenten angegeben wird. Zudem kann open_issues_count offene Pull Requests einschließen und entspricht nicht notwendigerweise ausschließlich Issues. Die API lieferte updated_at- und pushed_at-Werte vom 12. August 2026, später als das Datum dieses Durchlaufs; diese werden als Anomalie der Quellmetadaten transkribiert, ohne zukünftige Aktivität zu interpretieren.

Wie man beiträgt

Beitragen ist dokumentiert und akzeptiert Features, Fixes, Dokumentation, kleine Anpassungen, abgegrenzte Refactorings sowie API- oder Konfigurationsänderungen, deren Auswirkung erklärt wird. Für große oder riskante Änderungen wird gebeten, frühzeitig ein Issue oder einen Entwurfs-PR zu eröffnen.

Der angegebene Ablauf ist, den Klon zu synchronisieren, einen Themen-Branch zu erstellen und lokale Prüfungen auszuführen:

git fetch upstream
git switch main
git pull --ff-only upstream main
git switch -c mein-branch

pip install -e ".[dev]"
pytest
ruff check nanobot/

Für strikte Typisierung spezifiziert der Leitfaden uv sync --all-extras --dev, die Installation von Kanal-Abhängigkeiten und uv run --no-sync basedpyright. Er warnt auch davor, eine funktionale Änderung mit massiven Reformatierungen zu vermischen. Beiträge werden unter MIT lizenziert.

Wie die Community reagierte

Die überprüfbare Resonanz kombiniert erhebliches Interesse mit Zweifeln an Komplexität, Sicherheit und funktionalen Grenzen.

• Der Hacker-News-Thread 46897737, eingereicht von ms7892, verlinkte direkt auf das Repository und erreichte 257 Punkte und 128 Kommentare. In diesem Thread schätzte skeledrew, dass nanobot, direkt von OpenClaw inspiriert, Komponenten gut zusammenführte, die er nicht selbst zusammenbauen wollte, und hob hervor, dass es Python statt JavaScript sei. Das ist eine individuelle Erfahrung, kein Vergleichstest.
• Im selben Thread grenzte johaugum den Umfang ab: Er unterschied einen Agenten, der eine persönliche Aufgabe löst, wie das Sammeln von E-Mail-Quittungen, von einer autonomen Infrastruktur zur Planung, Neuplanung und kontinuierlichen Ausführung von Engineering-Aufgaben. Das ist eine nützliche Warnung davor, nanobot als allgemeinen Unternehmensplaner zu interpretieren.
• halfax bezeichnete es als „Spielzeug” und konzeptionelle Skizze im Vergleich zu einem anderen System namens HAL-AI-2. Die Kritik wird diesem Kommentator zugeschrieben; es wurde keine unabhängige Methodik gefunden, die sie validiert.
• In einer GitHub-Diskussion sammelte Re-bins Roadmap 40 Stimmen und 96 Kommentare, während Nutzer Fragen zu WeCom-Berechtigungen, Docker, Cron, Anbietern und Modellfehlern aufwarfen. Das bestätigt eine aktive Nutzungs- und Support-Community, keine einheitliche Qualitätsbewertung.

Eine direkte HN-Suche fand außerdem eine erste Einreichung mit 3 Punkten und null Kommentaren. Diese wird nicht als Beleg für Community-Zustimmung verwendet. Automatisierte Abfragen bei Reddit, X und Product Hunt lieferten kein überprüfbares Protokoll von Konversation oder Launch, das HKUDS/nanobot zuzuordnen wäre; diese Zugriffsbeschränkung sollte nicht als Abwesenheit von Berichterstattung gelesen werden.

nanobot im Vergleich zu anderen Ansätzen

Vorschlag	Überprüfbare Übereinstimmung	Überprüfbarer Unterschied oder Grenze
OpenClaw	Der HN-Thread selbst positioniert nanobot als von OpenClaw inspirierte Alternative; beide gehören zum Bereich persönlicher Agenten mit Werkzeugen.	nanobot beansprucht einen kleinen, lesbaren Python-Kern; der in Videos gesehene Zeilenzahl-Vergleich ist eine Behauptung seiner Autoren, keine hier übernommene Messung.
moltis-org/moltis	Wurde von skeledrew als verwandter Rust-Port innerhalb der Konversation über Alternativen genannt.	Seine offizielle Dokumentation wurde in diesem Durchlauf nicht abgerufen; daher wird keine technische Gleichwertigkeit behauptet.
NanoMate	Ein Fork, der behauptet, nanobot und SillyTavern für einen Begleiter-Modus zu nutzen.	Es ist eine Community-Spezialisierung, kein offizieller Ersatz oder Beweis vollständiger Kompatibilität.

Kurzanleitung zur Nutzung

Installation und erster Start

Python 3.11 oder neuer ist erforderlich; Git wird nur zur Installation aus dem Quellcode benötigt. Für eine stabile Installation bietet das Projekt diese Optionen:

uv tool install nanobot-ai
# oder
python -m pip install nanobot-ai

nanobot --version
nanobot webui

Beim ersten Start erstellt nanobot webui bei Bedarf Konfiguration und Arbeitsbereich, startet das Gateway und öffnet http://127.0.0.1:8765. Die WebUI ist standardmäßig an localhost gebunden.

Unter Settings → Models wählt man Anbieter, Zugangsdaten und Modell. Danach wird Hello! gesendet, um die Verbindung zu überprüfen.

Zeigt pip externally-managed-environment an, empfiehlt die Dokumentation uv, pipx, den offiziellen Installer oder eine virtuelle Umgebung. Ist das Ausführbare nicht im PATH, sollte der Installationsbefehl wiederverwendet werden, oder uv tool run --from nanobot-ai nanobot ..., pipx run --spec nanobot-ai nanobot ... oder der Interpreter der Umgebung genutzt werden, in der es installiert wurde.

Übliche Arbeitsabläufe

1. Persistenter lokaler Chat: nanobot webui ausführen, das Modell konfigurieren und ein Thema in der WebUI erstellen; dort können Werkzeuge, Dateien und Ergebnisse inspiziert werden.
2. Einmalige Anfrage oder Terminal-Automatisierung: nanobot agent -m "Hello!" ausführen; liefert eine Antwort und beendet sich.
3. Interaktive Terminal-Sitzung: nanobot agent ausführen; teilt konfiguriertes Modell, Arbeitsbereich und Werkzeuge, hält aber keine Kanäle oder Automatisierungen nach dem Beenden aktiv.
4. Ein dauerhaft laufendes Gateway: nach Abschluss der Ersteinrichtung im Vordergrund nanobot webui --background ausführen. Zur Steuerung des Gateways dienen nanobot gateway status, nanobot gateway logs, nanobot gateway restart und nanobot gateway stop.

Wesentliche Konfiguration

• ~/.nanobot/config.json: die Konfigurationsdatei; Dokumentationsbeispiele werden in sie eingefügt, nicht vollständig ersetzt.
• Settings → Models: der erste Ort, um Anbieter, Zugangsdaten und Modell in der WebUI zu wählen.
• Settings → Channels: Konfiguration für Chat-Apps wie Telegram, Discord, Slack oder WeChat.
• Apps: WebUI-Zugriff auf CLI-App-Integrationen oder MCP-Server.
• Arbeitsbereich und Zugriffsmodus: werden im Composer gewählt, bevor an Projekten gearbeitet wird.

Häufige Fallstricke und Lösungen

• WebUI öffnet sich ohne konfiguriertes Modell: Das ist erwartetes Verhalten; Settings → Models vervollständigen und Hello! senden, bevor Werkzeuge diagnostiziert werden.
• pip-Installation durch den Systemmanager blockiert: uv, pipx oder eine virtuelle Umgebung nutzen, statt eine globale Installation zu erzwingen.
• Der Befehl nanobot wird nicht gefunden: den vom Installer gemeldeten Befehl wiederverwenden oder über uv tool run oder pipx run ausführen.
• Aus Quellcode unter Windows installiert und npm startet nicht: in webui wechseln, npm.cmd install --package-lock=false und npm.cmd run build ausführen, zurück zur Wurzel gehen und die Installation erneut versuchen.
• Verbindungsverlust bei Docker-Deployments oder Kanalberechtigungen: es gibt dedizierte Diskussionen zu Docker, WeCom und Kanälen; es lohnt sich, gemäß der Diagnoseanleitung zu isolieren, ob der Fehler bei Installation, Konfiguration, Modell, Gateway, Kanal oder Werkzeugzugriff liegt.

Integrationen und Migration

nanobot kann sich von Apps aus mit MCP-Servern verbinden, eine OpenAI-kompatible API und ein Python-SDK bereitstellen und mit lokalen Modellen über Ollama oder OpenAI-kompatible Server wie vLLM arbeiten. Das README präsentiert nanobot gateway als vertrauten Einstiegspunkt für alle, die von OpenClaw migrieren: Es vermeidet das Öffnen des Browsers und führt das komplette Gateway im Terminal aus. Es wurde keine automatisierte Migrationsanleitung oder ein Konfigurations-Importer von OpenClaw gefunden; die dokumentierte Migration ist operativ, über ein neu konfiguriertes Gateway, Anbieter und Kanäle.

Anwendungsfälle

• Personen, die einen eigenen Assistenten wollen, können Konversationen, Speicher und Werkzeuge unter einer lokalen oder selbst gehosteten Instanz führen, statt sich nur auf eine entfernte Oberfläche zu verlassen.
• Kleine Teams, die Arbeit über Chat koordinieren, können Kanäle wie Telegram, Discord, Slack, E-Mail oder WeChat verbinden und dasselbe Gateway, Modell und denselben Arbeitsbereich beibehalten.
• Entwickler, die KI in eine bestehende Anwendung integrieren, können die OpenAI-kompatible API, das Python-SDK oder MCP nutzen, um lokale Werkzeuge und Automatisierungen zu verbinden.
• Betreiber, die persistente Aufgaben benötigen, können das Gateway im Hintergrund ausführen, Protokolle prüfen und geplante Automatisierungen nutzen; für den Produktivbetrieb sind Docker, Compose und Systemdienste dokumentiert.
• Wer eine Alternative mit kleinerer Angriffsfläche zu einem größeren Agenten-Stack sucht, kann den Python-Kern bewerten, sollte aber unabhängig Berechtigungen, Token-Verbrauch, Isolation und Planer-Grenzen validieren, bevor Zugriff auf sensible Daten oder Befehle gewährt wird.

Ressourcen

• Repository: https://github.com/HKUDS/nanobot
• Offizielle Dokumentation: https://nanobot.wiki/docs/latest/getting-started/nanobot-overview
• Paket und Installation: https://pypi.org/project/nanobot-ai/
• Konfiguration und Einstiegsleitfaden: https://github.com/HKUDS/nanobot/blob/main/docs/configuration.md und https://github.com/HKUDS/nanobot/blob/main/docs/quick-start.md
• Contributing: https://github.com/HKUDS/nanobot/blob/main/CONTRIBUTING.md
• Releases und Änderungen: https://github.com/HKUDS/nanobot/releases
• Community/Discord: https://github.com/HKUDS/nanobot/discussions und https://discord.gg/MnCvHqpUGB
• Hacker-News-Konversation: https://news.ycombinator.com/item?id=46897737

---

Hinweis: Dieser Artikel kombiniert das Repository, offizielle Dokumentation, PyPI, GitHub-Diskussionen, Hacker News und YouTube-Ergebnisse, abgerufen am 11. August 2026. Metriken ändern sich mit der Zeit.