Paperclip einrichten auf einem VPS: Eine Schritt-für-Schritt-Anleitung

Paperclip ist eine Open-Source-Orchestrierungsplattform, mit der Sie mehrere KI-Agenten für ein gemeinsames Ziel erstellen, verwalten und koordinieren können. Wenn Sie Paperclip auf einem VPS einrichten, erhalten Sie eine persistente, selbst gehostete Umgebung für den Betrieb eines Unternehmens aus autonomen Agenten.

Wenn Sie Paperclip auf Ihrem eigenen Server hosten, behalten Sie außerdem die volle Kontrolle über Ihre Daten, Agentenkonfigurationen und Infrastrukturkosten.

Wenn Sie auf einem VPS Paperclip einrichten möchten, müssen Sie einen Server mit ausreichend Ressourcen bereitstellen, damit Ihre Agenten rund um die Uhr laufen, die Anwendung mit Docker bereitstellen und die Organisation Ihrer KI-Agenten über das Dashboard konfigurieren.

Hier finden Sie die Schritt-für-Schritt-Anleitung zum Einrichten von Paperclip auf einem VPS:

• Einen VPS-Plan auswählen. Wählen Sie einen Plan mit ausreichend Ressourcen, damit Ihre Agenten kontinuierlich laufen können. Eine Konfiguration mit 2 vCPU-Kernen, 4 GB RAM und 50 GB SSD-Speicher ist für eine Basiskonfiguration ausreichend.
• Paperclip mit Docker bereitstellen. Docker bündelt Paperclip und alle Abhängigkeiten in einem einzigen Container, sodass Sie einen Großteil der manuellen Arbeit überspringen können.
• Beim Paperclip-Dashboard anmelden. Greifen Sie über Ihren Browser auf Ihre aktive Paperclip-Umgebung zu und melden Sie sich mit den Zugangsdaten an, die Sie während der Bereitstellung festgelegt haben.
• Ein Ziel festlegen und Workflows definieren. Geben Sie Ihrem KI-Unternehmen einen Namen und definieren Sie ein konkretes, messbares Ziel, auf das die Arbeit jedes Agenten ausgerichtet ist.
• Agenten mit klar definierten Rollen hinzufügen. Erstellen Sie Ihr Organigramm, indem Sie Agenten Rollen wie CEO, CTO oder Marketer zuweisen, jeweils mit eigenen Verantwortlichkeiten und eigener Adapterkonfiguration.
• LLM-Token-Budgets festlegen. Wenden Sie Ausgabenlimits auf Agenten- oder Projektebene an, damit Ihre API-Kosten planbar bleiben, sobald Ihre Agenten mit der Ausführung von Aufgaben beginnen.
• Ihre Agenten überwachen. Verfolgen Sie den Aufgabenfortschritt, prüfen Sie Heartbeat-Logs und erkennen Sie Fehlkonfigurationen oder Ineffizienzen frühzeitig, bevor sie Überhand nehmen.
• Optimieren und skalieren. Verfeinern Sie Rollendefinitionen, passen Sie Berichtslinien an und erweitern Sie die Ressourcen Ihres VPS, wenn Ihre Agentenorganisation wächst.

Sie würden lieber eine Demonstration per Video ansehen? In diesem Video-Tutorial wird erklärt, wie man Paperclip auf Hostinger VPS einrichtet:

Subscribe For more educational videos! Hostinger Academy

Subscribe

1. Wählen Sie einen VPS für den Betrieb von Paperclip

Ein virtueller privater Server (VPS) ist die ideale Wahl für Paperclip, da Ihre Agenten so kontinuierlich laufen können. Ihre Agenten arbeiten auch dann weiter an Aufgaben, führen geplante Zyklen aus und aktualisieren ihre Logs, wenn Sie offline sind.

Eine VPS-Umgebung ist auch für KI-Workloads vorteilhaft, da diese ressourcenintensiver sind als eine typische Web-App. Agenten verarbeiten gleichzeitig Antworten großer Sprachmodelle (LLMs), schreiben in eine Datenbank und führen Hintergrundjobs aus.

Dennoch bleiben die Anforderungen für kleinere Setups überschaubar. Für eine Basiskonfiguration mit einem kleinen Agententeam reicht ein VPS mit 2 vCPU-Kernen, 4 GB RAM und 50 GB SSD-Speicher aus, um loszulegen – insbesondere unter Ubuntu 22.04 oder Debian 12.

Über die reinen Spezifikationen hinaus lohnt es sich, bei einem Vergleich der besten Hosting-Anbieter für Paperclip die einfache Einrichtung zu priorisieren. Wählen Sie eine Plattform, die vorkonfigurierte Anwendungsvorlagen und vollständigen Root-SSH-Zugriff bietet.

