Bereitstellung eines KI-Agenten Schritt für Schritt — von der lokalen Entwicklung bis zu einem laufenden Produktionsdienst. Keine Abstraktionen, kein „es kommt darauf an“, nur die tatsächlichen Befehle und Entscheidungen.
Schritt 1: Einen Server Besorgen
Sie benötigen einen Linux-Server mit mindestens 2 GB RAM (4 GB empfohlen), einer öffentlichen IP-Adresse und SSH-Zugang. Ein VPS für 10-20 $/Monat von einem beliebigen großen Anbieter funktioniert gut. Ich verwende Ubuntu 22.04 LTS, weil es stabil und gut dokumentiert ist.
Nach der Bereitstellung: das System aktualisieren (apt update && apt upgrade), einen Nicht-Root-Benutzer erstellen, SSH-Schlüssel-Authentifizierung einrichten und die Passwortanmeldung deaktivieren. Das dauert 10 Minuten und ist das Minimum für die Sicherheit.
Schritt 2: Abhängigkeiten Installieren
Node.js (LTS-Version), npm und Git. Das ist das Minimum für OpenClaw. Wenn Sie eine Datenbank verwenden, installieren Sie diese ebenfalls. Wenn Sie Docker verwenden, installieren Sie Docker.
Ich installiere Node über nvm (Node Version Manager), weil es das Versionsmanagement erleichtert. Wenn OpenClaw eine neue Node-Version benötigt, erledigen nvm install und nvm use das, ohne andere Teile des Servers zu beeinträchtigen.
Schritt 3: Klonen und Konfigurieren
Klonen Sie Ihr Repository (oder installieren Sie OpenClaw von npm). Erstellen Sie die Konfigurationsdatei mit Ihren API-Schlüsseln, Modellpräferenzen und Integrations-Einstellungen.
Die Konfigurationsdatei ist das wichtigste Artefakt in Ihrer Bereitstellung. Alles, was der Agent tut, hängt davon ab. Ich halte eine Vorlage-Konfiguration im Repository mit Platzhaltern und eine separate .env-Datei (nicht im Repository) mit den tatsächlichen Geheimnissen.
Schritt 4: Lokal Auf Dem Server Testen
Bevor Sie das Prozessmanagement oder Reverse-Proxy einrichten, führen Sie den Agenten manuell aus: node index.js (oder was auch immer der Startbefehl ist). Senden Sie eine Testnachricht. Überprüfen Sie, ob er korrekt antwortet. Das erkennt umgebungsabhängige Probleme (fehlende Abhängigkeiten, falsche Pfade, nicht erreichbare APIs), bevor Sie weitere Komplexität hinzufügen.
Wenn es manuell nicht funktioniert, wird es auch hinter PM2 oder Docker nicht funktionieren. Debuggen Sie hier, nicht später.
Schritt 5: Prozessmanagement
Installieren Sie PM2 (npm install -g pm2) und richten Sie den Agenten als verwalteten Prozess ein: pm2 start ecosystem.config.js.
PM2 bietet Ihnen: automatischer Neustart bei Absturz, Protokollverwaltung mit Rotation, Generierung von Startskripten (so dass der Agent beim Booten startet) und Überwachungsbefehle zur Statusüberprüfung.
Führen Sie pm2 startup aus, um das Systemstartskript zu generieren. Führen Sie pm2 save aus, um die aktuelle Prozessliste zu speichern. Jetzt überlebt der Agent Neustarts.
Schritt 6: Reverse Proxy (Falls Erforderlich)
Wenn der Agent Webhooks von externen Diensten empfangen muss, richten Sie einen Reverse-Proxy (Caddy oder nginx) ein, der die SSL-Terminierung übernimmt und den Verkehr zum Agenten leitet.
Caddy ist einfacher: Eine 4-zeilige Caddyfile bietet Ihnen HTTPS mit automatischer Zertifikatsverlängerung. Nginx ist konfigurierbarer, erfordert jedoch eine manuelle Zertifikatverwaltung (verwenden Sie Certbot).
Wenn der Agent nur ausgehende Verbindungen herstellt (Messaging-Plattformen, API-Aufrufe) und keinen eingehenden Verkehr erhält, können Sie diesen Schritt überspringen.
Schritt 7: Monitoring
Mindestens: Richten Sie eine Protokollüberwachung und eine grundlegende Gesundheitsprüfung ein.
Protokolle: PM2 kümmert sich um die Protokollrotation. Richten Sie eine Möglichkeit ein, Protokolle aus der Ferne anzuzeigen (ich verwende pm2 logs über SSH oder einen einfachen Protokollbetrachter).
Gesundheitsprüfung: Ein cron-Job, der überprüft, ob der Prozess läuft, und Sie benachrichtigt, wenn nicht. Fünf Zeilen Bash-Skript. Stellen Sie ein, dass es alle 5 Minuten ausgeführt wird.
Für anspruchsvolleres Monitoring (Metriken, Dashboards, Alarme) sehen Sie sich meinen Grafana-Artikel an. Aber die grundlegende Gesundheitsprüfung deckt 90 % dessen ab, was Sie benötigen.
Schritt 8: Backup
Richten Sie tägliche Backups Ihrer Konfigurations- und Datendateien ein. Siehe meinen Artikel zur Backup-Strategie für den vollständigen Ansatz. Mindestens: Kopieren Sie Ihre Konfiguration und Daten täglich an einen zweiten Speicherort.
Schritt 9: Dokumentation
Notieren Sie: die Server-IP, wie Sie sich per SSH anmelden, wo die Konfiguration gespeichert ist, wie Sie den Dienst neu starten, wie Sie Protokolle anzeigen und wie Sie zurückrollen. Ihr zukünftiges Ich wird Ihrem gegenwärtigen Ich danken.
Der Ganze Prozess Dauert Ungefähr 2 Stunden
Schritte 1-4: 45 Minuten. Schritte 5-6: 30 Minuten. Schritte 7-9: 45 Minuten.
Nach diesen 2 Stunden haben Sie einen produktionsbereiten KI-Agenten, der auf einem zuverlässigen Server mit Prozessmanagement, Monitoring, Backups und Dokumentation läuft. Nicht über-engineered. Nicht under-engineered. Genau richtig als Ausgangspunkt, den Sie schrittweise verbessern können.
🕒 Published: