Bleib up-to-date mit unserem Newsletter!
Die Befehle: n8n installieren & Agents-Modul aktivieren
Bevor du KI-Agenten in n8n baust, brauchst du eine lokale n8n-Installation mit aktiviertem Agents-Modul. Die folgenden Befehle installieren n8n mit einem einzigen Befehl und schalten danach das Agents-Modul frei. Terminal unter macOS/Linux (bzw. WSL unter Windows) – Details und Windows-Hinweise findest du im Beitrag weiter unten.
# 1. n8n mit einem Befehl installieren (macOS/Linux/WSL) curl -fsSL https://get.n8n.io | sh # 2. n8n läuft schon? Compose-Pfad herausfinden docker compose ls # 3. In den n8n-Ordner wechseln (Pfad ggf. anpassen) cd /Users/deinname/n8n # 4. .env-Datei öffnen (macOS) open -e .env # Windows: notepad .env # 5. Ganz unten in die .env-Datei einfügen und speichern N8N_ENABLED_MODULES=agents # 6. Container mit der neuen Einstellung neu starten docker compose up -d
Wichtig: Nutzt du bereits den KI-Assistenten (instance-ai), überschreibt die Zeile aus Schritt 5 sonst dessen Modul. Trage in dem Fall stattdessen N8N_ENABLED_MODULES=instance-ai,agents ein. Nach dem Neustart lädst du die geöffnete n8n-Seite im Browser einmal neu, damit der neue Reiter „Agenten“ erscheint.
n8n KI-Agenten lokal einrichten: Workflows per Prompt bauen
n8n vereint jetzt zwei neue KI-Bausteine: einen KI-Assistenten, der dir komplette Workflows per Prompt baut, und ein eigenes Agents-Modul, mit dem du autonome KI-Agenten direkt in n8n erstellst – komplett lokal auf deinem Rechner, ganz ohne teuren Cloud-Plan. Anders als ein klassischer n8n-Workflow bekommt ein Agent kein festes Schema vorgegeben, sondern ein Ziel – und entscheidet selbst, welche Schritte nötig sind, um es zu erreichen.
In diesem Tutorial installierst du n8n mit einem einzigen Befehl lokal, verbindest den KI-Assistenten mit einem Modell, schaltest das Agents-Modul frei und baust deinen ersten eigenen KI-Agenten. Am Ende kombinierst du diesen Agenten mit einem klassischen n8n-Workflow – und siehst, wie beide Welten nahtlos zusammenspielen.
Von Harald Frey, KI-Trainer & Berater · Zuletzt aktualisiert: 27. August 2026
n8n-Neuheiten: KI-Assistent und KI-Agenten
Viele behaupten, n8n sei durch KI-Agenten überflüssig geworden. Das Gegenteil ist der Fall: n8n hat zwei neue KI-Bausteine bekommen, die sich gegenseitig ergänzen, statt sich zu ersetzen.
Beide Bausteine laufen komplett lokal auf deinem Rechner – du brauchst keinen bezahlten n8n-Cloud-Plan, nur Docker und ein angebundenes KI-Modell.
Voraussetzungen: Docker Desktop
Die einzige echte Voraussetzung ist Docker Desktop. n8n läuft in einem isolierten Docker-Container, ohne dass du selbst zusätzliche Software konfigurieren musst.
Docker Desktop
Installiert und geöffnet, inklusive des Docker-Compose-v2-Plugins, das der Installationsbefehl benötigt.
Bereits eine ältere n8n-Version?
Entweder parallel neu installieren oder vorher gemäß der offiziellen n8n-Dokumentation ein Backup anlegen.
n8n mit einem Befehl lokal installieren
Ist Docker Desktop geöffnet, installierst du n8n mit einem einzigen Terminal-Befehl. Er prüft Docker, legt einen Ordner samt Compose-Datei und .env an und startet n8n direkt mit dem Sandbox-Unterbau für den KI-Assistenten:
Windows-Hinweis: Der Befehl läuft nicht direkt in der Windows-PowerShell oder der Eingabeaufforderung, weil beide keine Shell-Skripte ausführen. Nutze stattdessen WSL (Windows Subsystem for Linux) mit aktivierter Docker-Desktop-Integration – laut n8n-Dokumentation die empfohlene Variante für Windows.
Nach ein paar Minuten läuft n8n unter http://localhost:5678. Öffnest du die Adresse im Browser, registrierst du dich bei der ersten Anmeldung lokal als Admin.
Lizenzschlüssel aktivieren
Direkt nach der Erstanmeldung bietet dir n8n einen kostenlosen Lizenzschlüssel an. Fordere ihn an und trage ihn ein – erst danach sind wirklich alle Funktionen freigeschaltet, inklusive KI-Assistent und Agents-Modul.
KI-Assistenten mit einem Modell verbinden
Damit der KI-Assistent arbeitet, brauchst du ein angebundenes KI-Modell. Hast du bereits ein Abo bei einem Anbieter, kannst du es einbinden – achte dabei immer auf dessen Lizenzbedingungen. Eine bequeme Alternative ist OpenRouter: eine Plattform, über die du mit einem einzigen Schlüssel auf so gut wie alle KI-Modelle zugreifst, in der Regel kostenpflichtig und pro Token abgerechnet.
Gut zu wissen: OpenRouter ist kein Open-Source-Projekt, sondern wurde erst kürzlich für über 7,5 Milliarden US-Dollar an Stripe verkauft – ein Beleg dafür, wie wichtig der Zugang zu KI-Modellen inzwischen geworden ist. n8n selbst bleibt aber offen: Du kannst jeden beliebigen Anbieter anbinden.
Bei der Modellwahl schlägt n8n meist das leistungsstärkste – und teuerste – Modell vor, etwa Opus 5. In meinem Beispiel wähle ich stattdessen GLM 5.2: aus meiner Erfahrung ebenfalls zuverlässig, aber günstiger. Es gibt inzwischen zwar schon die neuere Version GLM 5.3, die aber wieder teurer ist – aus Kostengründen bleibe ich bei 5.2. Probier für deinen Anwendungsfall am besten selbst aus, was für dich das beste Verhältnis aus Qualität und Kosten bietet.
Agents-Modul freischalten
Das Agents-Modul steckt bereits in n8n, muss aber separat aktiviert werden – am einfachsten über das Terminal. Die komplette Befehlsfolge findest du oben direkt unter dem Newsletter-Feld zum Kopieren: Compose-Pfad finden, in den n8n-Ordner wechseln, die Zeile N8N_ENABLED_MODULES=agents in die .env-Datei eintragen und den Container neu starten.
Laut offizieller n8n-Dokumentation: Für reine Agenten reicht der Eintrag agents. Willst du zusätzlich den KI-Assistenten behalten, der dir Workflows per Prompt baut, trägst du stattdessen N8N_ENABLED_MODULES=instance-ai,agents ein – sonst deaktiviert die Zeile den KI-Assistenten wieder.
Nach dem Neustart des Containers lädst du die geöffnete n8n-Seite im Browser einmal neu. In den Einstellungen wählst du für die KI-Agenten – genau wie zuvor beim KI-Assistenten – einen Anbieter und ein Modell aus. Rufst du danach die Übersichtsseite auf, findest du oben den neuen Reiter „Agenten“.
KI-Assistent vs. KI-Agent: der Unterschied
Bevor du den ersten Agenten baust, lohnt sich die Unterscheidung – beide Bausteine lassen sich kombinieren, sind aber grundverschieden.
KI-Assistent
KI-Agent
Das Besondere: Du kannst autonome KI-Agenten nahtlos mit deinen gewohnten, klassischen n8n-Automatisierungen und Berechtigungen kombinieren – wie das konkret aussieht, zeige ich dir in den nächsten beiden Abschnitten.
Deinen ersten KI-Agenten bauen
Zum Erstellen klickst du im Reiter „Agenten“ auf den entsprechenden Button. Der Chat links im neuen Bildschirm ist dabei nicht der Chat deines künftigen Agenten, sondern wieder der KI-Assistent, der dir beim Einrichten hilft.
Beschreibst du links im KI-Assistenten-Chat, was dein Agent tun soll, sucht der Assistent selbstständig nach den nötigen Tools, fordert dich bei Bedarf zur Einrichtung auf und ergänzt rechts die Instruktionen – jederzeit von Hand anpassbar. Über das Pfeil-Symbol oben rechts öffnest du den Chat mit deinem fertig eingerichteten Agenten und testest ihn direkt, über das Plus-Symbol leerst du diesen Chat.
Beispiel aus dem Video: Ich fordere meinen Agenten auf, eine Recherche zu starten. Er fragt zunächst zum Thema nach, sucht sich die Informationen selbstständig im Internet und legt automatisch ein Google Doc mit dem fertigen Blogbeitrag an.
Funktioniert der Agent wie gewünscht, veröffentlichst du ihn oben rechts. Danach findest du ihn dauerhaft im Reiter „Agenten“ wieder und kannst ihn jederzeit aufrufen und mit Aufgaben betrauen.
KI-Agent in einen klassischen Workflow einbinden
Ist der Agent fertig, lässt er sich auch in klassische n8n-Workflows einbinden. Dafür startest du einen neuen Workflow und lässt dir über den KI-Assistenten rechts im Editor direkt einen passenden Ablauf bauen.
Startest du den Workflow, öffnet sich das Formular – ohne eigene Vorgaben heißt es automatisch etwa „Blogbeitrag-Generator“. Trägst du dort deinen Suchbegriff ein, geht die Eingabe an den Agenten, der selbstständig recherchiert und daraus ein Google-Dokument erstellt.
Mein Fazit: Mit den neuen n8n-Funktionen ist das erstaunlich einfach eingerichtet und bietet richtig starke Möglichkeiten – ganz ohne Cloud-Plan, komplett lokal auf deinem Rechner.
Du willst n8n-Automatisierungen und KI-Agenten in deinem Unternehmen einsetzen?
Ich zeige dir und deinem Team, wie ihr mit n8n, KI-Agenten und Automatisierungen produktiver arbeitet – praxisnah und auf euren Workflow zugeschnitten.
Häufige Fragen
Brauche ich einen bezahlten n8n-Cloud-Plan für KI-Agenten?
Nein. n8n lässt sich mit einem einzigen Befehl lokal installieren; Agents-Modul und KI-Assistent laufen auch selbst gehostet – ein kostenloser Lizenzschlüssel schaltet alle Funktionen frei.
Was ist der Unterschied zwischen dem KI-Assistenten und einem KI-Agenten in n8n?
Der KI-Assistent ist ein Co-Pilot, der dir klassische n8n-Workflows baut und Fehler behebt. Ein KI-Agent ist ein eigener Baustein, der ein Ziel statt eines festen Ablaufs bekommt und selbst entscheidet, welche Schritte dafür nötig sind.
Wie aktiviere ich das Agents-Modul in n8n?
Über die Umgebungsvariable N8N_ENABLED_MODULES in der .env-Datei deiner n8n-Installation – trage agents (oder instance-ai,agents, wenn du den KI-Assistenten behalten willst) ein und starte den Container mit docker compose up -d neu.
Läuft der n8n-Installationsbefehl auch unter Windows?
Der Ein-Zeilen-Befehl braucht eine Shell, die Skripte versteht – unter Windows funktioniert das über WSL mit aktivierter Docker-Desktop-Integration, nicht direkt in PowerShell oder der Eingabeaufforderung.
Kann ich einen KI-Agenten mit einem klassischen n8n-Workflow kombinieren?
Ja. Ein veröffentlichter Agent lässt sich zum Beispiel über ein Formular-Element aus einem klassischen Workflow heraus ansprechen – der Workflow übergibt die Eingabe, der Agent entscheidet eigenständig über die weiteren Schritte.
Welches KI-Modell brauche ich für den KI-Assistenten und die Agenten?
Du kannst jeden Anbieter anbinden, den du willst, etwa über ein bestehendes Abo oder eine Plattform wie OpenRouter. Achte dabei immer auf die jeweiligen Lizenzbedingungen des Anbieters.