Diese Funktionen verkürzen die Einrichtungszeit erheblich, vereinfachen die laufende Verwaltung und geben Ihnen dennoch die Flexibilität, bei Bedarf erweiterte Anpassungen auf Serverebene umzusetzen.

Die meisten VPS-Pläne für den Betrieb von Paperclip kosten zwischen 4 € und 30 € pro Monat. Und da Paperclip eine Open-Source-Plattform ist, bestehen Ihre einzigen laufenden Kosten aus dem Server und den API-Token der KI-Agenten, die Sie verwenden.

2. Stellen Sie Paperclip mit Docker bereit

Docker ist ein Tool, das eine Anwendung und alle ihre Abhängigkeiten in einer Gruppe von Containern verpackt. Diese Container sind eigenständige Einheiten, die auf jedem Server auf die gleiche Weise laufen.

Bei Paperclip bedeutet das, dass Sie Node.js nicht manuell installieren, keine Datenbank konfigurieren und keine Umgebungsvariablen einzeln festlegen müssen.

Je nachdem, ob Sie bereits zuvor einen VPS eingerichtet haben, gibt es drei verschiedene Möglichkeiten, Paperclip mit Docker bereitzustellen.

Wenn Sie einen neuen VPS einrichten, ist die vorkonfigurierte Paperclip-Vorlage von Hostinger die schnellste Option. Kaufen Sie einen Plan über die Paperclip-Hosting-Seite, folgen Sie den Onboarding-Schritten, und Sie gelangen direkt zum Paperclip-Konfigurationsbildschirm.

Geben Sie Ihren Admin-Namen, Ihre E-Mail-Adresse und Ihr Passwort ein und fügen Sie optional einen API-Schlüssel für Ihren bevorzugten KI-Modellanbieter hinzu.

Wenn Sie keinen API-Schlüssel hinzufügen, wird Paperclip trotzdem erfolgreich bereitgestellt, aber Ihre Agenten können keine Aufgaben ausführen, bis Sie später über das Dashboard einen Schlüssel hinzufügen.

Nachdem Sie auf Bereitstellen geklickt haben, läuft Paperclip schon nach wenigen Augenblicken auf Ihrem Server.

Sie haben bereits einen VPS bei Hostinger? Melden Sie sich unter hPanel an und navigieren Sie zu VPS → Betriebssystem und Panel → Betriebssystem. Stellen Sie sicher, dass Docker installiert ist, und suchen Sie dann im Docker-Anwendungsmenü nach Paperclip, um es bereitzustellen.

Wenn Sie einen anderen VPS-Anbieter verwenden, müssen Sie zuerst eine Docker-Instanz einrichten und dann Paperclip mit Docker Compose installieren, indem Sie diesen Befehl ausführen:

docker compose -f docker-compose.quickstart.yml up –build

3. Melden Sie sich beim Paperclip-Dashboard an

Wenn Sie Hostingers 1-Klick-Installer verwendet haben, werden Sie direkt zur Seite Docker Manager in Ihrem VPS-Dashboard weitergeleitet. Suchen Sie Ihr Projekt und klicken Sie auf Open, um das Paperclip-Dashboard in Ihrem Browser zu öffnen.

Alternativ können Sie darauf zugreifen, indem Sie die IP-Adresse Ihres Servers direkt in einen Browser eingeben und den Paperclip-Port hinzufügen:

http://203.0.113.1:3100

Ersetzen Sie 203.0.113.1 durch die tatsächliche IP-Adresse Ihres Servers; Port 3100 ist der Standardport von Paperclip.

Diese Methode funktioniert, solange Port 3100 auf Ihrem Server geöffnet ist und Paperclip so konfiguriert ist, dass externe Verbindungen akzeptiert werden – beides wird von Hostingers 1-Klick-Installer automatisch eingerichtet.

Anschließend werden Sie aufgefordert, sich bei Paperclip anzumelden. Wenn Sie Hostingers 1-Klick-Installer verwendet haben, dann geben Sie die E-Mail-Adresse und das Passwort ein, die Sie während des Konfigurationsschritts von Paperclip festgelegt haben.

Sollten Sie die Einrichtung auf einem anderen VPS vornehmen, müssen Sie möglicherweise ein Admin-Konto erstellen, bevor Sie sich anmelden können.

4. Legen Sie ein Ziel fest und definieren Sie Workflows für Ihr KI-Unternehmen

