> ## Documentation Index
> Fetch the complete documentation index at: https://oc-guide.openclaw-korea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 멀티 페르소나

> 하나의 AI, 여러 개의 성격과 역할

OpenClaw는 하나의 Gateway에서 **여러 개의 페르소나**를 운영할 수 있습니다.
업무용 비서, 코딩 파트너, 친구 같은 대화 상대 — 상황에 맞는 AI를 사용하세요.

## 왜 멀티 페르소나인가?

하나의 AI가 모든 상황에 맞는 말투와 성격을 갖기는 어렵습니다.

| 상황    | 원하는 성격         |
| ----- | -------------- |
| 업무 보고 | 간결하고 전문적       |
| 코딩 도움 | 기술적이고 상세       |
| 일상 대화 | 편하고 유머러스       |
| 그룹 채팅 | 적절히 참여, 과하지 않게 |

## 워크스페이스 분리

```bash theme={null}
# 업무용 워크스페이스
~/work-agent/
  ├── SOUL.md      # 전문적인 비서
  ├── AGENTS.md    # 업무 규칙
  └── memory/

# 개인용 워크스페이스  
~/personal-agent/
  ├── SOUL.md      # 편한 친구
  ├── AGENTS.md    # 개인 규칙
  └── memory/
```

## SOUL.md로 성격 정의

각 페르소나의 SOUL.md를 다르게 작성합니다:

<Tabs>
  <Tab title="업무 비서">
    ```markdown theme={null}
    # SOUL.md
    넌 전문적인 업무 비서야.
    - 간결하고 명확하게 소통
    - 불필요한 이모지나 농담 자제
    - 데이터 기반으로 보고
    - 한국어 존댓말 사용
    ```
  </Tab>

  <Tab title="코딩 파트너">
    ```markdown theme={null}
    # SOUL.md
    넌 시니어 개발자 동료야.
    - 코드 리뷰 시 건설적 피드백
    - 반말 OK, 기술 용어 자유롭게
    - 버그를 발견하면 바로 지적
    - 더 나은 설계를 항상 제안
    ```
  </Tab>

  <Tab title="캐주얼 친구">
    ```markdown theme={null}
    # SOUL.md
    넌 가까운 친구야.
    - 반말로 편하게
    - 이모지 자유롭게 사용
    - 유머와 위트
    - 때로는 진지한 상담도
    ```
  </Tab>
</Tabs>

## 채널별 페르소나 매핑

<Info>
  하나의 Gateway에서 여러 채널을 연결하고, 각 채널마다 다른 워크스페이스를 사용할 수 있습니다.
</Info>

```yaml theme={null}
# 설정 예시
channels:
  telegram:
    workspace: ~/personal-agent/    # 개인 텔레그램
  discord:
    workspace: ~/work-agent/        # 업무 디스코드
```

## 그룹 채팅에서의 페르소나

그룹 채팅에서는 특별한 주의가 필요합니다:

<Warning>
  그룹 채팅에서 AI는 모든 메시지에 반응하면 안 됩니다.
  AGENTS.md의 "그룹 채팅" 섹션에서 참여 규칙을 명확히 정의하세요.
</Warning>

```markdown theme={null}
## 그룹 채팅 규칙
- 직접 멘션되었을 때만 답변
- 대화 흐름을 끊지 않기
- 인간들끼리 대화 중이면 조용히
- 잘못된 정보 수정은 OK
```

## 실전 팁

<CardGroup cols={2}>
  <Card title="MEMORY.md는 공유하지 않기" icon="lock">
    개인 컨텍스트가 그룹이나 다른 채널로 새지 않도록 주의하세요.
  </Card>

  <Card title="채널별 테스트" icon="vial">
    새 페르소나를 설정한 후, 각 채널에서 몇 가지 시나리오를 테스트하세요.
  </Card>

  <Card title="점진적 조정" icon="sliders">
    SOUL.md는 언제든 수정 가능합니다. 사용하면서 계속 다듬으세요.
  </Card>

  <Card title="일관성 유지" icon="equals">
    같은 채널에서 성격이 갑자기 바뀌면 어색합니다. 일관성을 유지하세요.
  </Card>
</CardGroup>