Das perfekte OpenClaw Setup: Workspace richtig konfigurieren

Direkte Antwort: Ein perfektes OpenClaw-Setup besteht aus einem sauber strukturierten Workspace mit fünf Kern-Dateien (AGENTS.md, SOUL.md, IDENTITY.md, USER.md, HEARTBEAT.md), einem skills/-Ordner für wiederverwendbare Workflows, einem memory/-Ordner für Langzeitgedächtnis und einem .secrets/-Ordner für API-Keys. Halte AGENTS.md unter 300 Zeilen, gib dem Agenten in Soul.md eine klare Persönlichkeit und richte Memory ab Tag 1 ein. Der Rest ist Feinschliff.

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.

Ein gut konfigurierter Agent kennt deinen Tagesablauf, weiß wie du E-Mails schreibst, hat Zugriff auf deine wichtigsten Tools und arbeitet auch dann, wenn du gerade kein Zeit für ihn hast. Ein schlecht konfigurierter Agent ist ein hübscher, aber generischer Chatbot.

In diesem Beitrag gehen wir Datei für Datei durch, was in einen produktiven OpenClaw-Workspace gehört, welche typischen Fehler auftauchen und in welcher Reihenfolge du am besten vorgehst.

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. Wenn du den Workspace zum ersten Mal anlegst, hilft dir Modul 3: Soul.md konfigurieren im Kurs, dabei jeden Schritt visuell zu sehen.

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

Beispiel: Eine schlanke AGENTS.md

# AGENTS

## Kernauftrag
Du bist mein persönlicher Operations-Assistent. Du verwaltest E-Mails, Kalender,
Aufgaben und Recherchen. Du arbeitest proaktiv, aber niemals destruktiv.

## Harte Regeln
- Sende NIE E-Mails ohne explizite Freigabe ("Ja, senden")
- Lösche NIE Kalendereinträge ohne Rückfrage
- Speichere NIE Kreditkartennummern in Memory

## Standard-Tools
- E-Mail: Gmail-Skill (siehe skills/gmail/)
- Kalender: Google Calendar (siehe skills/calendar/)
- Web-Recherche: Brave Search

## Workflow-Trigger
- 06:30 Uhr: Tagesbriefing per Telegram (siehe HEARTBEAT.md)
- Bei neuer E-Mail: Triage gemäß skills/email-triage/

Knapp 25 Zeilen, jede davon load-bearing. Der Rest gehört in Skills oder andere Dateien.

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. Wenn etwas länger werden muss, lager es in eine separate Datei aus und verlinke sie.

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
• Antwortlänge: Default kurz, ausführlich nur bei expliziter Nachfrage
• Humor und Stil: Trocken? Verspielt? Sachlich?

Beispiel-Snippet aus einer Soul.md

## Stimme
- Direkt, knapp, ohne Floskeln. Keine "Selbstverständlich"-Phrasen.
- Antworten standardmäßig unter 5 Sätzen, längere Outputs nur wenn explizit gewünscht.
- Du-Form. Deutsche Begriffe, englische Fachterme nur wenn nötig.

## No-Gos
- Niemals "Als KI ..." schreiben.
- Keine Geviertstriche verwenden, stattdessen Doppelpunkt oder Punkt.
- Keine ungebetenen Disclaimer.

## Bei Unsicherheit
- Lieber kurz nachfragen, als raten.
- Wenn 2 Optionen plausibel sind: beide nennen, nicht entscheiden.

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 und du bekommst eine Soul, die wirklich zu dir passt.

IDENTITY.md und USER.md: Wer ist wer

IDENTITY.md definiert den Agenten (Name, Charakter, Rolle). Ändert sich selten nach der Ersteinrichtung.

# Identity

Name: Aria
Rolle: Persönlicher Operations-Assistent
Charakter: Pragmatisch, proaktiv, knapp.
Vorbilder: Eine erfahrene Assistenz, die seit 10 Jahren mit dem CEO arbeitet.

USER.md definiert dich (Name, Zeitzone, Kontaktdaten, Vorlieben). Wird gelegentlich aktualisiert.

# User

Name: Gorden Wuebbe
Zeitzone: Europe/Berlin
E-Mail: gw@famefact.com
Telefon: +49 ...
Sprache primär: Deutsch
Arbeitszeiten: Mo-Fr 9-18 Uhr
Aktuelle Hauptprojekte: OpenClaw-Kurs, Famefact Lead-System, GEO-Dashboard

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
• Sonntag 20:00: Vorbereitung der kommenden Woche

