Das perfekte OpenClaw Setup: Workspace richtig konfigurieren
Warum dein Setup den Unterschied macht
Die meisten Leute installieren OpenClaw, verbinden Telegram und fangen an zu chatten. Das funktioniert – aber dein Agent bleibt weit unter seinem Potenzial.
Der Unterschied zwischen einem mittelmäßigen und einem großartigen KI-Assistenten liegt nicht im Modell. Er liegt in der Konfiguration. Und die lebt in deinem Workspace.
Dein Workspace: Die Kommandozentrale
Dein OpenClaw Workspace ist ein Ordner auf deinem Server. Typischerweise ~/clawd/. Hier liegt alles, was deinen Agenten ausmacht:
~/clawd/
├── AGENTS.md # Was soll der Agent tun?
├── SOUL.md # Wie soll er klingen?
├── IDENTITY.md # Wer ist er?
├── USER.md # Wer bist du?
├── HEARTBEAT.md # Wann soll er von alleine aktiv werden?
├── TOOLS.md # Welche Tools nutzt er wie?
├── skills/ # Wiederverwendbare Workflows
├── memory/ # Langzeitgedächtnis
├── .secrets/ # API-Keys (nie committen!)
└── output/ # Generierte Dateien
Lass uns die wichtigsten Dateien durchgehen.
AGENTS.md – Die wichtigste Datei in deinem Setup
Wenn OpenClaw startet, liest es als Erstes AGENTS.md. Diese Datei landet direkt im System-Prompt und beeinflusst jede einzelne Antwort.
Faustregel: Was hier steht, befolgt dein Agent.
Was reingehört
- Dein Kernauftrag: Was ist der primäre Job des Agenten?
- Tool-Anweisungen: Wie soll er bestimmte Tools einsetzen?
- Harte Regeln: Was darf er nie tun (z.B. E-Mails ohne Freigabe senden)?
- Workflow-Trigger: Was soll automatisch passieren?
Was nicht reingehört
- Lange Erklärungstexte (lieber verlinken)
- Sich häufig ändernde Informationen
- Komplette Dokumentationen
Die goldene Regel: Unter 300 Zeilen bleiben
Längere AGENTS.md-Dateien fressen Kontext-Budget. Die Qualität der Anweisungsbefolgung sinkt spürbar ab ca. 300 Zeilen. Halte es kurz und präzise.
SOUL.md – Die Persönlichkeit
Soul.md definiert wie dein Agent kommuniziert. Hier wird aus einem generischen Bot dein persönlicher Assistent.
Einige Dinge, die du hier festlegen kannst:
- Tonalität: Direkt und knapp? Oder ausführlich und freundlich?
- Sprache: Deutsch bevorzugt? Englische Fachbegriffe erlaubt?
- Verhaltensgrenzen: Nie streamen, nie ungefragt Dateien ändern, immer nachfragen bei Unsicherheit
Pro-Tipp: Lass deinen Agenten dich interviewen und die Soul.md selbst schreiben. Sag ihm: "Stell mir 15 Fragen, um zu verstehen, wie ich arbeite. Dann schreib die Soul.md." Per Sprachnachricht geht das in 10 Minuten.
IDENTITY.md und USER.md – Wer ist wer
IDENTITY.md – definiert den Agenten (Name, Charakter, Rolle). Ändert sich selten nach der Ersteinrichtung.
USER.md – definiert dich (Name, Zeitzone, Kontaktdaten, Vorlieben). Wird gelegentlich aktualisiert.
Die Trennung ist praktisch: Dein Agent-Profil bleibt stabil, während sich dein Nutzerprofil mit der Zeit weiterentwickelt.
HEARTBEAT.md – Der Agent, der von alleine arbeitet
Das Heartbeat-System macht OpenClaw besonders. Damit arbeitet dein Agent nach einem Zeitplan – auch wenn du ihm nicht schreibst.
Beispiele:
- 06:30 Uhr: Kalender prüfen, Tagesbriefing per Telegram senden
- Alle 10 Min: Prüfen ob in den nächsten 30 Min ein Meeting ansteht → automatisch Teilnehmer recherchieren
- Freitag 17:00: Wochenzusammenfassung erstellen
Das verwandelt deinen Agenten von einem reaktiven Chatbot in einen proaktiven Assistenten.
Der skills/ Ordner – Dein Agent lernt dazu
Skills sind wiederverwendbare Workflows. Jeder Skill ist ein Unterordner mit einer SKILL.md, die beschreibt, wann und wie der Workflow ausgeführt werden soll.
skills/
├── meeting-prep/ # Vorbereitung vor Calls
├── content-writer/ # Blogartikel und Social Posts
└── email-triage/ # Posteingang sortieren
Wichtig: Ein Agent mit guten Skills schlägt ein Dutzend schlecht konfigurierter Agenten. Investiere Zeit in wenige, gut durchdachte Skills statt viele oberflächliche.
Der memory/ Ordner – Warum dein Agent dich kennt
Ohne Memory startet jede Konversation bei null. Mit Memory hat dein Agent ein Langzeitgedächtnis:
- Tägliche Logs: Was wurde besprochen und erledigt
- Gelernte Präferenzen: Wie du E-Mails formulierst, welche Kunden wichtig sind
- Business-Kontext: Aktuelle Projekte, Ziele, Deadlines
Best Practice: Die Memory-Dateien sollten als YYYY-MM-DD.md gespeichert werden. Beim Start einer neuen Session liest der Agent automatisch die letzten 1-2 Tage.
.secrets/ – Zugangsdaten sicher verwalten
API-Keys, Tokens und Passwörter leben in .secrets/. Dieser Ordner wird immer gitignored – nie committen, nie teilen.
In AGENTS.md oder TOOLS.md verweist du nur auf die Pfade (~/.secrets/api-key.txt), nie auf die Werte selbst.
Die 5 häufigsten Setup-Fehler
- AGENTS.md zu lang: Über 300 Zeilen = sinkende Anweisungsbefolgung. Kürze radikal.
- Soul.md leer gelassen: Dann klingt dein Agent wie ein Kundenservice-Bot. 10 Minuten Investition, riesiger Unterschied.
- Kein Memory: Jedes Gespräch startet bei null. Richte memory/ am ersten Tag ein.
- Zu viele Agenten: Ein Agent mit 5 guten Skills > 5 separate Agenten mit je einem Skill.
- Secrets im Repository: API-Keys im Git = Sicherheitsrisiko. Immer
.secrets/gitignoren.
Dein Setup-Fahrplan
| Tag | Schritt | | --- | --- | | Tag 1 | OpenClaw installieren, Telegram verbinden, AGENTS.md mit 20 Zeilen Kern-Direktiven | | Tag 2 | Soul.md + User.md + Identity.md. Lass dich vom Agenten interviewen | | Tag 3 | Ersten Custom Skill erstellen (z.B. Meeting-Prep oder E-Mail-Entwürfe) | | Tag 4 | Memory einrichten, Heartbeat für Morgen-Briefing konfigurieren | | Woche 2+ | Verfeinern. Neue Skills nach Bedarf. AGENTS.md iterieren |
Die Kern-Erkenntnis
Dein OpenClaw-Workspace ist ein Betriebshandbuch für deinen KI-Assistenten. Je präziser du beschreibst, wer du bist, was du brauchst und welche Regeln gelten – desto weniger musst du korrigieren und desto mehr wird erledigt.
AGENTS.md ist dein wichtigstes File. Bring das zuerst in Ordnung. Alles andere ist Feinschliff.
In unserer OpenClaw Masterclass zeigen wir dir genau, wie du deinen perfekten Workspace einrichtest – Modul für Modul, vom ersten Befehl bis zum proaktiven Assistenten.