Agent Zero mit Ollama: Docker-Installation und limites

#Was Agent Zero ist

Agent Zero (Repository agent0ai/agent-zero) stellt sich als Framework vor, das dem Agenten einen vollständigen Linux-Rechner zur Verfügung stellt: einen XFCE-Desktop in einem Docker-Container, einen Browser mit DOM-Annotation, gemeinsames Arbeiten in Echtzeit an Markdown-Dateien, Tabellen und Präsentationen sowie einen Hub mit über 100 Plugins aus der Community. Am 28. September 2026 hatte das Projekt mehr als 19.000 Sterne auf GitHub; die zuletzt mit einem Tag versehene Version v2.13 wurde am 23. September 2026 veröffentlicht.

Es handelt sich nicht um einen spezialisierten Coding-Agenten wie OpenCode oder Cline: Agent Zero zielt auf bereichsübergreifende Aufgaben ab (Recherche, Steuerung von Desktop-Anwendungen, Überprüfung von Weboberflächen, Analyse), erfordert dafür aber eine aufwendigere Infrastruktur als eine einfache Binärdatei im Terminal.

Das Projekt hebt außerdem „Agentenprofile“ hervor (spontan erstellte Spezialisten, beispielsweise für eine vorsichtige Finanzanalyse mit Ergebnissen in Tabellenkalkulationsdateien), eine Projektverwaltung, die Dateien, Secrets, Speicherinhalte und Repositories je nach Kontext voneinander isoliert, sowie eine Zusammenarbeit mehrerer Agenten, bei der ein Hauptagent Recherche, Programmierung, Analyse oder Prüfung an dafür vorgesehene Unteragenten delegiert. Jede dieser Funktionen beansprucht Kontext und die Fähigkeit des Modells, Anweisungen zu befolgen. Das wirkt sich unmittelbar auf die Modellwahl aus, sobald man über einen einfachen Chat hinausgeht.

#Den Docker-Container installieren

Wenn Docker bereits installiert ist, ist der direkteste Weg ein einzelner Befehl, der die Daten der Instanz in ein persistentes Volume einbindet. Das Projekt bietet außerdem ein Installationsskript (A0 Install) für Server und den Headless-Modus sowie einen grafischen Launcher (A0 Launcher), der Docker, Instanzen und Ports für den Nutzer verwaltet.

docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero

Sobald der Container gestartet ist, öffnet sich die Weboberfläche auf dem gewählten Port (standardmäßig 80 oder dem als Parameter angegebenen Port), damit Sie den Modellanbieter vor der ersten Aufgabe konfigurieren können. Auf einem Server ohne grafische Oberfläche unterstützt das Installationsskript einen unbeaufsichtigten Modus, der eine Instanz mit dem vorgegebenen Port erstellt, ohne ein Menü zu öffnen. Das ist für eine automatisierte Bereitstellung oder einen entfernten Rechner nützlich, der nur über SSH zugänglich ist.

#Eine lokale Ollama-Instanz verbinden

Die offizielle Installationsdokumentation beschreibt das Vorgehen im Detail: In den Einstellungen des Chatmodells, des Hilfsmodells oder des Embedding-Modells Ollama als Anbieter auswählen, den von Ollama erwarteten Modellnamen eingeben (zum Beispiel llama3.2 oder qwen2.5:7b) und anschließend die API-URL angeben, falls sie vom Standardwert abweicht.

Wenn der Container Ollama nicht erreicht, weist die Dokumentation darauf hin, dass Port 11434 vom Container aus erreichbar sein muss; die bereitgestellte Docker-Compose-Datei ordnet host.docker.internal unter Docker auf Linux dem Host-Gateway zu. Wenn beide Dienste dasselbe Docker-Netzwerk nutzen, kann die Adresse auch http://(nom du conteneur):11434 lauten.

#Welches Modell wählen und für welche Rolle?

Agent Zero unterscheidet drei Modellplätze: Chat (Hauptkonversation), Hilfsmodell (Organisation des Gedächtnisses, Zusammenfassung) und Embedding (Suche im Gedächtnis). Das Format des Modellnamens hängt vom Anbieter ab: Bei Ollama wird nur der Modellname angegeben (gpt-oss:20b), ohne Anbieterpräfix, anders als bei OpenRouter.

Der am häufigsten übersehene Punkt: Ein Modell, das sich für Gespräche ordentlich eignet, kann in einer Hilfsfunktion scheitern, wenn es zu klein ist. Dadurch verschlechtert sich unbemerkt die Qualität des Gedächtnisses, ohne dass der Benutzer versteht, warum der Agent „vergisst“ oder Fakten von einer Sitzung zur nächsten durcheinanderbringt.

#Toolaufrufe mit einem kleinen lokalen Modell

Agent Zero dokumentiert selbst ein verbreitetes Problem mit leichtgewichtigen lokalen Modellen: Das Modell erklärt den Befehl, statt das Tool aufzurufen, das ihn ausführen würde. Das Projekt bietet eine Korrektur allein über den Prompt, ohne den Code zu verändern: das Profil „Tiny Local“, das das Standardformat für Tool-Aufrufe beibehält, aber die sichtbaren Felder für die Gedankengänge aus dem Kommunikationsprompt entfernt, sodass nur ein ausführbares JSON-Objekt mit tool_name und tool_args verlangt wird.

