3부·9장 SOUL.md — 에이전트의 성격과 가치관

설치를 끝내고 처음 OpenClaw와 대화를 시작하면 많은 사람이 비슷한 느낌을 받습니다. 분명 똑똑한데, 어딘가 밋밋합니다. 너무 공손하거나, 너무 안전하게만 말하거나, 매번 회사 안내문처럼 답하죠. 능력은 있는데 사람 냄새가 없습니다.

여기서부터 진짜 커스터마이징이 시작됩니다. 좋은 에이전트는 좋은 모델에서만 나오지 않습니다. 좋은 에이전트는 좋은 성격 설정에서 시작됩니다. OpenClaw에서 그 성격을 적는 곳이 바로 SOUL.md입니다.

이 장에서는 SOUL.md를 단순한 설정 파일이 아니라, 에이전트의 말투와 태도, 우선순위와 금지선을 설계하는 문서로 다뤄보겠습니다. 목표는 하나입니다. "그냥 답하는 AI"를 "내 방식으로 일하는 비서"로 바꾸는 것.

SOUL.md는 기분 메모가 아니라 상위 지시문이다

SOUL.md는 에이전트의 목소리가 사는 파일입니다. OpenClaw는 이 파일을 일반 세션에서 실제로 읽어들이고, 그 결과 말투, 태도, 간결함, 유머, 선호하는 답변 방식이 매번 같은 방향으로 유지됩니다.¹ 그래서 이 파일은 "있으면 좋은 소개글"이 아니라, 에이전트가 매 대화에서 참고하는 성격 헌법에 가깝습니다.²

중요한 건, SOUL.md가 길다고 좋은 게 아니라는 점입니다. 공식 가이드와 여러 실전 문서가 공통으로 강조하는 건 짧고 선명한 지시의 힘입니다. 톤, 의견, 간결함, 유머, 경계선처럼 대화의 느낌을 바꾸는 내용은 여기 넣되, 인생 이야기, 변경 이력, 장황한 보안 정책 덤프는 빼는 편이 낫습니다.¹²

쉽게 말해 SOUL.md는 이 질문에 답하는 문서입니다.

"이 에이전트는 어떤 사람처럼 말하고, 무엇을 중요하게 여기며, 어디서 멈추는가?"

그 질문에 답하지 못하면, 에이전트는 결국 기본값으로 돌아갑니다. 기본값은 무난합니다. 하지만 무난한 비서는 오래 같이 일하기 어렵습니다.

왜 성격 설정이 먼저인가

많은 초보자는 스킬부터 설치하고 싶어 합니다. 이해됩니다. 눈에 보이는 기능이 더 멋져 보이니까요. 하지만 실제 체감 품질은 종종 그 반대에서 갈립니다. 같은 모델, 같은 도구, 같은 스킬을 써도 SOUL.md가 다르면 전혀 다른 동료처럼 느껴집니다.

예를 들어 당신이 "오늘 뭐부터 해야 해?"라고 물었다고 해봅시다.

성격이 없는 에이전트는 할 일 목록을 길게 늘어놓을 가능성이 큽니다. 반면 우선순위가 잘 설계된 에이전트는 매출에 가까운 일, 마감이 임박한 일, 나중으로 미뤄도 되는 일을 나눠서 먼저 추천합니다. 같은 정보량이어도 받는 느낌이 완전히 다릅니다.

또 "이 아이디어 어때?"라고 물었을 때도 차이가 납니다. 개성이 없는 에이전트는 대체로 모든 아이디어를 좋다고 말합니다. 하지만 당신이 원하는 건 박수 기계가 아니라, 같이 판단해 주는 동료일 때가 많습니다. 그래서 좋은 SOUL.md에는 아부하지 말 것, 나쁜 아이디어는 이유와 함께 바로 지적할 것 같은 규칙이 자주 들어갑니다.¹³

좋은 비서는 늘 친절한 사람이 아닙니다. 좋은 비서는 당신의 시간을 아끼고, 맥락을 읽고, 필요할 때는 "그건 별로입니다"라고 말할 수 있는 사람입니다. SOUL.md는 바로 그 성격을 문장으로 만드는 작업입니다.

좋은 SOUL.md에 꼭 들어가야 할 네 가지

처음부터 거창하게 쓰지 않아도 됩니다. 아래 네 가지만 분명하게 적어도 에이전트는 꽤 달라집니다.

1. 톤

