Modell / Datensatz
the-open-agent/openagent avatar
the-open-agent/openagent

OpenAgent: selbst gehosteter Assistent mit Agent-Loops in einer Go-Binary

⚡️next-generation personal AI assistant powered by LLM, RAG and agent loops, supporting computer-use, browser-use and coding agent, demo: https://demo.openagentai.org

5.621 Sterne655 ForksGoApache-2.0

Auf einen Blick

Was ist das?
OpenAgent bündelt LLM-Anbindung, RAG-Wissensbasis und autonome Agent-Loops in einem einzelnen Go-Programm. Der Installer startet den Dienst auf Port 14000. Wer Shell-Ausführung und Browser-Steuerung freigibt, sollte wissen, wo die Grenzen liegen.
Für wen ist es gedacht?
Sinnvoll ist OpenAgent für Teams, die einen Assistenten mit Werkzeugzugriff auf eigener Hardware betreiben und die Ausführungsumgebung selbst kontrollieren können. Wer eine reine Chat-Oberfläche ohne Shell- und Browserrechte sucht, greift zu etwas anderem.
Darf ich es kommerziell nutzen?
Ja. Apache-2.0 ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
Wird es noch gepflegt?
Ja. Die letzten Commits kamen vor 6 Tagen.
In welcher Sprache ist es geschrieben?
Hauptsächlich Go, laut der Sprachstatistik von GitHub.

Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.

TIEFGEHENDE OPEN-SOURCE-ANALYSE

Welches Problem OpenAgent adressiert

Ein Assistent, der Dokumente durchsucht und dabei Werkzeuge aufruft, besteht aus mehreren Teilen: Modellanbindung, Vektorindex, Ausführungsschleife, Protokollierung. OpenAgent liefert diese Teile als ein Paket, das laut README als einzelne Binary ohne Installation auskommt. Der Installer lädt das jeweils neueste Release und startet den Dienst auf Port 14000. Wer den Quellcode baut, braucht Go 1.25.0 oder neuer, für das Frontend Node.js 20 und Yarn 1.x.

Die Zielgruppe lässt sich aus dem Funktionsumfang ablesen. Wer Modellzugänge, Wissensbasis und Werkzeugausführung getrennt betreibt und die Ergebnisse zusammenführen muss, spart mit OpenAgent die Klebearbeit. Wer lediglich Fragen an ein Modell stellt, bekommt hier deutlich mehr Oberfläche als nötig, inklusive Rechten für Shell-Befehle und Browser-Steuerung.

Agent-Loop, Werkzeuge und der Weg durch die Anfrage

Das README beschreibt den Ablauf als Agent-Loop: Das Modell entscheidet, welches Werkzeug es aufruft, das Ergebnis fließt zurück in den Kontext, und der nächste Schritt folgt. Die dokumentierten Werkzeuge umfassen Browser-Use (navigieren, klicken, Formulare ausfüllen, Seiten erfassen und Screenshots erstellen), Websuche und Abruf von Seiteninhalten, Shell-Ausführung, Lese- und Schreibzugriff auf Word-, Excel- und PowerPoint-Dateien sowie die Anbindung beliebiger MCP-Server über SSE, Stdio oder StreamableHTTP.

Bemerkenswert ist, was das README über die Sichtbarkeit sagt: Jeder Werkzeugaufruf erscheint mit Argumenten und Rückgabewert Schritt für Schritt. Das ist keine Nebensache. Bei Shell-Ausführung ist die Protokollierung die einzige Möglichkeit nachzuvollziehen, was ein Agent tatsächlich getan hat. Die Screenshots im README zeigen passend dazu Nutzungsstatistiken, Aktivitätsmonitoring, Werkzeugverwaltung und detaillierte Logs.

Für die Wissensbasis nennt das README das übliche Verfahren: Dokumente werden hochgeladen, in Abschnitte zerlegt, eingebettet und indexiert, danach läuft die Suche semantisch. Der Text ist an dieser Stelle abgeschnitten, Details zur Chunk-Größe oder zum Embedding-Modell gehen daraus nicht hervor.

Installation und die ersten Konfigurationsschritte

