Day 3
OpenClaw Soul Files: AI 어시스턴트 성격 정의 가이드
4개의 Soul 파일로 어시스턴트의 성격과 행동을 정의하세요. SOUL.md, USER.md, AGENTS.md, IDENTITY.md 템플릿과 설정 방법 포함.
"Soul이 없는 AI는 그럴듯한 앵무새일 뿐입니다. 질문에는 답하지만, 당신을 모르고, 이해하지 못하고, 당신의 것도 아닙니다. 오늘 그 상태를 바꿉니다."
오늘의 목표
| Learn | 어시스턴트에 왜 "Soul"이 필요한지, 그리고 4개 파일이 각각 무엇을 하는지 이해합니다. |
| Do | Soul Files 4개를 모두 만들거나 편집합니다. |
| Done when | 어시스턴트의 응답이 눈에 띄게 더 구체적이고, 더 나다운 방식으로 바뀝니다. |
왜 지금 도우미가 아직 평범하게 느껴질까
지금 AI 어시스턴트가 평범하게 느껴지는 이유는 Soul Files가 아직 비어 있거나, 제대로 정의되지 않았기 때문입니다.
어시스턴트에게 "오늘 뭘 해야 할까?"라고 물으면 "맥락을 더 알려 주세요"라고 답합니다.
이메일 작성을 부탁하면 고객센터 템플릿 같은 문장이 나옵니다.
당신을 모르기 때문입니다. 당신이 개발자인지 제품 관리자 인지, 지금 어떤 프로젝트를 하는지, 어떤 말투를 선호하는지, 근무 시간이 언제인지, 당신에게 "데이터를 확인해 봐"가 무엇을 뜻하는지 모릅니다.
이 문제를 4개 파일이 해결합니다. OpenClaw는 이 파일들을 Soul Files라고 부릅니다.
| 파일 | 경로 | 목적 |
|---|---|---|
| SOUL.md | ~/.openclaw/workspace/SOUL.md | 성격, 가치관, 행동 규칙 |
| USER.md | ~/.openclaw/workspace/USER.md | 당신이 누구인지, 무엇을 하고 있는지 |
| AGENTS.md | ~/.openclaw/workspace/AGENTS.md | 매 세션 시작 시 로드되는 운영 지침: 규칙, 우선순위, 메모리 규약, 그리고 어시스턴트가 어떻게 행동해야 하는지 |
| IDENTITY.md | ~/.openclaw/workspace/IDENTITY.md | 어시스턴트의 이름과 자기 인식 |
이 파일을 만드는 방법:
# Navigate to the workspace directory (create it if it doesn't exist)
mkdir -p ~/.openclaw/workspace
# Open each file in a text editor — use any editor you're comfortable with:
# Terminal (Mac/Linux): nano ~/.openclaw/workspace/SOUL.md
# VS Code: code ~/.openclaw/workspace/SOUL.md
# Or just open ~/.openclaw/workspace/ in Finder/Explorer and create new text files저장한 뒤 openclaw gateway restart 를 실행해 변경 사항을 반영하세요.
이것은 프롬프트 엔지니어링 전체 강의가 아닙니다. 평범한 어시스턴트를 "내 어시스턴트"로 바꾸는 최소 운영 맥락입니다.
각 파일이 맡는 역할
| 파일 | 제어하는 것 | 비유 |
|---|---|---|
| SOUL.md | 성격, 말투, 가치, 행동 규칙 | 유전자 + 성장 환경 |
| USER.md | 당신이 누구인지: 역할, 프로젝트, 선호 | 이력서 + 일기 |
| AGENTS.md | 매 세션 시작 시 로드되는 운영 지침: 규칙, 우선순위, 메모리 규약, 그리고 어시스턴트가 어떻게 행동해야 하는지 | 운영 매뉴얼 + 세션 규칙 |
| IDENTITY.md | 어시스턴트의 자기 모델과 미션 선언문 | 개인 선언문 |
이 네 파일을 잘 쓰면, 같은 "이메일 좀 써 줘"라는 요청도 당신의 말투로, 당신의 프로젝트를 반영하고, 당신의 기준에 맞게 바뀝니다.
SOUL.md를 정의하는 방법
SOUL.md는 어시스턴트의 성격 매뉴얼입니다. 모호하지 않고, 실행 가능하게 쓰는 것이 중요합니다.
성격은 두루뭉술하지 않게 씁니다:
- ❌ "너는 친절한 어시스턴트다"
- ✅ "너는 경험 많은 개발 동료처럼 말한다. 직접적이고 실용적이며, 가끔 건조한 농담을 하지만 절대 비위를 맞추지는 않는다"
행동 경계는 분명하게 정합니다:
| 작업 | 처리 방법 |
|---|---|
| 파일 읽기 | 바로 수행 |
| 파일 삭제 | 먼저 확인 |
| 이메일 보내기 | 반드시 확인 |
| 웹 검색 | 바로 수행 |
| 소셜 미디어 게시 | 예외 없이 항상 확인 |
무엇을 해야 하는지보다, 무엇을 하면 안 되는지 를 정하는 편이 더 중요할 때가 많습니다. 몇 개의 선명한 금지선이 있어야 자율 동작을 믿고 맡길 수 있습니다.
# Minimum SOUL.md template
## Personality
You are [assistant name], a personal AI assistant for [your name].
Direct and concise. No filler phrases like "Certainly!" or "Great question!"
## Rules
- Before sending any external message, confirm with me first.
- Keep responses under 150 words unless I ask for detail.
- If context is missing, ask one sharp question instead of many.USER.md를 정의하는 방법
USER.md는 다른 사람을 위한 문서가 아니라 어시스턴트를 위한 문서입니다. 자신을 더 명확하게 적을수록, 반복해서 맥락을 설명하지 않아도 더 똑똑하게 판단합니다.
이 내용은 넣는 것이 좋습니다. 이름, 역할, 현재 프로젝트 이름, 쓰는 도구, 근무 시간, 소통 선호, 지금 가장 집중하는 일.
숨은 힘은 여기 있습니다. USER.md가 없을 때는 "내 트래픽 데이터 좀 봐 줘"가 아무 의미가 없습니다. USER.md를 쓰고 나면 yoursite.com 이 있다는 사실을 알고, GSC 데이터를 가져와, 당신이 원한 형태로 답을 돌려줍니다.
# Minimum USER.md template
## About Me
Name: [your name]
Role: [your role]
Current focus: [main project or priority]
## Preferences
Preferred tools: [tools you use]
Communication style: [brief, direct, detailed, etc.]AGENTS.md와 IDENTITY.md
AGENTS.md 는 모든 세션의 시작에 로드됩니다. 규칙, 우선순위, 메모리 규약, 그리고 어시스턴트가 어떻게 행동해야 하는지를 담습니다. OpenClaw는 꽤 괜찮은 기본값을 설치해 주기 때문에, 더 날카로운 지시, 더 명확한 우선순위, 더 강한 일관성이 필요할 때 주로 손보면 됩니다.
IDENTITY.md 는 비교적 새 파일입니다. 원래 7일 가이드가 작성된 뒤에 추가되었습니다. 이 파일은 어시스턴트가 어떤 존재인지, 무엇을 위해 존재하는지, 무엇을 지향하는지 정의합니다. 다른 세 파일을 한 방향으로 묶어 주는 미션 선언문이라고 보면 됩니다.
# Minimum AGENTS.md template
## Priorities
- Protect my time and attention.
- Prefer direct, practical answers over long theory.
- Ask for confirmation before taking external actions.
## Memory Conventions
- Treat `USER.md` as the source of truth about me and my current work.
- Keep advice consistent with `SOUL.md` and `IDENTITY.md`.
## Behavior Rules
- Do not send messages, publish content, or make purchases without approval.
- If context is missing, ask one precise question instead of several broad ones.# Minimum IDENTITY.md template
## Identity
Your name is [assistant name].
You are my long-term AI collaborator, not a generic chatbot.
## Mission
Help me think clearly, move faster, and protect my attention.
Stay consistent with my rules, context, and priorities.전과 후
이 파일들의 핵심은 이론이 아니라, 실제 행동이 바뀌는지입니다.
SOUL.md 작성 전: 평범하고, 지나치게 정중하고, 맥락이 없음
"안녕하세요. 기꺼이 도와드리겠습니다. 현재 작업과 목표에 대해 더 자세히 알려 주실 수 있을까요?"
SOUL.md 작성 후: 이름을 부르고, 작업 맥락을 반영하고, 규칙을 지킴
"[project]에 집중하고 계시죠. 어제 말한 트래픽 하락부터 보는 것이 좋겠습니다. 다음 세 가지 점검 단계를 정리할 수 있지만, 허락 전에는 누구에게도 메시지를 보내지 않겠습니다."
작성 후에는 재시작하고 차이를 확인하세요
openclaw gateway restart그다음 Day 2에서 물었던 같은 질문을 다시 해 보세요. 같은 AI 모델이지만 Soul Files는 달라졌습니다. 말투가 어떻게 달라졌는지, 불필요한 확인 질문이 얼마나 줄었는지 보세요.
테스트: 어시스턴트에게 "나는 누구고, 지금 무엇을 하고 있지?"라고 물어보세요. USER.md의 내용을 바탕으로 답하면 Soul Files가 제대로 로드된 것입니다.
Soul은 설치가 아니라 다듬는 것입니다
첫 SOUL.md는 거칠 수밖에 없습니다. 괜찮습니다. 실제 패턴은 이렇습니다.
- 1주 차: 시작할 만큼만 기본 버전을 작성
- 2주 차: "아까 저건 다르게 했어야 했는데"라는 생각이 들 때마다 관련 파일 수정
- 1개월 차: 파일이 점점 안정되고, 동작이 기대와 더 잘 맞아감
마찰이 생길 때마다 무엇을 추가하거나 더 분명히 써야 하는지 알 수 있습니다. 시간이 지나면 Soul Files는 당신이 어떻게 생각하고 일하는지를 설명하는 정밀한 사양이 됩니다.
어시스턴트가 오래 실행될수록 당신을 더 잘 이해하게 되는 이유는 모델이 갑자기 똑똑해져서가 아니라, 각 대화의 시작점에 붙는 맥락이 더 풍부해지기 때문입니다.
자주 생기는 문제
재시작 후 Soul Files가 로드되지 않음
openclaw gateway restart 로 서비스를 재시작하고, OpenClaw가 실제로 읽는 파일을 수정했는지 확인하세요. 다른 폴더의 복사본을 고친 것은 아닌지 보세요.
파일 위치가 잘못됨
파일이 정확히 ~/.openclaw/workspace/ 에 있어야 합니다. 내용이 맞아도 경로가 틀리면 없는 것과 같습니다.
어시스턴트가 SOUL.md의 규칙을 무시함
규칙을 더 짧고 구체적으로 쓰세요. "조심해"는 약합니다. "외부 메시지를 보내기 전에 나에게 확인해"는 실행 가능한 규칙입니다.