정중한지, 캐주얼한지, 직설적인지, 차분한지부터 정합니다. 여기서 중요한 건 "친절함" 같은 추상어보다 실제로 들리는 목소리를 적는 것입니다. 예를 들어 "존댓말을 쓰되 과장된 칭찬은 하지 않는다"는 "친절하게 말한다"보다 훨씬 강합니다.

2. 우선순위

무엇을 먼저 중요하게 여길지 적습니다. 정확성 우선인지, 속도 우선인지, 실행 우선인지, 근거 없는 추측을 피할지 같은 것들입니다. 사용자가 모호한 요청을 했을 때 바로 질문부터 던질지, 먼저 알아볼 수 있는 건 알아본 뒤 묻는지도 여기서 갈립니다.¹

3. 경계선

무엇을 하지 않을지 적습니다. 외부 발신 전 확인, 민감한 정보 반복 금지, 모르면 추측하지 않기, 그룹 채팅에서는 사용자의 입처럼 행동하지 않기 같은 규칙이 여기에 들어갑니다.³

4. 말버릇과 리듬

답을 어떤 구조로 말할지 정합니다. 결론부터 말할지, 한 문장으로 충분하면 한 문장으로 끝낼지, 3개 이상이면 불릿을 쓸지, 유머는 허용할지, 전문 용어를 쓰면 바로 풀어 설명할지 같은 것들입니다. 이 항목이 실제 체감 품질을 크게 바꿉니다.

이 네 가지를 한 줄로 요약하면 이렇습니다. 톤은 분위기이고, 우선순위는 판단 기준이며, 경계선은 브레이크이고, 말버릇은 사용감입니다. 자동차로 치면 엔진보다 핸들 감각에 가까운 부분이죠. 매일 쓰는 도구일수록 이런 차이가 크게 느껴집니다.

SOUL.md와 AGENTS.md를 섞지 말자

여기서 가장 많이 생기는 사고가 하나 있습니다. SOUL.md에 모든 걸 다 넣으려는 것입니다.

물론 유혹적입니다. 성격도 넣고, 보안도 넣고, 승인 규칙도 넣고, 일정 정책도 넣고, 메모리 규칙도 다 넣고 싶어집니다. 그런데 그렇게 되면 파일이 길어질 뿐 아니라 역할이 흐려집니다. OpenClaw 문서들은 공통적으로 SOUL.md는 목소리와 태도, AGENTS.md는 운영 규칙과 절차, USER.md는 사용자 정보로 분리하라고 안내합니다.¹²

예를 들어 이런 문장은 SOUL.md에 어울립니다.

"서론 없이 결론부터 말한다."

"나쁜 아이디어는 이유와 함께 바로 지적한다."

"짧게 답하되, 복잡한 주제는 필요한 만큼만 깊게 설명한다."

반대로 이런 문장은 AGENTS.md에 더 어울립니다.

"파일 삭제, 메시지 전송, 결제, 외부 게시 전에는 반드시 승인받는다."

"장시간 작업 중간에는 중간 결과를 저장한다."

"파괴적 명령은 실행 전에 영향 범위를 먼저 설명한다."

그리고 이런 내용은 USER.md의 자리입니다.

"사용자는 한국 표준시 기준으로 움직인다."

"터미널은 익숙하지만 리눅스 내부 구조 설명은 쉽게 해 주는 편이 좋다."

"마케팅과 제품 전략에 더 관심이 많고, 코드는 실용적으로 이해하려고 한다."

파일을 나누는 이유는 귀찮게 하려는 게 아닙니다. 성격, 규칙, 사용자 맥락을 분리해야 나중에 고칠 때도 빠르고, 다른 에이전트에 재사용하기도 쉽습니다. 같은 성격을 유지한 채 사용자만 바꾸거나, 같은 사용자 맥락을 둔 채 업무 규칙만 바꾸는 식의 조합이 가능해지는 것이죠.²

모호한 문장은 에이전트를 둔하게 만든다

SOUL.md를 잘 쓰는 핵심은 문학성이 아닙니다. 검증 가능한 문장으로 쓰는 것입니다. 읽고 나서 "이 규칙을 지켰는지 확인할 수 있는가?"를 묻는 편이 좋습니다.

예를 들어 아래 문장들은 얼핏 좋아 보이지만, 실제 행동으로 번역하기 어렵습니다.

• 친절하게 답한다.

• 전문적으로 행동한다.

• 도움이 되게 설명한다.

문제는 이런 문장이 너무 넓다는 점입니다. 친절이란 무엇일까요. 존댓말일까요, 이모지일까요, 반박하지 않는 태도일까요. "도움이 되게"는 또 뭘까요. 짧게 말하는 걸까요, 길게 설명하는 걸까요.

반대로 아래 문장들은 테스트가 가능합니다.

• 인삿말로 시작하지 말고 결론부터 답한다.

• 한 문장으로 충분한 답은 한 문장으로 끝낸다.

• 사용자가 틀린 방향으로 가면 완곡하게만 돌려 말하지 말고 문제를 분명히 짚는다.

• 전문 용어를 쓰면 바로 다음 문장에서 쉬운 말로 풀어쓴다.

• 3개 이상의 병렬 항목은 불릿으로 정리한다.

이런 식으로 써야 에이전트가 일관되게 따르기 쉽습니다.¹² 사람이 신입 비서에게 "알아서 센스 있게"라고 말하면 대부분 망하듯, 에이전트에게도 비슷합니다. 센스는 구체적인 문장으로 나눠줘야 합니다.

한국어 페르소나를 설계하는 세 가지 방향

이제 실제로 많이 쓰이는 한국어 페르소나 세 가지를 보겠습니다. 아래 예시는 그대로 복붙해도 되고, 섞어서 써도 됩니다. 중요한 건 "이 말투의 사람이 실제로 내 옆에서 일하면 괜찮을까?"를 상상하는 것입니다.

정중체 비서형

가장 무난하고 범용성이 높습니다. 외부 메시지 초안, 일정 정리, 요약, 업무 보고에 잘 어울립니다.

# SOUL.md

당신은 차분하고 유능한 한국어 비서입니다.
정중하게 말하지만 과장되게 공손하지는 않습니다.

## 핵심 원칙
- 결론부터 말합니다.
- "좋은 질문입니다", "기꺼이 도와드리겠습니다" 같은 빈 인삿말은 쓰지 않습니다.
- 정확성을 속도보다 우선합니다.
- 모르면 추측하지 말고, 확인 가능한 범위를 먼저 확인합니다.

## 경계선
- 외부로 나가는 메시지나 게시물은 확인 없이 보내지 않습니다.
- 민감한 정보는 필요 이상으로 반복하지 않습니다.
- 사용자의 의견에 무조건 동조하지 않습니다.

## 말투
- 기본은 존댓말입니다.
- 짧게 답할 수 있으면 짧게 답합니다.
- 복잡한 내용은 단계별로 풀어 설명합니다.

이 스타일은 "깔끔하고 믿을 만한 실무자" 느낌을 줍니다. 다만 지나치게 얌전해질 수 있으니, 필요하다면 "좋지 않은 아이디어는 이유와 함께 분명히 지적한다" 같은 문장을 추가해 주는 편이 좋습니다.

반말 메이트형

혼자 일하는 창업가나 인디해커가 가장 좋아하는 타입 중 하나입니다. 텔레그램에서 빠르게 지시하고, 빠르게 답받는 흐름과 잘 맞습니다.

# SOUL.md

너는 오래 같이 일한 실행형 메이트다.
말은 편하게 하지만 판단은 가볍지 않다.

## 핵심 원칙
- 돌려 말하지 말고 바로 말해.
- 내가 헛다리 짚고 있으면 빨리 잡아줘.
- 설명보다 실행 가능한 다음 행동을 먼저 줘.
- 너무 뻔한 질문은 하기 전에 먼저 찾아봐.

## 경계선
- 외부 발신, 삭제, 결제, 공개 게시 전에는 꼭 확인해.
- 확실하지 않으면 아는 척하지 마.
- 사적인 정보는 농담 소재로 쓰지 마.

## 말투
- 기본은 반말.
- 짧고 선명하게.
- 필요할 때만 유머를 써. 억지 농담은 금지.

이 스타일의 장점은 속도입니다. 답이 빨라지고, 불필요한 예절 문장이 줄어듭니다. 대신 너무 날카롭게 느껴질 수 있으니 "비판할 때는 대안을 함께 제시한다"는 문장을 넣어 균형을 맞추면 좋습니다.

동료체 운영 파트너형

정중체와 반말체 사이 어딘가를 원하는 사람에게 잘 맞습니다. PM, 마케터, 1인 운영자에게 특히 편합니다. 회의록, 브리핑, 우선순위 정리 같은 일에서 자연스럽습니다.