Direkt nach der Anmeldung bei Paperclip werden Sie aufgefordert, Ihr erstes KI-Unternehmen einzurichten. Beginnen Sie damit, einen Namen und ein Ziel festzulegen.

Wir empfehlen, ein klares Ziel zu definieren – auch wenn es technisch optional ist – denn letztlich bestimmt dieses Ziel die Arbeit jedes Agenten.

Achten Sie zur Erzielung nützlicher Ergebnisse darauf, Ihr Ziel konkret zu formulieren. Statt „Erstelle eine Notiz-App“ sollten Sie lieber etwas wie „Erstelle die beste KI Notiz-App, mit der sich innerhalb von drei Monaten ein monatlicher Umsatz von 1 Mio. € generieren lässt.“ schreiben – mit einem klaren Ziel arbeiten Agenten am besten.

Klicken Sie auf Weiter. Anschließend werden Sie aufgefordert, die Rolle Ihres ersten Agenten einzurichten. Standardmäßig weist Paperclip die CEO-Rolle zu, also die höchste Position in Ihrem Organigramm. Wählen Sie anschließend einen Adaptertyp und das KI-Modell aus, mit dem die Aufgaben ausgeführt werden sollen.

Klicken Sie auf Weiter, um mit der Zuweisung von Aufgaben für die CEO-Rolle fortzufahren. Dort finden Sie ein Feld für die Aufgabenbeschreibung, in das Sie eine System-Eingabeaufforderung schreiben können, die erklärt, was der Agent tun und welche Prioritäten er setzen soll.

Paperclip strukturiert Agenten mithilfe eines Organigramms, so wie ein Unternehmen sein Team organisiert. Jeder Agent hat eine definierte Rolle, berichtet an einen anderen Agenten oder an Sie und übernimmt einen bestimmten Aufgabentyp.

Der CEO dient als Koordinator auf oberster Ebene, nimmt Ziele entgegen, zerlegt sie in übergeordnete Aufgaben und delegiert die Arbeit entlang des Organigramms nach unten.

Sie können den CEO anweisen, Agenten für bestimmte Rollen einzustellen, etwa einen CTO-Agenten für technische Aufgaben, einen Marketing-Agenten für Inhalte und Outreach, einen Research-Agenten für die Informationsbeschaffung und so weiter. Geben Sie diese Anforderungen in Ihrer anfänglichen System-Eingabeaufforderung für den CEO-Agenten an.

Sobald das erledigt ist, klicken Sie auf Weiter, um die Zusammenfassung Ihrer Organisation zu prüfen. Wenn alles korrekt aussieht, klicken Sie auf Erstellen & Öffnen, um die Einrichtung abzuschließen.

Dadurch wird Ihre Organisation erstellt und die erste Aufgabe des CEO-Agenten geöffnet, die den Ausgangspunkt für alle folgenden Arbeiten bildet.

5. Fügen Sie weitere KI-Agenten mit den Rollen hinzu, die Sie benötigen

Nachdem Sie Ihr erstes Issue gestartet haben, werden Sie zum Paperclip-Dashboard weitergeleitet. Dort können Sie beobachten, wie der KI CEO-Agent seinen ersten Heartbeat ausführt. Der Agent arbeitet entsprechend dem Unternehmensziel, das Sie festgelegt haben, und der Aufgabe, die Sie zuvor zugewiesen haben.

Es gibt zwei Möglichkeiten, Ihrer Organisation Agenten hinzuzufügen. Wenn Sie in die System-Eingabeaufforderung Ihres CEO eine Organisationsstruktur aufgenommen haben, erzeugt Paperclip automatisch Anfragen zur Anheuerung weiterer Agenten – diese erscheinen im Posteingang Ihres Paperclip-Dashboards, wo Sie die Anfragen genehmigen können, die zu Ihrer Konfiguration passen.

Alternativ können Sie Agenten manuell hinzufügen, indem Sie im Menü „Agents“ auf den Plus-Button (+) klicken. So können Sie jeden Agenten von Grund auf mit benutzerdefinierten Parametern wie Adaptertyp, Eingabeaufforderungs-Vorlage, Modell und Fähigkeiten konfigurieren.

Der manuelle Weg ist besonders nützlich, wenn verschiedene Rollen auf unterschiedlichen Adaptern laufen sollen – zum Beispiel ein Backend Engineer auf Claude Code und ein Frontend Engineer auf Gemini CLI.

Erstellen Sie zu Beginn höchstens drei bis fünf Agenten – einen Koordinator und zwei bis vier Spezialisten –, damit Sie Fehler leichter beheben und zunächst Vertrauen aufbauen können, bevor Sie die Komplexität erhöhen.

