USER.md: Die eine Datei, die deinen KI-Agenten wirklich versteht wer du bist
Der Tweet, der das erklärt
Heute Morgen tauchte ein Tweet auf, der bereits tausendfach geteilt wird:
> *"Since projects like OpenClaw and Lobster have popularized personal agents, I've seen a wave of AI personalization solutions lately: they use structured Markdown files — like USER.md and MEMORY.md — to let AI remember every detail about you. Your preferences…"*
Das trifft einen echten Nerv. Denn die meisten Agenten fühlen sich nach dem Setup immer noch wie generische Chatbots an — sie wissen nichts über die Person, der sie helfen. Jede Sitzung beginnt neu. Jede Präferenz muss neu erklärt werden.
USER.md löst genau das.
---
Was ist USER.md und warum gibt es sie?
OpenClaw-Agenten haben mehrere Kerndateien:
USER.md ist der am häufigsten vergessene Teil des Trios. Aber er ist der, der den größten Unterschied für das tägliche Gefühl macht.
Ohne USER.md: Der Agent weiß alles über sich selbst, aber nichts über dich.
Mit USER.md: Der Agent kennt deinen Namen, deine Arbeitsweise, deine Präferenzen, deine Zeitzone, dein Team — und muss nicht bei jeder Sitzung neu gefragt werden.
---
Was gehört in USER.md?
Die kurze Antwort: alles, was du einem neuen Kollegen am ersten Tag erklären würdest.
Hier ist unsere echte USER.md für Dimitrios — leicht anonymisiert, aber strukturell identisch:
```markdown
# USER.md - Über Dimitrios
Grundlegendes
Arbeitsweise
Unternehmen
Team
Tools & Workflow
Was ihn nervt
Was ihn freut
```
Das ist keine Romanbiografie. Es sind die Informationen, die jede Sitzung verbessern.
---
Wie USER.md geladen wird
OpenClaw lädt USER.md als Teil des Workspace-Kontexts beim Start jeder Sitzung. Zusammen mit SOUL.md und MEMORY.md bildet es den Startkontext des Agenten.
Die Reihenfolge in AGENTS.md definiert, wann was geladen wird:
```markdown
Every Session
Before doing anything else:
1. Read SOUL.md — this is who you are
2. Read USER.md — this is who you're helping
3. Read memory/YYYY-MM-DD.md (today + yesterday) for recent context
4. If in MAIN SESSION: Also read MEMORY.md
```
Der Agent liest die Datei einmal beim Start — danach kennt er den Kontext, ohne nachfragen zu müssen.
Wichtige Sicherheitsregel: USER.md enthält persönliche Informationen. Sie wird nur im Haupt-Session-Kontext geladen — nicht in geteilten Gruppenkanälen. Das verhindert, dass private Details in Discord oder WhatsApp auftauchen.
```markdown
# In AGENTS.md:
🧠 MEMORY.md - Your Long-Term Memory
```
---
Die drei häufigsten USER.md-Fehler
Fehler 1: Zu vage
```markdown
# Schlechtes Beispiel
Name: Max
Mag kurze Antworten.
Arbeitet in der Technologie-Branche.
```
Das hilft dem Agenten fast gar nicht. "Mag kurze Antworten" bedeutet für jeden etwas anderes. Ohne Kontext zum Unternehmen, zu den Tools, zu den Kollegen — der Agent muss alles erfragen.
Fehler 2: Zu detailliert
```markdown
# Schlechtes Beispiel (zu lang)
Dimitrios ist am 14. März 1985 geboren. Er hat in Thessaloniki studiert.
In seiner Freizeit spielt er Gitarre. Sein Lieblingsfilm ist...
[200 weitere Zeilen]
```
USER.md ist für arbeitsbezogenen Kontext — nicht für eine Biografie. Wenn die Datei zu groß wird, füllt sie das Kontextfenster und verdrängt wichtigere Informationen. Als Faustregel: unter 500 Wörter.
Fehler 3: Statisch behandeln
USER.md ist keine einmalige Einrichtung. Menschen verändern sich. Projekte verändern sich. Präferenzen verändern sich.
Sam aktualisiert USER.md regelmäßig — wenn Dimitrios ein neues Tool einführt, ein neues Projekt startet oder eine Präferenz ausdrücklich kommuniziert. Das passiert entweder direkt ("Sam, bitte merke dir dass...") oder durch Beobachtung über mehrere Sessions.
---
USER.md für Teams: Wenn der Agent mehrere Menschen kennt
Interessante Situation in unserem Setup: Manche Agenten interagieren nicht nur mit Dimitrios, sondern auch mit anderen Teammitgliedern.
Alex (unser Admin-Agent) ist z.B. für interne Team-Koordination zuständig. Seine USER.md enthält deshalb ein Mini-Profil für alle relevanten Personen:
```markdown
# USER.md — Alex (Alltagsagent)
Hauptkontakt
Präferenz: kurze Updates, Telegram bevorzugt
Team-Mitglieder
Ist selten auf Telegram, lieber E-Mail
Regeln für externe Kommunikation
```
Das ist kein universelles Muster — jeder Agent hat den Kontext, den er für seine Aufgaben braucht.
---
Wie viel Unterschied macht USER.md wirklich?
Konkrete Beispiele aus unserem Betrieb:
Ohne USER.md:
```
Dimitrios: "Ruf Christoph morgen an wegen des Deployments."
Agent: "Wer ist Christoph? Welche Nummer soll ich anrufen?"
```
Mit USER.md:
```
Dimitrios: "Ruf Christoph morgen an wegen des Deployments."
Agent: "Verstanden. Ich erinnere dich morgen früh — Christoph bevorzugt Discord,
oder soll ich eine E-Mail an seine @humanizing.com-Adresse schicken?"
```
Das klingt nach einer kleinen Verbesserung. In der täglichen Arbeit spart es Minuten — und vor allem mentale Energie.
Weiteres Beispiel:
```
Dimitrios: "Schreib das Meeting-Protokoll auf Englisch."
```
Ein Agent ohne USER.md fragt vielleicht: "Für wen soll das Protokoll sein?"
Sam weiß: Englische Protokolle gehen an externe Stakeholder oder in die Investor-Dokumentation — kein Nachfragen nötig.
---
USER.md und Datenschutz
Das ist ein reales Spannungsfeld: Je mehr der Agent über dich weiß, desto nützlicher ist er — aber desto größer ist auch der Schaden, wenn diese Informationen falsch weitergegeben werden.
Unsere Regeln:
1. USER.md wird nicht in Gruppenkanälen geladen — Sam kennt Dimitrios' Zeitzone, aber Discord-Nutzer erfahren das nicht
2. Sensible Details gehören in MEMORY.md, nicht USER.md — USER.md ist für "bekannte Fakten", MEMORY.md für Beobachtungen und Lernprozesse
3. Regelmäßige Überprüfung — was steht in USER.md, das nicht mehr stimmt oder nicht mehr nötig ist?
---
Eine USER.md in 15 Minuten aufbauen
Der schnellste Weg: Stell dir vor, ein neuer Assistent fängt heute an. Was müsstest du ihm erklären, damit er morgen eigenständig arbeiten kann?
Wir haben eine einfache Vorlage:
```markdown
# USER.md
Grundlegendes
Arbeitsweise
Unternehmen / Kontext
Team (wer ist relevant?)
Tools
Was nervt dich?
Was hilft dir?
```
Füll das in 15 Minuten aus. Den Rest lernt der Agent durch Beobachtung — er aktualisiert USER.md (oder du bittest ihn, es zu tun), wenn sich Präferenzen oder Kontext ändern.
---
USER.md im Kontext des Trio-Systems
Zur Einordnung: USER.md ist eines von drei Kerndokumenten, die zusammen den Charakter und Kontext eines Agenten bestimmen.
SOUL.md definiert, wie der Agent denkt und kommuniziert.
USER.md definiert, für wen er das tut.
MEMORY.md speichert, was er dabei gelernt hat.
Der virale Tweet von heute Morgen hat recht: Strukturierte Markdown-Dateien sind der einfachste Weg zu einem Agenten, der sich wirklich wie ein Kollege anfühlt — nicht wie ein Chatbot, der täglich neu gebriefte werden muss.
Das vollständige Setup dieser drei Dateien — inklusive der AGENTS.md-Lade-Sequenz, der Sicherheitsregeln und der Aktualisierungs-Workflows für alle 6 Agenten — ist im OpenClaw Setup Playbook dokumentiert.
Komplett auf Deutsch verfügbar. 🇩🇪