Der schnellste Weg ist das Skript des Projekts. Unter macOS, Linux und WSL lautet der Aufruf:

curl -fsSL https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.sh | bash

Unter Windows läuft derselbe Vorgang nativ in PowerShell, ohne WSL und ohne Docker:

irm https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.ps1 | iex

Danach ist die Oberfläche unter http://localhost:14000 erreichbar. Das README nennt drei optionale Umgebungsvariablen: OPENAGENT_VERSION für eine feste Version, INSTALL_DIR für das Zielverzeichnis und BIN_DIR für den Ablageort der Binary. Wer reproduzierbare Installationen braucht, sollte OPENAGENT_VERSION setzen, statt dem Skript zu erlauben, immer das neueste Release zu ziehen.

Für den Quellcode-Build sind es zwei Schritte: go build im Wurzelverzeichnis, danach cd web && yarn install && yarn start. Alternativ steht ein docker-compose up bereit, das ebenfalls Port 14000 belegt. Aus dem Material geht nicht hervor, welche Dienste der Compose-Stack umfasst und wo die Daten dann liegen.

Werkzeugausführung als Angriffsfläche

Ein Assistent mit Shell-Zugriff ist ein anderes Risiko als ein Chatfenster. Das README beschreibt die Fähigkeit, Befehle und Skripte direkt aus der Schleife heraus auszuführen, ohne ein Berechtigungsmodell zu nennen. Ebenso fehlen Angaben dazu, ob MCP-Server isoliert laufen, ob Dateizugriffe auf ein Verzeichnis begrenzt werden können oder ob es eine Freigabe pro Aufruf gibt.

Das ist der Punkt, an dem Interessenten selbst prüfen müssen. Wer den Dienst auf einem Rechner mit Zugriff auf Produktionsdaten betreibt, gibt dem Modell über die Shell dieselben Rechte, die der ausführende Benutzer hat. Die detaillierten Logs helfen bei der Nachvollziehbarkeit, sie verhindern aber nichts. Eine Umgebung mit eingeschränkten Rechten, etwa ein eigener Benutzer ohne Zugriff auf produktive Verzeichnisse, ist die naheliegende Gegenmaßnahme. Ob OpenAgent dafür eigene Mechanismen mitbringt, lässt sich aus dem vorliegenden Material nicht belegen.

Dokumentenverarbeitung und ihre Kosten

Die RAG-Seite verarbeitet PDFs, Word-Dateien, Excel-Tabellen und weitere Formate. Jedes Dokument wird zerlegt, eingebettet und indexiert. Das ist ein Batch-Vorgang, der beim ersten Hochladen Rechenzeit und, je nach Anbieter, Geld kostet. Das README beziffert weder die Größe der Abschnitte noch die Anzahl der Dimensionen, auch nicht, welches Embedding-Modell standardmäßig verwendet wird.

Praktisch relevant ist die Frage, was bei einem Modellwechsel passiert. Ein Vektorindex ist an das Modell gebunden, das ihn erzeugt hat. Wechselt man das Embedding-Modell, muss die Wissensbasis neu aufgebaut werden. Wer viele Dokumente eingespielt hat, plant diesen Schritt besser vorher ein. Zur Speicherung der Daten äußert sich das README nicht, sodass unklar bleibt, welche Dateien ein Backup umfassen muss und ob ein Wechsel der Version einen Migrationsschritt erfordert.

Vergleich mit einem Baukasten wie LangChain

Die Topics des Repositories nennen LangChain ausdrücklich. Der Unterschied liegt im Zuschnitt: LangChain ist eine Bibliothek, mit der man den Ablauf selbst schreibt, OpenAgent ist ein fertiger Dienst mit Oberfläche, Installer und vorkonfigurierten Werkzeugen. Wer eine eigene Anwendung baut und die Kontrolle über jeden Schritt braucht, ist mit einer Bibliothek besser bedient, weil er den Ablauf ohne Rahmenwerk anpassen kann.