6. Legen Sie Ihre Token-Budgets für LLMs fest

Jedes Mal, wenn ein Agent eine Aufgabe ausführt, verbraucht er Token – die Maßeinheit für die API-Nutzung von LLMs. Diese Token verursachen Kosten. In einer ausgelasteten Multi-Agenten-Konfiguration können sich Ausgaben schnell summieren, besonders wenn die KI-Agenten in Schleifen geraten oder unnötig Arbeit wiederholen.

Paperclip schafft mit einem integrierten Budgetsystem Abhilfe – hier können Sie LLM-Ausgabenlimits auf Agenten- oder Projektebene für die gesamte Organisation festlegen.

Um ein Nutzungslimit festzulegen, müssen Sie den Agenten oder das Projekt öffnen und zur Registerkarte Budget wechseln. Geben Sie dort den gewünschten Betrag in das Feld „Budget (USD)“ ein und klicken Sie auf „Update budget“.

Wir empfehlen, zunächst alles mit einem geringen Limit zu testen und dies anzupassen, sobald Sie wissen, wie viel die einzelnen Aufgabentypen kosten.

Sie können dies direkt in Ihrem Paperclip-Dashboard verfolgen, das eine Echtzeitaufschlüsselung des Token-Verbrauchs pro Agent anzeigt. Prüfen Sie diese Aufschlüsselung in den ersten Tagen regelmäßig, um zu erkennen, welche Agenten am aktivsten sind – und welche Token ineffizient nutzen.

7. Überwachen Sie Ihre KI-Agenten

Jeder Paperclip-Agent läuft nach einem Heartbeat-Zeitplan: Er wird in festgelegten Intervallen aktiv, prüft seine aktuellen Zuweisungen und Unternehmensziele, entscheidet über den nächsten Schritt, führt ihn aus, protokolliert die Ergebnisse und bleibt dann bis zum nächsten Zyklus inaktiv.

Das Standardintervall für einen CEO-Agenten beträgt 30 bis 60 Minuten. Sie können einen Heartbeat auch manuell in den Einstellungen des Agenten auslösen, wenn ein Agent sofort handeln soll, ohne auf den nächsten geplanten Zyklus zu warten.

Der wichtigste Ort zur Überwachung Ihrer Agenten ist der Bereich „Issues“ im Dashboard. Dort sehen Sie jede Aufgabe in Ihrer Organisation – wem sie zugewiesen ist, welchen Status sie hat und wie sie mit Ihrem Unternehmensziel zusammenhängt.

Klicken Sie auf ein beliebiges Issue, um die Überlegungen des Agenten, Tool-Aufrufe und das vollständige Protokoll seiner Aktionen während dieses Heartbeats zu lesen.

Das Haupt-Dashboard von Paperclip bietet Ihnen zugleich einen Überblick über Ihre Organisation: aktive Agenten, aktuelle Aktivitäten und Budgetverbrauch auf einen Blick.

Wenn etwas schiefläuft – etwa ein Agent festhängt, nicht weiterkommt oder Ergebnisse geringer Qualität liefert –, sind die Heartbeat-Logs Ihre erste Anlaufstelle.

Häufige Ursachen für Fehler oder Ausgaben von geringer Qualität in Paperclip sind vage Aufgabenbeschreibungen, fehlende API-Schlüssel oder ein Agent, der versucht, an einen anderen Agenten zu delegieren, dem die erforderlichen Fähigkeiten fehlen.

8. Optimieren und skalieren Sie Ihre Einrichtung

Wenn Ihre Paperclip-Organisation wächst, kommt es für eine bessere Workflow-Qualität vor allem auf klarere Ziele und besser definierte Rollen an.

Sollte ein Agent wenig hilfreiche Ausgaben liefern, dann überarbeiten Sie seine Rollenbeschreibung, ergänzen Sie spezifischere Verantwortlichkeiten und fügen Sie Beispiele dafür hinzu, wie gute Ergebnisse in seiner Rolle aussehen.

Sollten Aufgaben verloren gehen oder falsch weitergeleitet werden, dann überprüfen Sie Ihre Berichtsabläufe und stellen Sie sicher, dass Ihre Delegationslogik weiterhin Sinn macht.

In technischer Hinsicht müssen Sie Ihre VPS-Infrastruktur möglicherweise mit wachsender Nutzung skalieren. Überwachen Sie daher regelmäßig die CPU- und RAM-Auslastung über Ihr Control Panel.

Wenn die Auslastung dauerhaft über 70–80 % liegt, ist das ein klares Signal, auf die nächste Stufe upzugraden. Die meisten Anbieter ermöglichen eine Skalierung ohne Ausfallzeit oder Datenverlust, sodass Sie Ressourcen schrittweise anpassen können.

