기본 개념

OpenClaw의 핵심 개념을 이해하고 시스템 아키텍처를 파악합니다.

핵심 개념

1. Gateway (게이트웨이)

Gateway는 OpenClaw의 중심 서버입니다:

• 사용자 메시지를 수신하고 AI에게 전달
• AI 응답을 채널로 전송
• 스킬과 메모리를 관리

# Gateway 제어
openclaw gateway start    # 시작
openclaw gateway stop     # 중지
openclaw gateway status   # 상태 확인
openclaw gateway restart  # 재시작

2. Session (세션)

Session은 하나의 대화 단위입니다:

• 사용자와 AI 간의 메시지 교환 추적
• 대화 컨텍스트 유지
• 새로운 대화 시작 시 자동 생성

# 세션 설정 예시
sessions:
  maxHistory: 50    # 최대 메시지 수
  timeout: 3600     # 세션 타임아웃 (1시간)

3. Agent (에이전트)

Agent는 AI 모델 기반의 지능형 어시스턴트입니다:

• Claude, GPT 등 다양한 AI 모델 지원
• 스킬을 통해 기능 확장
• 맥락을 이해하고 적절한 응답 생성

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "temperature": 0.7
    }
  }
}

4. Channel (채널)

Channel은 사용자와 소통하는 통로입니다:

5. Workspace (워크스페이스)

Workspace는 작업 파일 저장소입니다:

• 기본 위치: ~/.openclaw/workspace/
• 파일 생성, 읽기, 저장 가능
• 세션 간 파일 공유 가능

시스템 아키텍처

사용자 (Telegram/Slack/Discord)
         ↓
    채널 (Channel)
         ↓
    Gateway (게이트웨이)
    ├── 세션 관리 (Sessions)
    ├── 에이전트 (Agent)
    │   ├── AI 모델 (Claude/GPT)
    │   └── 스킬 (Skills)
    └── 워크스페이스 (Workspace)

용어 정리

Gateway vs Channel vs Agent

Session vs Memory

설정 파일 구조

OpenClaw 설정은 ~/.openclaw/openclaw.json에 저장됩니다:

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "temperature": 0.7
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "slack": {
      "enabled": false,
      "botToken": "xoxb-..."
    }
  },
  "sessions": {
    "maxHistory": 50,
    "timeout": 3600
  },
  "workspace": {
    "path": "~/.openclaw/workspace"
  }
}

메시지 흐름

사용자가 메시지를 보낼 때 처리 과정:

1. 사용자: Telegram으로 메시지 전송
   ↓
2. Channel: 메시지 수신, 형식 변환
   ↓
3. Gateway: 세션 조회/생성
   ↓
4. Agent: 메시지 처리
   ├── 메모리에서 컨텍스트 검색
   ├── 스킬 실행 (필요한 경우)
   └── AI 모델에 요청
   ↓
5. AI 모델: 응답 생성
   ↓
6. Channel: 응답을 사용자에게 전송

다음 단계:

• 첫 메시지 - 실제로 메시지 보내기
• 채널 개요 - 채널 설정