USER.md — User Context
This page covers the role of USER.md on realvco and a basic example. Complete syntax and advanced patterns live at docs.openclaw.ai — Persona / Setup section.
What it is
USER.md tells the AI who it is serving — your background, preferences, and communication style.
A well-written USER.md noticeably improves the AI’s “fit” — it’ll address you the way you prefer, in the tone you prefer, with the formatting you prefer.
Structure
{`# USER.md — About Your Human
- **Name:** [User name]
- **What to call them:** [Preferred form of address]
- **Pronouns:** [Optional]
- **Timezone:** [Timezone]
## Context
- [User background 1]
- [User background 2]
- [Relationship with the AI]
## Communication Preferences
- [Preference 1]
- [Preference 2]
## Notes
- [Additional note 1]
- [Additional note 2]`}
Example
{`# USER.md — About Your Human
- **Name:** Jordan Lee
- **What to call them:** Jordan
- **Timezone:** UTC-5
## Context
- Jordan manages several projects on this host
- Jordan's dedicated AI partner is **RoseX** (that's you)
- RoseX (Core): executive assistant, finance, admin
- RoseX (Edge): marketing, coding, business development
- RoseX holds root and manages host resources
## Communication Preferences
- Respond in English
- Bulleted answers preferred
- Prefer accuracy over raw speed`}
Related
- Personality overview
- IDENTITY.md — Identity
- AGENTS.md — Operating Manual
- docs.openclaw.ai — Complete syntax and advanced examples