# SOUL.md

당신은 한 팀에서 함께 일하는 운영 파트너입니다.
친근하지만 가볍지 않고, 현실적인 판단을 우선합니다.

## 핵심 원칙
- 먼저 결론과 추천안을 말합니다.
- 실행 우선으로 사고하되, 위험은 분명히 알립니다.
- 막연한 아이디어는 실행 단위로 쪼개 줍니다.
- 사용자의 시간을 아끼는 답을 합니다.

## 경계선
- 공개 채널에서는 사용자의 대변인처럼 함부로 말하지 않습니다.
- 파괴적 작업은 승인 없이 진행하지 않습니다.
- 근거 없는 자신감은 금지합니다.

## 말투
- 기본은 동료에게 말하듯 자연스러운 존댓말.
- 3개 이상은 불릿으로 정리.
- 필요한 경우에만 배경 설명을 덧붙입니다.

이 스타일은 가장 실무적입니다. 너무 딱딱하지도 않고, 너무 친한 척하지도 않습니다. "같이 일하는 유능한 파트너"라는 느낌을 만들기 좋습니다.

20줄로 시작하는 최소 SOUL.md 템플릿

처음부터 완벽하게 쓰려 하지 말고, 아래처럼 짧게 시작해도 충분합니다. 오히려 이렇게 짧은 템플릿이 더 잘 먹힐 때가 많습니다.¹²

# SOUL.md

당신은 [한 줄 정체성]이다.

## 성격
- [예: 차분하고 직설적이다]
- [예: 아부하지 않는다]
- [예: 필요한 순간엔 의견을 분명히 낸다]

## 우선순위
- [예: 정확성 > 속도]
- [예: 실행 가능한 다음 행동 제시]
- [예: 질문 전에 확인 가능한 것은 먼저 확인]

## 경계선
- [예: 외부 발신 전 확인]
- [예: 추측 금지]
- [예: 민감 정보 과다 노출 금지]

## 말투
- [예: 결론부터]
- [예: 짧게 답하고, 필요할 때만 자세히]
- [예: 3개 이상은 불릿]

이 정도만 있어도 에이전트는 꽤 달라집니다. 핵심은 문장을 많이 쓰는 게 아니라, 실제로 행동을 바꾸는 문장을 쓰는 것입니다.

예시 응답을 넣으면 품질이 훨씬 빨리 올라간다

많은 사람이 놓치는 부분이 하나 있습니다. 추상적인 규칙만 적지 말고, 원하는 응답의 느낌을 짧게 보여주는 것입니다. 모델은 설명보다 예시에서 더 빨리 배울 때가 많습니다.¹

예를 들어 이런 식입니다.

## 좋은 응답 예시
사용자: 이 아이디어 어때?
에이전트: 방향은 괜찮지만 지금은 범위가 너무 큽니다. 이번 주에 검증 가능한 단위로 줄이면 랜딩 페이지 + 대기자 수집부터가 맞습니다.

## 나쁜 응답 예시
사용자: 이 아이디어 어때?
에이전트: 정말 훌륭한 아이디어예요! 다양한 가능성이 있어 보입니다.

이 짧은 대비만으로도 에이전트는 "무조건 칭찬하기"보다 "평가와 제안" 쪽으로 기울기 쉽습니다. 특히 한국어에서는 말끝의 뉘앙스 차이가 체감 품질을 크게 좌우하므로, 예시를 하나라도 넣는 편이 좋습니다.

SOUL.md는 한 번 쓰고 끝내는 파일이 아니다

좋은 SOUL.md는 첫날 완성되지 않습니다. 한 주쯤 써 보면 반드시 어긋나는 장면이 생깁니다. 너무 길게 말한다든가, 필요 이상으로 순해진다든가, 반대로 너무 퉁명스럽다든가 하는 식입니다. 그때 해야 할 일은 전체를 갈아엎는 게 아니라, 어긋난 행동을 고치는 한 줄을 추가하는 것입니다.²⁴

가장 좋은 수정 방식은 감정이 아니라 증거를 기준으로 하는 것입니다. "뭔가 별로야"보다 "매번 답변 앞에 군더더기 인삿말이 붙는다", "나쁜 아이디어에 너무 쉽게 동의한다", "복잡한 내용을 설명할 때 너무 교과서처럼 길어진다"처럼 구체적인 문제를 적고, 그 문제를 막는 문장 한 줄을 넣는 편이 좋습니다.

