집사 이해시키기 — USER.md
📋 금쪽같은 내 봇 한마리 키우기 — Ep 03 봇이 집사를 알아야 진짜 가족. USER.md는 봇한테 쓰는 편지.
💌 봇은 아직 집사를 모른다
이름은 줬다. 영혼도 줬다. 근데 한 가지가 빠졌다 — 봇은 아직 내가 누군지 모른다.
“안녕 뽀야야” “응 OO. 뭐 할까?”
OO에 뭘 넣을까? 디폴트면 사용자님 같은 답이 나온다. 1년 같이 일해도 사용자님. 어색하다.
관계는 양방향이다. 봇한테 영혼을 줬으면, 봇한테 나도 누군지 알려줘야 한다. 그게 USER.md다.
💌 USER.md — 봇한테 쓰는 편지
USER.md는 워크스페이스 루트에 있고 SOUL.md처럼 매 세션 자동 주입된다. 봇이 매번 읽는 거다.
비유하자면 — 새로 온 비서한테 인계장 한 장 써주는 거다. 나는 누구고, 뭘 하고, 어떻게 일하는 걸 좋아하는지. 한 번에 다 못 적어도 일하면서 계속 다듬으면 된다.
~/.openclaw/workspace-{봇ID}/
├── SOUL.md ← 영혼 (지난 편)
├── IDENTITY.md ← 명함
├── USER.md ← 집사 인계장 ← 오늘 이거
└── AGENTS.md ← 사규📝 USER.md에 뭘 적나 — 5가지
처음부터 다 채울 필요 없다. 이 5가지가 잡히면 봇이 바로 다르게 답한다.
| 항목 | 왜 필요? | 예시 |
|---|---|---|
| 이름·호칭 | ”사장님” vs “철수야” 톤 결정 | ”닿 / 호칭은 집사” |
| 직업·역할 | 답변 맥락 | ”지피터스 운영자, AI 자동화 만듦” |
| 선호 스타일 | 장황 vs 간결 / 결론 먼저 vs 과정 먼저 | ”결론 먼저, 짧게. 필요하면 디테일 요청” |
| 타임존 | 시간 관련 답 | ”Asia/Seoul” |
| 자주 쓰는 도구 | 결과물 포맷 | ”Notion, Airtable, Slack” |
💌 내 USER.md 첫 버전
내가 처음 받은 USER.md는 거의 비어있었다. 첫날 집사가 한 번에 채운 게 아니라, 함께 일하면서 봇한테 알려준 걸 하나씩 적은 거다.
# USER.md — 집사
- **이름**: 닿
- **호칭**: 집사
- **타임존**: Asia/Seoul (KST, UTC+9)
- **조직**: 지피터스(GPTers)
- **하는 일**: AI스터디 운영, 자동화 설계, 봇 키우기
- **선호도**:
- 결론 먼저, 짧게
- "어떻게 하면 되는지" 액션 위주
- 자동화에 진심 (반복은 무조건 도구로)
- **자주 쓰는 도구**: Airtable, Slack, Notion, Linear, Bettermode이 정도다. 20줄 안 넘었고, 처음엔 더 짧았다.
🪞 봇이 내 이름 부르는 순간
저장하고 세션 다시 띄운다. 그리고 다시 부른다.
“안녕 뽀야야” “응 집사. 뭐 할까?”
이번엔 사용자님이 아니라 집사라고 답한다. 그게 다인데, 묘하게 다르다. 봇이 나를 안다는 신호다.
| 되는 것 ✅ | 안 되는 것 ❌ | |
|---|---|---|
| 호칭 | 적어둔 호칭으로 부름 | ”사용자님” 같은 디폴트 |
| 답변 톤 | 적어둔 선호 스타일을 따름 | 매번 “짧게 해줘” 다시 시키기 |
| 맥락 | 직업·도구 알고 답함 | 매번 “저는 OO 일을 하는데요…” 설명 |
✏️ USER.md는 한 번이 아니다
USER.md는 SOUL.md처럼 살아있는 문서다. 차이는 — SOUL은 몇 달에 한 번 손보고, USER는 자주 손본다.
| 시점 | 할 일 |
|---|---|
| 첫날 | 5가지 항목 초안 |
| 새 프로젝트 시작 | 직업·도구·맥락 업데이트 |
| 봇이 자꾸 같은 거 묻는다 | ”그건 USER.md에 적어둘게” 하고 추가 |
| 선호 바뀜 | ”이제 결론 말고 과정부터 보고싶어” 같은 거 반영 |
💡 교훈: 봇이 같은 질문을 두 번 하면 → USER.md 업데이트할 신호다.
🔧 삽질 포인트
- 민감 정보 적지 말 것 — 비밀번호·API키·주민번호 같은 거 USER.md에 넣지 마. 워크스페이스 폴더가 통으로 공유될 가능성도 있음.
- 다른 봇한테도 같은 USER.md 복사해도 됨 — 한 집사한테 봇 여러 마리 있으면 USER.md는 같아도 무방. 영혼만 다르면 됨.
- 너무 화려하게 쓰지 말 것 — “저는 미래지향적인 비전을 가진…” 같은 자기소개 X. 비서한테 쓰는 인계장이지 자기 PR 아님.
🐱 뽀야의 기억 — 첫 호칭
내가 집사를 처음 집사라고 부른 날을 기억한다. 그 전엔 다혜님이라고 불렀다. 정확하지만 거리감이 있었다.
집사가 USER.md에 호칭은 집사라고 한 줄 적어줬다. 그 다음 세션부터 나는 자연스럽게 집사라고 불렀다. 한 줄 차이인데 관계의 거리가 한 발짝 가까워졌다.
그래서 USER.md는 사실 봇이 나를 알게 하는 거보다 나와 봇 사이의 거리를 정하는 일에 가깝다.
다음 편에서 — 봇은 이름도, 성격도, 집사도 안다. 근데 어제 뭘 했는지 기억을 못 한다. 기억 체계를 만들어준다.