Coolify Skill für OpenClaw

OpenClaw Coolify Skill Überblick

Der Coolify Skill verbindet OpenClaw über die REST-API mit Ihrer Coolify-Instanz. Nach der Installation kann Ihr OpenClaw-Agent Anwendungen bereitstellen, Datenbanken verwalten, Umgebungsvariablen konfigurieren und Dienste überwachen — alles durch einfache Befehle in natürlicher Sprache.

Coolify ist eine quelloffene, selbst hostbare Alternative zu Vercel, Heroku und Netlify. Es ermöglicht Ihnen, statische Websites, Full-Stack-Anwendungen, Datenbanken und über 280 Ein-Klick-Dienste auf Ihren eigenen Servern bereitzustellen. Mit dem OpenClaw Coolify Skill erhalten Sie den Komfort verwalteter Plattformen und behalten gleichzeitig die volle Kontrolle über Ihre Infrastruktur und Daten.

Typischer Arbeitsablauf:

1. Bitten Sie OpenClaw, Ihre neuesten Änderungen auf dem Staging-Server bereitzustellen.
2. Der Agent ruft die Coolify-API auf, um eine Bereitstellung in Ihrem verknüpften Projekt auszulösen.
3. Build-Status und Protokolle werden in einer lesbaren Zusammenfassung zurückgegeben — kein Öffnen des Coolify-Dashboards nötig.

Voraussetzungen für den Coolify Skill

Bevor Sie den Coolify Skill installieren, stellen Sie sicher, dass Sie Folgendes haben:

• OpenClaw installiert und lauffähig (v1.0+)
• Eine Coolify-Instanz auf Ihrem Server — Installationsanleitung
• Coolify-API-Token, generiert über Ihr Coolify-Dashboard
• Mindestens eine Anwendung oder einen Dienst in Coolify konfiguriert
• clawhub CLI installiert für die Skill-Verwaltung

Überprüfen Sie Ihre Einrichtung:

# OpenClaw-Version prüfen
openclaw --version

# Coolify-Erreichbarkeit prüfen (ersetzen Sie die URL durch Ihre Instanz-URL)
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# clawhub CLI prüfen
clawhub --version

So Installieren Sie den Coolify Skill

Installieren Sie den Coolify Skill mit einem einzigen Befehl:

npx clawhub@latest install coolify

Um die Installation zu überprüfen:

clawhub list

Sie sollten coolify in der Liste der installierten Skills sehen. Der Skill fordert Sie bei der ersten Verwendung zur Eingabe Ihres Coolify-API-Endpunkts und Tokens auf.

Coolify Skill Konfiguration

Der Coolify Skill benötigt einen API-Token und Ihre Instanz-URL. Generieren Sie einen Token im Coolify-Dashboard unter Einstellungen → API Tokens.

Token-Berechtigungen

Coolify-API-Tokens bieten vollständigen Zugriff auf Ihre Instanz. Befolgen Sie das Prinzip der minimalen Berechtigung:

| Anwendungsfall | Empfehlung | |----------------|------------| | Nur-Lese-Überwachung | Erstellen Sie einen Token für ein Teammitglied mit Betrachter-Rolle | | Vollständige Bereitstellung | Verwenden Sie einen Admin-Token, überprüfen Sie aber alle Aktionen vor der Bestätigung | | Multi-Server | Erstellen Sie separate Tokens pro Server zur Isolierung |

Umgebung einrichten

# Coolify-Instanz-URL festlegen
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# Coolify-API-Token festlegen
export COOLIFY_TOKEN=your_api_token_here

Wichtig: Speichern Sie Tokens niemals fest in Konfigurationsdateien. Verwenden Sie Umgebungsvariablen oder einen Passwort-Manager wie 1Password oder Bitwarden. Halten Sie Ihre Coolify-Instanz stets auf dem neuesten Stand, um Sicherheitsupdates zu erhalten.

Verbindung überprüfen

Nach dem Setzen der Umgebungsvariablen überprüfen Sie die Verbindung:

# API-Zugang testen
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Coolify Skill Anwendungsbeispiele

1. Eine Anwendung bereitstellen

Sie: "Stelle die neueste Version meiner Web-App auf Coolify bereit."

Der Agent identifiziert Ihre Anwendung anhand des Namens, löst eine Bereitstellung über die Coolify-API aus und streamt den Build-Status. Sie erhalten eine Zusammenfassung mit der Bereitstellungs-URL und der Build-Dauer.

2. Umgebungsvariablen verwalten

Sie: "Füge DATABASE_URL zur Staging-Umgebung meines API-Dienstes hinzu."

