Wie man OpenClaw verwendet

Ein praktischer Leitfaden, um das Beste aus dem autonomen KI-Agenten von RoqueOS herauszuholen.

---

Agent-Oberfläche

Die KI-Agenten-App ist in zwei Hauptbereiche unterteilt:

• Chat-Bereich (links) — hier senden Sie Nachrichten und verfolgen Antworten
• Desktop-Vorschau (rechts) — Live-Stream dessen, was der Agent im Container macht

Schritt-Panel

Unterhalb des Chats zeigt ein Echtzeit-Schritt-Panel jede Aktion an, die der Agent gerade ausführt: das Navigieren zu einer URL, das Klicken auf ein Element, das Ausführen eines Befehls usw.

---

Eine Sitzung erstellen

Jede Unterhaltung mit dem Agenten erstellt eine Sitzung — einen isolierten Docker-Container mit einem exklusiven Linux-Desktop. Um zu beginnen:

1. Öffnen Sie die App KI-Agent im Launchpad.
2. Klicken Sie auf Neue Sitzung.
3. Der Container wird initialisiert (dies kann beim ersten Mal 10–30 Sekunden dauern).
4. Wenn der Desktop im rechten Panel erscheint, ist der Agent bereit.

---

Aufgaben senden

Best Practices für Prompts

Seien Sie bei der Beschreibung der Aufgabe spezifisch und objektiv. Je mehr Kontext Sie bereitstellen, desto besser ist das Ergebnis.

❌ Vage:

Recherchiere Docker

✅ Spezifisch:

Recherchiere die Top 5 Unterschiede zwischen Docker Compose v2 und v3,
erstelle eine Markdown-Datei, die die Punkte zusammenfasst, und speichere sie unter /home/user/docker-comparison.md

Beispielaufgaben

Recherche und Dokumentation:

Gehe auf die Website hetzner.com, finde die verfügbaren VPS-Pläne
und erstelle eine Vergleichstabelle mit Preisen und Funktionen im CSV-Format.

Formularautomatisierung:

Fülle das Registrierungsformular unter [URL] mit den folgenden Daten aus:
Name: Max Mustermann, E-Mail: max@example.com, Tarif: Basic

Entwicklung:

Erstelle ein Python-Skript, das Nachrichtenschlagzeilen
von Hacker News scrapt und die Top 10 in einer JSON-Datei speichert.

Website-Analyse:

Gehe zu diesem GitHub-Repository [URL], lies die README-Datei und erkläre
mir, was das Projekt macht und welche Installationsvoraussetzungen bestehen.

---

Aktionen, die der Agent auf RoqueOS ausführen kann

OpenClaw kann direkt mit Ihrem RoqueOS außerhalb des isolierten Containers interagieren:

Aktion	Beschreibung
Benachrichtigung	Eine Warnung an Ihren RoqueOS-Desktop senden
App öffnen	Eine bestimmte Anwendung im Launchpad öffnen
URL öffnen	Eine URL im RoqueOS-Browser öffnen

Beispielanwendung: Am Ende einer langen Aufgabe kann der Agent eine automatische Benachrichtigung senden, um Sie wissen zu lassen, dass er fertig ist.

---

Sitzungen verwalten

Aktive Sitzungen

Alle aktiven Sitzungen werden oben in der App aufgelistet. Sie können:

• Eine vorherige Sitzung Fortsetzen, indem Sie darauf klicken
• Eine Sitzung Beenden, um Serverressourcen freizugeben

Limit für gleichzeitige Sitzungen

Standardmäßig erlaubt der Server bis zu 3 gleichzeitige Sitzungen (konfigurierbar über AGENT_MAX_SESSIONS). Beenden Sie Sitzungen, die Sie nicht mehr benötigen, um RAM zu sparen.

---

Screenshot und Vollbild

• Screenshot — Klicken Sie auf das Kamera-Symbol, um den aktuellen Status des Desktops des Agenten zu erfassen
• Vollbild — Erweitern Sie die Desktop-Ansicht auf den gesamten Bildschirm, um visuelle Aufgaben besser verfolgen zu können

---

Bekannte Einschränkungen

• Der Agent arbeitet in einer isolierten Umgebung — er hat keinen direkten Zugriff auf Ihre lokalen Dateien, es sei denn, Sie stellen die Informationen über den Chat zur Verfügung.
• Aufgaben, die Konto-Logins (E-Mail, soziale Netzwerke) erfordern, setzen voraus, dass Sie die Anmeldeinformationen während der Unterhaltung angeben.
• Das Standard-Timeout beträgt 30 Minuten Inaktivität — sehr lange Aufgaben können gelegentliche Interaktion erfordern.

---

Fehlerbehebung

Der Agent antwortet nicht

1. Prüfen Sie, ob der Server online ist: curl http://localhost:27021/health
2. Bestätigen Sie, dass der API-Schlüssel richtig konfiguriert ist.
3. Beenden Sie die aktuelle Sitzung und erstellen Sie eine neue.

Der Desktop erscheint nicht im Panel

Der Container könnte noch initialisiert werden. Warten Sie 30 Sekunden und laden Sie die App neu.

Langsame oder unvollständige Antworten

Möglicherweise liegt ein Rate-Limit-Problem beim KI-Anbieter vor. Warten Sie einen Moment und versuchen Sie es erneut, oder reduzieren Sie die Komplexität der Aufgabe.