Eine Alternative ohne Profilwechsel besteht darin, eine eigene Prompt-Datei (Erweiterung .promptinclude.md) hinzuzufügen, die die erwarteten Vorgaben wiederholt: Die sichtbare Antwort muss exakt ein JSON-Objekt mit genau den Feldern tool_name und tool_args sein, ohne Markdown-Auszeichnung und ohne Text davor oder danach. Die Dokumentation benennt die Grenze dieser Korrektur ausdrücklich: Es handelt sich um eine Anpassung von Prompt und Profil, nicht um eine Änderung des Ausführungscodes — wenn ein bestimmtes Modell trotz dieser Vorgaben weiterhin scheitert, ist der nächste Ansatz ein Modellwechsel, nicht eine weitere Verkomplizierung des Prompts.

#Was das Linux-Desktop-System wirklich verändert

Die Besonderheit von Agent Zero gegenüber rein terminalbasierten Agenten ist der vollständige XFCE-Desktop innerhalb des Containers: Der Agent kann echte grafische Anwendungen öffnen (Blender zum Modellieren eines Objekts, einen Dateimanager, ein sichtbares Terminal), und der Nutzer beobachtet jede Aktion, während er dieselbe virtuelle Maus und Tastatur mit dem Agenten teilt und jederzeit eingreifen kann.

Der integrierte Browser geht über eine einfache Seitensteuerung hinaus: Der Modus Annotate verwandelt jede Webseite in eine Oberfläche für anklickbare Anweisungen – ein Element ändern, es untersuchen, es für ein anderes Projekt übernehmen oder einen gezielten Kommentar hinterlassen, den der Agent anschließend als Aufgabe behandelt.

#MCP-Server verbinden

Über die integrierten Tools (Browser, Terminal, Dateien) hinaus kann sich Agent Zero mit externen MCP-Servern verbinden, um auf weitere Dienste zuzugreifen: Die offizielle Dokumentation beschreibt jede MCP-Verbindung als Brücke – eine kann Gmail anbinden, eine andere eine Datenbank und eine weitere ein Automatisierungstool. Ein MCP-Server wird entweder als lokal gestarteter Befehl oder als Remote-URL konfiguriert, was unterschiedliche Netzwerkbedingungen mit sich bringt: Ein lokal im Container gestarteter Befehl unterliegt denselben Einschränkungen wie der Zugriff auf Ollama (host.docker.internal, gemeinsames Docker-Netzwerk), während für eine Remote-URL die normalen Netzwerkregeln des Containers gelten.

Die Dokumentation empfiehlt, jede Verbindung auf das unbedingt Notwendige zu beschränken, statt vorsichtshalber weitere hinzuzufügen: Jeder angebundene MCP-Server erweitert den Bereich, auf den das Modell zugreifen kann, auch bei einem lokalen Modell, dessen Verhalten beim Aufrufen von Tools weniger vorhersehbar ist als das eines Cloud-Modells der Spitzenklasse.

#Sicherheitscheckliste vor dem Verbinden von Modell und Tools

Drei Bereiche verdienen eine ausdrückliche Prüfung, bevor Sie Agent Zero ohne ständige Überwachung arbeiten lassen: die Container-Isolation, die Secrets und API-Schlüssel sowie die verbundenen MCP-Server.

#Im Vergleich zu anderen lokalen Agenten

• OpenCode mit Ollama im Terminal

#Grenzen, die Sie vor dem Einstieg kennen sollten

Irreführendes Suchvolumen

„Agent Zero“ steht in Suchmaschinen auch für Unterhaltungsinhalte; die tatsächliche Nachfrage nach dem Entwicklungsframework ist geringer, als das unbereinigte Suchvolumen des Keywords vermuten lässt.

Speicherbedarf auf dem Datenträger und im RAM

Der Container enthält neben der Laufzeitumgebung des Agenten auch eine vollständige Desktop-Umgebung: mehr Ressourcen als für einen minimalen CLI-Agenten einplanen, selbst wenn die Inferenz selbst anderswo über Ollama läuft.

Zu klein dimensioniertes Hilfsmodell

Ein zu kleines Hilfsmodell beeinträchtigt das Gedächtnis, ohne eine ausdrückliche Fehlermeldung auszugeben; prüfen Sie das zuerst, wenn der Agent von einer Sitzung zur nächsten den „Faden zu verlieren“ scheint.

Containerinternes Netzwerk

host.docker.internal funktioniert mit Docker Desktop und der bereitgestellten Linux-Konfiguration. Bei einer angepassten Bereitstellung (benutzerdefiniertes Docker-Netzwerk, Hosting auf einem entfernten Rechner) muss die API-URL jedoch manuell neu eingegeben werden.

• Ein LLM mit Docker Compose in einer Produktionsumgebung bereitstellen
• Ollama mit Docker installieren
• KI-Agent: allgemeine Definitionen und Grenzen
• Quelle: offizielles GitHub-Repository von Agent Zero
• Quelle: offizieller Installationsleitfaden
• Quelle: offizieller Leitfaden zum lokalen Toolaufruf