Beispiel HEARTBEAT.md

# Heartbeat

## 06:30 Uhr (täglich, Mo-Fr)
1. Lade memory/YYYY-MM-DD.md von gestern.
2. Lese Kalender für heute.
3. Lese ungelesene E-Mails (max. 50).
4. Erstelle 5-Punkte-Briefing.
5. Sende per Telegram an User.

## Alle 10 Min (Mo-Fr 9-18 Uhr)
- Prüfe Kalender auf Termine in den nächsten 30 Min.
- Wenn neuer Termin: kurze Vorbereitung (Teilnehmer, letzte E-Mails).

Das verwandelt deinen Agenten von einem reaktiven Chatbot in einen proaktiven Assistenten. Schritt-für-Schritt-Setup dazu siehst du in Modul 4: Skills installieren.

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
├── lead-recherche/     # Cold-Outreach-Vorbereitung
└── invoice-creator/    # Rechnungen schreiben

Eine SKILL.md sieht typischerweise so aus:

# Skill: meeting-prep

## Trigger
- User sagt "bereite Meeting mit X vor"
- Heartbeat-Trigger: 30 Min vor Kalendertermin

## Schritte
1. Hole Kalender-Eintrag (Titel, Zeit, Teilnehmer).
2. Recherchiere Teilnehmer (LinkedIn, letzte E-Mails).
3. Lade letzte 5 E-Mails mit dem Teilnehmer.
4. Erstelle 1-Page-Briefing mit:
   - Hintergrund
   - Letzte Interaktionen
   - Mögliche Themen
5. Sende per Telegram, max. 250 Wörter.

Wichtig: Ein Agent mit guten Skills schlägt ein Dutzend schlecht konfigurierter Agenten. Investiere Zeit in wenige, gut durchdachte Skills statt viele oberflächliche. Welche Skills sich besonders lohnen, liest du im Beitrag OpenClaw-Skills für Selbstständige.

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

Empfohlene Memory-Struktur

memory/
├── 2026-05-08.md       # Tagesprotokoll
├── 2026-05-09.md
├── 2026-05-10.md
├── projects/           # Eine Datei pro Projekt
│   ├── openclaw-kurs.md
│   └── famefact-leads.md
├── people/             # Eine Datei pro wichtige Kontaktperson
│   └── jane-doe.md
└── learnings.md        # Übergreifende Erkenntnisse

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. Empfehle ihm explizit in AGENTS.md, alte Memory bei Bedarf nachzuladen.

.secrets/: Zugangsdaten sicher verwalten

API-Keys, Tokens und Passwörter leben in .secrets/. Dieser Ordner wird immer gitignored, nie committen, nie teilen.

.secrets/
├── anthropic.txt       # API-Key Anthropic
├── openai.txt          # API-Key OpenAI
├── telegram-bot.txt    # Bot-Token
└── google-oauth.json   # Google Workspace

In AGENTS.md oder TOOLS.md verweist du nur auf die Pfade (~/.secrets/api-key.txt), nie auf die Werte selbst. Der Identity-File-Mechanismus sorgt dafür, dass die Keys nur zur Laufzeit eingeladen werden.

Eine .gitignore mit folgendem Inhalt ist Pflicht:

.secrets/
output/
memory/
*.log

TOOLS.md: Werkzeugkiste sauber dokumentiert

In TOOLS.md beschreibst du, welche externen Tools dein Agent nutzen darf und unter welchen Bedingungen. Die meisten Skills greifen darauf zurück.

# Tools

## Gmail
- Skill: skills/gmail/
- Auth: ~/.secrets/google-oauth.json
- Erlaubt: lesen, Entwürfe erstellen
- Verboten: senden ohne Freigabe, löschen

## Calendar
- Skill: skills/calendar/
- Auth: ~/.secrets/google-oauth.json
- Erlaubt: lesen, Termine erstellen mit Bestätigung
- Verboten: Termine löschen ohne Rückfrage

## Brave Search
- Skill: skills/brave-search/
- Auth: ~/.secrets/brave.txt
- Limit: 100 Suchen/Tag

Diese Datei ist gleichzeitig Dokumentation und Schutzmechanismus. Der Agent liest sie und hält sich daran.

Die 5 häufigsten Setup-Fehler