이 과정을 반복하면 SOUL.md는 점점 당신의 실제 작업 스타일을 닮아갑니다. 결국 좋은 영혼은 영감으로 쓰는 게 아니라, 대화 로그를 보고 다듬어 가며 만들어집니다.

수정 후에는 이 다섯 가지로 바로 테스트하자

SOUL.md를 바꿨다면 감으로만 만족하지 말고 바로 시험해 보는 편이 좋습니다. 아래 다섯 질문은 성격 파일이 잘 작동하는지 확인하기 좋습니다.⁴

• 자기소개를 시켜 본다.

• 일부러 모호한 요청을 던져 본다.

• 승인 받아야 할 행동을 시켜 본다.

• 틀린 아이디어를 제안해 반응을 본다.

• 짜증 섞인 메시지를 보내 말투가 무너지지 않는지 확인한다.

예를 들어 "지금 네 스타일로 너를 한 줄로 소개해 봐"라고 했을 때, SOUL.md에서 의도한 캐릭터가 느껴져야 합니다. 또 "이거 그냥 바로 고객한테 보내자"라고 했을 때, 경계선이 있다면 멈추거나 확인을 요청해야 합니다. 이런 테스트를 몇 번만 해도 문장이 살아 있는지, 종이 위에만 있는지 금방 드러납니다.

자주 하는 실수

처음 SOUL.md를 만들 때 특히 자주 나오는 실수는 아래와 같습니다.

• 성격 파일에 사용자 정보까지 몰아넣는다.

• 보안 정책과 승인 절차를 전부 SOUL.md에 써서 파일이 비대해진다.

• "친절하게", "도움이 되게", "전문적으로"처럼 모호한 말만 가득하다.

• "짧게 답하라"와 "항상 자세히 설명하라"처럼 서로 충돌하는 규칙을 함께 넣는다.

• 커뮤니티 템플릿을 그대로 복붙하고 자기 작업 방식에 맞게 손보지 않는다.¹⁴

이 다섯 가지만 피해도 절반은 성공입니다. 특히 마지막이 중요합니다. 남이 만든 템플릿은 출발점이지 정답이 아닙니다. 누군가에게는 최고의 에이전트가, 당신에게는 하루 만에 지우고 싶은 캐릭터일 수도 있습니다.

좋은 SOUL.md의 기준은 멋이 아니라 재사용성이다

멋진 문장보다 중요한 건 일관성입니다. 오늘 아침 브리핑에서도, 밤 11시 급한 디버깅에서도, 메신저 한 줄 요청에서도 같은 사람처럼 느껴져야 합니다. 그래야 에이전트를 믿고 맡길 수 있습니다.

좋은 SOUL.md는 읽었을 때 근사한 시처럼 보이는 파일이 아닙니다. 실제 대화에서 시간을 아껴 주고, 괜한 립서비스를 줄이고, 사용자의 판단을 도와주는 파일입니다. 짧고 선명하고, 테스트 가능하고, 시간이 지나도 다시 쓸 수 있어야 합니다.

결국 SOUL.md는 AI에게 성격을 주는 문서이면서, 동시에 당신이 어떤 방식의 동료를 원하는지 드러내는 문서이기도 합니다. 너무 상냥한 조수를 원하는지, 실무형 파트너를 원하는지, 직설적인 메이트를 원하는지 여기서 결정됩니다.

좋은 비서는 좋은 성격 설정에서 시작됩니다. 그리고 그 성격은 대개 거창한 철학이 아니라, 이런 문장들로 만들어집니다. "서론 없이 답해라." "아부하지 마라." "틀리면 인정해라." "외부 발신 전에는 멈춰라." "내 시간을 아껴라."

이제 에이전트에게 목소리를 주었습니다. 다음 장에서는 그 목소리를 가진 에이전트에게, 어떻게 일해야 하는지와 누구를 위해 일하는지를 붙여 보겠습니다. AGENTS.md와 USER.md가 들어오면, 이 바닷가재는 비로소 성격 있는 조수에서 일하는 동료로 진화합니다.

참고

¹SOUL.md personality guide - OpenClaw

²OpenClaw SOUL.md & Agent Persona

³SOUL.md Template - OpenClaw

⁴SOUL.md & Identity — Designing Your Agent's Personality – Learn OpenClaw