Anatomie eines perfekten Openclaw-Setups

Eine vollständige Anleitung zu Arbeitsbereichsdateien, Skills, Kanälen, Berechtigungen und deren korrekter Konfiguration.

Die meisten OpenClaw-Benutzer installieren es, verbinden einen Kanal und öffnen nie den Arbeitsbereichsordner.

Das ist ein Fehler.

Dein Arbeitsbereich ist die Kommandozentrale dafür, wie sich dein KI-Assistent verhält. Er enthält deine Identität, benutzerdefinierte Skills, Kanalverbindungen und das Gedächtnis. Sobald du verstehst, was wo sitzt, kannst du OpenClaw genau so konfigurieren, wie du es brauchst.

Dieser Leitfaden führt dich durch die Anatomie eines perfekten Setups.

PS: Openclaw ist erst der Anfang.

In unserer Build With AI-Community zeigen wir dir, wie du benutzerdefinierte Agenten, Apps und Automatisierungen baust, die du selbst nutzen oder an Kunden verkaufen kannst. Startet bald.

Trage dich hier in die Warteliste ein: https://return-my-time.kit.com/1bd2720397

-----------------------------------------

Zwei Konfigurationsebenen, nicht eine

Bevor wir tiefer eintauchen, ist es gut zu wissen: OpenClaw verwendet zwei Konfigurationsebenen.

Die erste ist dein Arbeitsbereichsordner (normalerweise ~/clawd/ oder wo auch immer du es initialisiert hast). Dieser enthält deine persönliche Konfiguration, Skills, Gedächtnis und Geheimnisse.

Die zweite ist die globale Installation unter opt/homebrew/lib/node_modules/clawdbot/ (oder entsprechend auf deinem System). Diese enthält die Kerndokumentation, integrierte Skills und Standardverhalten.

Dein Arbeitsbereich ist der Ort, an dem du anpasst. Die globale Installation ist das, was du aktualisierst.

AGENTS.md: Deine Betriebsanleitung

Dies ist die wichtigste Datei in deinem gesamten Setup. Wenn OpenClaw eine Sitzung startet, wird als Erstes AGENTS.md gelesen. Es wird direkt in den System-Prompt geladen und bleibt für die gesamte Konversation im Gedächtnis.

Einfach gesagt: Was auch immer du in AGENTS.md schreibst, dein Agent wird es befolgen.

Wenn du ihm sagst, er solle immer zuerst deinen Kalender prüfen, bevor er Besprechungszeiten vorschlägt, tut er das. Wenn du sagst: „Sende niemals E-Mails ohne meine ausdrückliche Zustimmung“, wird er dies jedes Mal respektieren.

Was gehört eigentlich in AGENTS.md:

Schreibe:

• Deine zentrale Betriebsanweisung (Was ist die Aufgabe des Agenten?)
• Wichtige Werkzeuge und wie man sie verwendet (E-Mail-CLI, Aufgabenverwaltungs-Workflows)
• Harte Regeln, die niemals gebrochen werden dürfen
• Links zu wichtigen Ressourcen (API-Dokumentation, Skill-Speicherorte)
• Workflow-Auslöser (was soll automatisch passieren)

Schreibe nicht:

• Vollständige Dokumentation, auf die du stattdessen verlinken kannst
• Lange Absätze, die Theorie erklären
• Informationen, die sich häufig ändern

Halte AGENTS.md unter 300 Zeilen. Dateien, die länger sind, fressen zu viel Kontext, und die Befolgungsrate der Anweisungen sinkt tatsächlich.

Hier ist ein minimales, aber effektives Beispiel:

1# AGENTS.md - Clawdbot Workspace
2
3## Zentraler Arbeitsauftrag
4Mein Assistent fungiert als proaktiver Helfer für mein Unternehmen.
5
6**Der Auftrag:**
7- Mir so viel Arbeit wie möglich abnehmen
8- Proaktiv sein – nicht abwarten, bis ich gefragt werde
9
10## Wichtige Werkzeuge
11- **E-Mail:** Posteingang täglich prüfen, dringende Elemente markieren
12- **Kalender:** Vor der Terminplanung Konflikte prüfen
13- **Aufgabenmanager:** Erledigte Arbeiten mit dem Dashboard synchronisieren
14
15## Harte Regeln
16- Dienste NIE ohne explizite Erlaubnis neu starten
17- Daten vor der Terminplanung immer mit `date`-Befehl prüfen
18- Alle erledigten Arbeiten im Tracking-System protokollieren

Das sind etwa 20 Zeilen Kernanweisungen. Es gibt deinem Agenten alles, was er braucht, um produktiv zu arbeiten, ohne ständige Klärungen.

SOUL.md: Persona und Grenzen

SOUL.md definiert, wer dein Agent ist und wie er kommunizieren soll. Hier lebt die Persönlichkeit.

1# SOUL.md - Persona & Grenzen
2
3- Antworten kurz und direkt halten.
4- Bei Bedarf klärende Fragen stellen.
5- Niemals Streaming-/Teilantworten an externe Nachrichtenoberflächen senden.