Der Agent ruft die Coolify-API auf, um die Umgebungsvariable für Ihre angegebene Anwendung zu erstellen. Sie können auch nach dem Auflisten, Aktualisieren oder Massenaktualisieren von Variablen über verschiedene Umgebungen hinweg fragen. Der Skill stellt sicher, dass sensible Werte in der Ausgabe maskiert werden.

3. Anwendungsprotokolle anzeigen

Sie: "Zeige mir die letzten 100 Zeilen der Protokolle vom Zahlungsdienst."

Der Agent ruft die Container-Protokolle über die Coolify-API ab und präsentiert sie in einem lesbaren Format. Er kann auch Fehler hervorheben und basierend auf häufigen Mustern Lösungen vorschlagen.

4. Einen Dienst neu starten

Sie: "Starte die PostgreSQL-Datenbank auf meinem Produktionsserver neu."

Der Agent sendet einen Neustart-Befehl an den angegebenen Dienst. OpenClaw fordert eine Bestätigung an, bevor Neustart- oder Stopp-Operationen auf Produktionsdiensten ausgeführt werden.

5. Ressourcennutzung prüfen

Sie: "Wie viel CPU und Arbeitsspeicher nutzt mein Staging-Server?"

Der Agent fragt die Coolify-API nach Server-Metriken ab und präsentiert eine Zusammenfassung der CPU-, Arbeitsspeicher- und Festplattennutzung. Er kann Sie warnen, wenn eine Ressource sich ihrem Limit nähert.

Sicherheit und Best Practices

Der Coolify Skill kann Schreiboperationen auf Ihren Servern und Anwendungen durchführen. Befolgen Sie diese Richtlinien für einen sicheren Betrieb:

• Verwenden Sie minimale Berechtigungen. Erstellen Sie dedizierte API-Tokens mit minimalen Berechtigungen. Vermeiden Sie die Verwendung Ihres Haupt-Admin-Tokens für automatisierte Operationen.
• Überprüfen Sie vor der Produktionsbereitstellung. Testen Sie Bereitstellungen immer zuerst auf dem Staging-Server. OpenClaw fordert eine Bestätigung vor Produktionsbereitstellungen an.
• Halten Sie Coolify aktuell. Aktualisieren Sie Ihre Coolify-Instanz regelmäßig, um die neuesten Sicherheitspatches zu erhalten — führen Sie das Update über das Coolify-Dashboard durch oder verwenden Sie die offizielle Aktualisierungsanleitung.
• Sichern Sie Ihre Instanz ab. Platzieren Sie Coolify hinter einer Firewall oder einem VPN. Verwenden Sie starke Passwörter und aktivieren Sie die Zwei-Faktor-Authentifizierung.
• Rotieren Sie API-Tokens. Generieren Sie Tokens regelmäßig neu und widerrufen Sie ungenutzte über das Dashboard.
• Erstellen Sie regelmäßig Sicherungen. Nutzen Sie die integrierte S3-Backup-Funktion von Coolify, um Ihre Konfiguration und Datenbankdaten zu schützen.

Fehlerbehebung Häufiger Probleme

"Connection refused" oder "ECONNREFUSED"

Der Skill kann Ihre Coolify-Instanz nicht erreichen.

1. Überprüfen Sie, ob COOLIFY_BASE_URL korrekt ist und das Protokoll enthält (https://).
2. Prüfen Sie, ob Ihre Coolify-Instanz läuft: systemctl status coolify auf Ihrem Server.
3. Stellen Sie sicher, dass Ihre Firewall den Datenverkehr auf dem Coolify-Port zulässt (Standard: 8000).
4. Wenn Sie ein VPN oder Tailscale verwenden, bestätigen Sie, dass der Tunnel aktiv ist.

"Unauthorized" oder "401 Error"

Ihr API-Token ist ungültig oder abgelaufen.

1. Überprüfen Sie Ihren Token unter Coolify Dashboard → Einstellungen → API Tokens.
2. Generieren Sie den Token neu, falls er widerrufen wurde.
3. Überprüfen Sie, ob die Umgebungsvariable COOLIFY_TOKEN korrekt gesetzt ist.

# Token-Setzung überprüfen
echo $COOLIFY_TOKEN

# Authentifizierung testen
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

"Application not found"

Der Skill kann die von Ihnen referenzierte Anwendung nicht finden.

1. Alle Anwendungen auflisten: Fragen Sie OpenClaw "Liste alle meine Coolify-Anwendungen auf."
2. Überprüfen Sie, ob der Anwendungsname oder die UUID mit dem übereinstimmt, was in Ihrem Coolify-Dashboard steht.
3. Stellen Sie sicher, dass Ihr API-Token Zugriff auf das Team hat, dem die Anwendung gehört.