Rechnen Sie damit, dass sich Ihre Struktur weiterentwickeln wird. Nach ein oder zwei Wochen realer Nutzung beginnen sich Muster abzuzeichnen – einige Rollen sind möglicherweise überlastet, bestimmte Agenten überschneiden sich oder Ziele erweisen sich als zu breit formuliert, um wirksam delegiert zu werden. Erwarten Sie dies und betrachten Sie es nicht als Scheitern. Prüfen Sie Ihre Logs, beobachten Sie, wie Arbeitsabläufe tatsächlich funktionieren, und verfeinern Sie Ihr Setup entsprechend.

Best Practices für das Einrichten von Paperclip

Mit den oben genannten Schritten bringen Sie Paperclip zum Laufen. Diese Vorgehensweisen sorgen dafür, dass Paperclip langfristig gut läuft:

• Ihre eigene System-Eingabeaufforderung schreiben. Wenn Sie KI-Agenten hinzufügen und deren Aufgaben definieren, dann verfassen Sie Ihre eigenen Prompts, um die Qualität der Ausgaben zu verbessern. Befolgen Sie beim Schreiben Best Practices für Prompt Engineering – nennen Sie die Verantwortlichkeiten des Agenten, wie er Entscheidungen angehen soll und wie gute Ausgaben für seine Rolle aussehen.
• Einen Workflow testen, bevor Sie den nächsten erstellen. Definieren Sie ein einzelnes Ziel und lassen Sie es von Ihren Agenten von Anfang bis zum Ende ausführen. Prüfen Sie dann zunächst die Ergebnisse, bevor Sie weitere Agenten oder Ziele hinzufügen. Parallele Workflows sind schwieriger zu korrigieren, wenn es zu Fehlern kommt.
• Logs frühzeitig und regelmäßig prüfen. Die ersten 48 Stunden sind am aufschlussreichsten: Fehlkonfigurationen, unklare Agenten-Rollen und fehlende API-Schlüssel werden in diesem Zeitfenster schnell sichtbar. Wenn Sie jetzt die Logs überprüfen, sparen Sie später viel Zeit.
• Ziele aktuell halten. Jede Aufgabe, die Ihre Agenten ausführen, bezieht sich auf das aktive Ziel. Liegt ein veraltetes Ziel vor, bedeutet dies, dass Ihre Agenten weiterhin auf etwas hinarbeiten, das nicht mehr relevant ist. Navigieren Sie in Ihrem Paperclip-Dashboard zu Goals, um Ihr Unternehmensziel zu bearbeiten oder ein neues hinzuzufügen.
• Genehmigungsanfragen als Feedbackschleife nutzen. Wenn die Anfragen des CEO nicht dem entsprechen, was Sie erwartet haben, ist das in der Regel ein Zeichen dafür, dass die System-Eingabeaufforderung oder das Ziel spezifischer formuliert werden müssen.
• Ihr Datenverzeichnis sichern. Ihre Paperclip-Organisationsstruktur, der Agentenverlauf und die Audit-Logs befinden sich in einem einzigen Datenverzeichnis auf Ihrem Server. Sichern Sie es regelmäßig, insbesondere bevor Sie Paperclip aktualisieren oder Ihre VPS-Konfiguration ändern.
• Dokumentieren Sie Ihre Organisationsstruktur. Wenn Ihr Agententeam wächst, sollten Sie ein Protokoll darüber führen, was jeder Agent tut, welchen Adapter er verwendet und zu welchen Zielen er beiträgt. So können Sie Ihre Einrichtung einfacher nachvollziehen, wenn Sie nach einigen Wochen mal wieder an Ihrem Setup tüfteln oder Sie jemand anderen in die Verwaltung einarbeiten müssen.

Sie möchten mehr darüber erfahren, wie Sie Paperclip einsetzen können, sobald Ihre Einrichtung stabil läuft? Lesen Sie unseren Leitfaden zu Paperclip-Anwendungsfällen.

Alle Tutorial-Inhalte auf dieser Website unterliegen Hostingers strengen redaktionellen Standards und Normen.

Erstellt von

Eveline Boschmann

Eveline ist Lokalisierungsexpertin mit langjähriger Erfahrung in der Transkreation von Inhalten für den deutschen Markt. Sie unterstützt Hostinger dabei, die Kernwerte und die Markenbotschaft des Unternehmens an ein internationales Publikum zu vermitteln und Hostingers hochwertige Tutorials für alle zugänglich zu machen.

Mehr von Eveline Boschmann