Wenn AGENTS.md die Bedienungsanleitung ist, dann ist SOUL.md das Persönlichkeitsprofil. Manche Benutzer schreiben hier ausführliche Personas. Andere halten es minimal. Beides funktioniert – es hängt davon ab, wie viel Persönlichkeitsanpassung du möchtest.

IDENTITY.md und USER.md: Wer ist wer

Diese beiden Dateien legen die Beziehung zwischen deinem Agenten und dir fest.

IDENTITY.md definiert deinen Agenten:

1# IDENTITY.md - Agentenidentität
2
3- Name: [Dein Agentenname]
4- Kreatur: [Optional: lustiger Beschreiber]
5- Vibe: Klug, hilfreich, zuverlässig, hartnäckiger Problemlöser
6- Emoji: [Dein gewähltes Emoji]

USER.md definiert dich:

1# USER.md - Benutzerprofil
2
3- Name: [Dein Name]
4- Bevorzugte Anrede: [Spitzname]
5- Zeitzone: [Deine Zeitzone]
6- Telefon: [Deine Nummer]
7- Kalender: [Kalenderplattform und E-Mail]

Warum separate Dateien? Weil sie unterschiedliche Zwecke erfüllen. IDENTITY.md ändert sich selten, einmal eingerichtet. USER.md aktualisiert sich, wenn sich deine Vorlieben ändern. Die Trennung erleichtert die Wartung.

HEARTBEAT.md: Geplante Check-ins

Diese Datei steuert, was dein Agent während Heartbeat-Polls tut – geplante Momente, in denen das System prüft, ob etwas Aufmerksamkeit benötigt.

1# HEARTBEAT.md
2
3**Wenn die Nachricht "⚠️ EXECUTION CRON" enthält:**
4- Dies ist KEIN Heartbeat-Check – es ist Arbeit zu erledigen
5- Lies die vollständigen Anweisungen in der Nachricht
6- Führe alle erforderlichen Schritte aus
7- Gib niemals HEARTBEAT_OK zurück
8
9**Andernfalls:**
10- Wenn nichts Aufmerksamkeit benötigt, gib HEARTBEAT_OK zurück
11- Halte es minimal

Heartbeats sind mächtig, um proaktive Agenten zu erstellen. Dein Agent kann deinen Kalender prüfen, deinen Posteingang durchsuchen oder jeden automatisierten Workflow nach Zeitplan ausführen, alles ausgelöst durch Heartbeat-Polls.

TOOLS.md: Dokumentation externer Werkzeuge

Diese Datei enthält deine Notizen zu externen Werkzeugen und Konventionen. Sie definiert nicht, welche Werkzeuge existieren (OpenClaw kümmert sich intern darum), aber hier dokumentierst du, wie DU sie benutzt.

1# TOOLS.md - Benutzernotizen zu Werkzeugen
2
3## E-Mail-CLI
4- Konto: [email protected]
5- Üblich: `cli email search`, `cli calendar create`
6
7## Aufgabenverwaltungs-API
8- Token-Speicherort: ~/.secrets/task-api-token.txt
9- Verwende immer `limit=100`, um Paginierungsprobleme zu vermeiden
10- Statuskonvertierung: [Dokumentiere deinen spezifischen Workflow]
11
12## Web-Scraping-Tool (wenn Websites normale Anfragen blockieren)
13- Speicherort: ~/clawd/.venv/scraper
14- Verwende Stealth-Modus für geschützte Seiten

Dies wird dein persönlicher Nachschlageleitfaden. Wenn dein Agent ein Werkzeug verwenden muss, prüft er TOOLS.md auf deine spezifischen Konventionen.

Der Ordner skills/: Wiederverwendbare Workflows

Skills sind der Bereich, in dem OpenClaw richtig mächtig wird. Jeder Skill ist ein in sich geschlossener Workflow, den dein Agent aufrufen kann, wenn die Aufgabe zur Skill-Beschreibung passt.

Jeder Skill lebt in einem eigenen Unterordner mit einer SKILL.md-Datei:

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

Eine SKILL.md verwendet YAML-Frontmatter, um zu beschreiben, wann sie verwendet werden soll:

1---
2name: meeting-prep
3description: Automatisierte Recherche und Briefing vor Anrufen. Verwenden, wenn der Benutzer nach anstehenden Besprechungen fragt oder die Besprechungsvorbereitung durchführen möchte.
4---
5
6# Meeting Prep Skill
7
8## Wann auslösen:
9- Benutzer fragt nach anstehenden Besprechungen
10- Planmäßig alle 10 Minuten per Cron ausführen
11- Nur für ERSTMALIGE ANRUFE briefen
12
13## Ablauf:
141. Kalender auf Besprechungen in den nächsten 15-45 Minuten prüfen
152. Teilnehmer recherchieren (LinkedIn, Unternehmenswebsite)
163. Briefing-Dokument erstellen
174. Link zum Kalenderereignis hinzufügen

Der Hauptunterschied zu statischen Anweisungen: Skills können unterstützende Dateien bündeln. Die Datei references/templates.md kann Beispielausgaben, bewährte Formate oder zusätzlichen Kontext enthalten, der nur geladen wird, wenn der Skill aktiv ist.