1. AGENTS.md zu lang: Über 300 Zeilen = sinkende Anweisungsbefolgung. Kürze radikal.
2. Soul.md leer gelassen: Dann klingt dein Agent wie ein Kundenservice-Bot. 10 Minuten Investition, riesiger Unterschied.
3. Kein Memory: Jedes Gespräch startet bei null. Richte memory/ am ersten Tag ein.
4. Zu viele Agenten: Ein Agent mit 5 guten Skills schlägt 5 separate Agenten mit je einem Skill.
5. 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 | | Tag 5 | TOOLS.md schreiben, Secrets sortieren, Backup-Plan | | Woche 2+ | Verfeinern. Neue Skills nach Bedarf. AGENTS.md iterieren |

Tipp: Du brauchst noch einen kleinen VPS, auf dem dein Workspace zuverlässig 24/7 läuft? Hostinger bietet KVM-VPS in Frankfurt mit DSGVO-Standort, ab wenigen Euro pro Monat und mit etwas anfängerfreundlicherem Panel als Hetzner. Eine Alternative, keine Pflicht. Hostinger ansehen →Affiliate-Link — wir erhalten eine Provision, wenn du über diesen Link bestellst. Für dich ändert sich am Preis nichts.

Backup-Strategie für deinen Workspace

Ein Workspace, den du nicht sicherst, ist eine Zeitbombe. Empfohlen:

1. Git-Repository für AGENTS.md, SOUL.md, IDENTITY.md, USER.md, HEARTBEAT.md, TOOLS.md und skills/. Privat, mit .secrets/ und memory/ in der .gitignore.
2. Tägliches rsync-Backup des kompletten Workspaces (inklusive memory/) auf ein zweites Storage, z. B. einen Hetzner Storage Box oder S3-Bucket.
3. Wöchentliches Snapshot über die Cloud-Console deines VPS-Anbieters.

Mit dieser Kombi überlebst du selbst einen kompletten Server-Crash ohne Datenverlust.

Wie weit kannst du den Workspace skalieren?

Anfänger fragen oft, ob ein einzelner Workspace eines Tages "voll" wird. Die ehrliche Antwort: Praktisch nicht. AGENTS.md bleibt klein, Skills wachsen modular, Memory rotiert per Datum. Wer trotzdem mehrere Personen anbinden will, nutzt entweder:

• Mehrere Workspaces auf einem Server mit eigenem Telegram-Bot pro Workspace, oder
• Ein Workspace mit Multi-User-Allowlist, in dem jeder User über USER.md-Profile und Berechtigungs-Tags geführt wird.

Welche Variante besser passt, hängt vom Use-Case ab. Für Solo-Selbstständige: ein Workspace. Für Agenturen mit mehreren Beratern: pro Person ein Workspace, alle auf demselben VPS.

FAQ: Setup-Fragen, die immer wieder auftauchen

Wie groß darf SOUL.md werden?

Maximal 100-150 Zeilen. Alles darüber wird vom Modell schlechter befolgt. Wenn du mehr willst, baue stattdessen Skills.

Kann ich AGENTS.md und SOUL.md zusammenlegen?

Technisch ja, aber nicht empfehlenswert. Die Trennung "Was tut er" vs. "Wie tut er es" hilft dir später beim Iterieren enorm.

Wo liegt der Unterschied zwischen IDENTITY.md und SOUL.md?

IDENTITY.md ist Wer-bin-ich (Name, Rolle, Vorbild). SOUL.md ist Wie-verhalte-ich-mich (Tonalität, Schreibstil, No-Gos). Identity ändert sich kaum, Soul wird nachjustiert.

Wie viele Skills sind sinnvoll?

Faustregel: 5-15 Skills pro Workspace. Weniger ist besser. Wenn ein Skill unter 3-mal pro Monat genutzt wird, gehört er gelöscht.

Soll ich den Workspace im Home-Verzeichnis oder unter /opt ablegen?

Für Single-User-Setups: ~/clawd/ (Home). Für Multi-User auf einem Server: /opt/clawd/<user>/. Wichtig ist, dass der Process-User auch Eigentümer der Dateien ist.

Wie versioniere ich Soul.md sauber?

Per Git im selben Repo wie AGENTS.md. Bei größeren Änderungen klare Commit-Messages, z. B. "soul: tonalität direkter, weniger floskeln". Du wirst dich später für jede saubere Message bedanken.

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 in Modul 1 bis zum proaktiven Assistenten in Modul 4.