Umgekehrt gilt: Wer eine Weboberfläche, Nutzungsstatistiken und eine Wissensbasis ohne eigenen Code will, bekommt das hier geliefert. Der Preis ist Bindung an die Entscheidungen des Projekts, etwa an die Art der Speicherung und an die Struktur der Agent-Schleife. Ein weiterer Unterschied liegt in der Sprache. Go erzeugt eine einzelne Binary, die sich ohne Laufzeitumgebung verteilen lässt, was den Betrieb auf fremden Rechnern vereinfacht. Python-Projekte brauchen dafür eine passende Umgebung auf dem Zielsystem.

Wartung, Release-Tempo und Lizenz

Die letzten drei Releases liegen eng beieinander: v2.90.0 und v2.90.1 am 5. September 2026, v2.91.0 am 7. September 2026. Solche Sprünge in kurzer Folge deuten auf häufige Korrekturen hin. Wer OPENAGENT_VERSION fest auf eine Version setzt, kontrolliert den Zeitpunkt des Upgrades selbst, muss dann aber die Änderungen zwischen den Versionen lesen. Automatisches Nachziehen über das Installationsskript bringt dagegen ungeprüfte Änderungen auf den Rechner.

Der Lizenzhinweis im Badge verweist auf eine Datei LICENSE im Repository, der Beschreibungstext nennt Apache-2.0. Diese Angabe stammt aus der Repository-Beschreibung und nicht aus einer Prüfung der Lizenzdatei selbst. Apache-2.0 enthält eine ausdrückliche Patentgewährung und verlangt, dass Änderungen an den Dateien kenntlich gemacht werden. Wer OpenAgent als Bestandteil eines eigenen Produkts ausliefert, muss den Hinweis auf die Lizenz und die Datei NOTICE mitführen, sofern eine solche im Repository liegt. Das ist keine Rechtsberatung, sondern nur der Hinweis, dass die Lizenzdatei vor der Weitergabe zu lesen ist.

Für wen sich der Einsatz lohnt

OpenAgent passt zu Nutzern, die einen Assistenten mit Werkzeugzugriff selbst betreiben und die Ausführungsumgebung kontrollieren können. Dazu gehören Entwicklungsteams, die wiederkehrende Aufgaben wie das Lesen von Tabellen, das Durchsuchen von Dokumenten und das Ausführen von Skripten an einer Stelle bündeln wollen, ohne dafür eine eigene Anwendung zu schreiben. Die Anbindung an über 30 Modellanbieter erlaubt es, pro Unterhaltung zu wechseln, was den Vergleich von Modellen ohne Codeänderung möglich macht.

Weniger geeignet ist OpenAgent für Umgebungen, in denen der Assistent keinen Shell-Zugriff erhalten darf oder in denen jede Werkzeugnutzung vorab freigegeben werden muss. Dafür nennt das vorliegende Material kein Berechtigungskonzept. Ebenso ungeeignet ist es, wenn die Datenhaltung genau dokumentiert sein muss, weil das README zu Speicherort und Migration schweigt.

Vor dem ersten produktiven Einsatz sind drei Dinge zu prüfen: ob die Datei LICENSE tatsächlich Apache-2.0 enthält, welche Verzeichnisse der Dienst beschreibt und liest, und ob der ausführende Benutzer Zugriff auf Daten hat, die er nicht braucht. Der letzte Punkt lässt sich mit einem eigenen Benutzerkonto und eingeschränkten Dateirechten klären, bevor der Assistent den ersten Shell-Befehl ausführt.

Redaktionelles Fazit

Sinnvoll ist OpenAgent für Teams, die einen Assistenten mit Werkzeugzugriff auf eigener Hardware betreiben und die Ausführungsumgebung selbst kontrollieren können. Wer eine reine Chat-Oberfläche ohne Shell- und Browserrechte sucht, greift zu etwas anderem. Vor dem Produktiveinsatz zu klären: ob die Lizenzdatei Apache-2.0 tatsächlich trägt, ob die Datenbankpfade ein Backup überleben und wer die Tool-Aufrufe im Log prüft.

Offizielle Quellen

  1. License: Apache-2.0
  2. Project website
  3. README
  4. Releases
  5. the-open-agent/openagent on GitHub
Community-Notizen

Community-Notizen