Der Ordner memory/: Dauerhafter Kontext

Dies ist das Langzeitgedächtnis deines Agenten. Sitzungstranskripte, erlernte Präferenzen und tägliche Protokolle leben hier.

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

Gute Praktiken:

• Tägliche Protokolle unter memory/YYYY-MM-DD.md ablegen
• Zu Sitzungsbeginn liest dein Agent heute + gestern, falls vorhanden
• Dauerhafte Fakten, Präferenzen und Entscheidungen erfassen
• Keine Geheimnisse speichern

Gedächtnisdateien geben deinem Agenten Kontext über Sitzungen hinweg. Ohne sie beginnt jedes Gespräch bei Null.

Der Ordner .secrets/: Anmeldedaten

API-Tokens, Passwörter und sensible Konfigurationen leben hier. Dieser Ordner sollte in der .gitignore stehen und niemals versioniert werden.

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

Deine AGENTS.md oder TOOLS.md können auf diese Pfade verweisen, ohne die tatsächlichen Werte preiszugeben.

Kanalkonfiguration: Wo du mit deinem Agenten sprichst

OpenClaw unterstützt mehrere Nachrichtenkanäle: Discord, Telegram, Signal, WhatsApp und mehr. Die Kanalkonfiguration lebt in deiner Gateway-Konfiguration (verwaltet über clawdbot gateway-Befehle).

Wichtige Konzepte:

• Jeder Kanal hat sein eigenes Sitzungsverhalten
• Du kannst mehrere Kanäle gleichzeitig aktiv haben
• Kanalspezifische Regeln (wie „Antworte nur, wenn in Discord @mentioned") gehören in AGENTS.md

Das Gesamtbild

So sieht alles zusammen aus:

1~/clawd/
2├── AGENTS.md           # Betriebsanleitung (tägliche Nutzung)
3├── SOUL.md             # Persona und Grenzen
4├── IDENTITY.md         # Agentenidentität
5├── USER.md             # Dein Profil
6├── HEARTBEAT.md        # Verhalten bei geplanten Check-ins
7├── TOOLS.md            # Dokumentation externer Werkzeuge
8├── BOOTSTRAP.md        # Erster-Lauf-Ritual (danach löschen)
9│
10├── skills/             # Benutzerdefinierte Workflows
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # Dauerhafter Kontext
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # API-Schlüssel und Anmeldedaten (gitignoriert)
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # Generierte Dateien und Exporte

Ein praktisches Setup für den Einstieg

Wenn du bei Null anfängst, ist dies eine gut funktionierende Vorgehensweise.

Schritt 1. Führe openclaw onboard aus und schließe die Ersteinrichtung ab. Wähle deinen Modellanbieter und verbinde mindestens einen Kanal.

Schritt 2. Erstelle deinen Arbeitsbereichsordner und füge AGENTS.md mit deinen Kernanweisungen hinzu. Beginne mit 10-20 Zeilen, die deine Hauptanwendungsfälle abdecken.

Schritt 3. Füge IDENTITY.md, USER.md und SOUL.md hinzu. Diese legen die Beziehung und Persönlichkeit fest.

Schritt 4. Erstelle deinen ersten Skill für einen Workflow, den du wiederholt ausführst. Besprechungsvorbereitung, E-Mail-Entwürfe oder Content-Erstellung sind gute Ausgangspunkte.

Schritt 5. Richte memory/ mit einer täglichen Protokollvorlage ein. Dein Agent wird mit der Zeit Kontext aufbauen.

Schritt 6. Füge TOOLS.md hinzu, sobald du werkzeugspezifische Muster entdeckst, die es wert sind, dokumentiert zu werden.

Das ist ehrlich gesagt alles, was du für 95 % der Anwendungsfälle brauchst. Erweiterte Funktionen wie Cron-Jobs, Multi-Agenten-Setups und benutzerdefinierte Kanal-Plugins kommen ins Spiel, wenn du bestimmte Workflows automatisieren möchtest.

Die wichtigste Erkenntnis

Dein OpenClaw-Arbeitsbereich ist eigentlich ein Protokoll, um deinem KI-Assistenten mitzuteilen, wer du bist, was erledigt werden muss und welche Regeln er befolgen soll. Je klarer du das definierst, desto weniger Zeit verbringst du damit, deinen Agenten zu korrigieren, und desto mehr Zeit verbringt er mit nützlicher Arbeit.

AGENTS.md ist deine Datei mit der höchsten Hebelwirkung. Stelle sie zuerst richtig ein. Alles andere ist Optimierung.

Starte klein, verfeinere mit der Zeit und behandle es wie jede andere Infrastruktur in deinem Workflow: etwas, das sich jeden Tag auszahlt, sobald es richtig eingerichtet ist.

PS: Openclaw ist erst der Anfang.

In unserer Build With AI-Community zeige ich dir, wie du benutzerdefinierte Agenten, Apps und Automatisierungen baust, die du selbst nutzen oder an Kunden verkaufen kannst. Startet bald.

Trage dich hier in die Warteliste ein:

https://return-my-time.kit.com/1bd2720397