용어 사전

OpenClaw 사용 중 자주 등장하는 용어를 정의합니다.

핵심 개념

Gateway (게이트웨이)

OpenClaw의 핵심 컴포넌트로, 사용자와 AI 에이전트 간의 통신을 중계하는 서버입니다.

• 역할: 메시지 수신, AI 모델 연결, 응답 전송
• 동작: 백그라운드에서 실행되며 지속적으로 대기를 수행
• 포트: 기본 포트는 3000

openclaw gateway start

Workspace (워크스페이스)

OpenClaw가 작업하는 디렉터리로, 모든 설정, 로그, 데이터가 저장됩니다.

• 기본 위치: ~/.openclaw/workspace
• 구성: 설정 파일, 로그, 메모리 데이터, 스킬 코드
• 용도: 작업 환경 격리, 데이터 지속성

Session (세션)

하나의 대화 단위입니다. 사용자와 AI 간의 메시지 교환을 추적합니다.

• 생성: 새로운 대화 시작 시 자동 생성
• 수명: 마지막 메시지 후 기간 동안 유지
• 식별자: 고유한 세션 ID로 구분

Agent (에이전트)

AI 모델을 기반으로 동작하는 지능형 어시스턴트입니다.

• 구성: AI 모델 + 스킬 + 메모리
• 동작: 사용자 요청을 이해하고 처리한 후 응답 생성
• 확장: 스킬을 통해 기능 추가 가능

채널 관련

Channel (채널)

OpenClaw와 사용자가 소통하는 통로입니다.

• 종류: Slack, Telegram, Discord
• 다중 채널: 동시에 여러 채널 사용 가능
• 메시지 라우팅: 채널별로 세션 분리

Bot Token (봇 토큰)

채널에서 OpenClaw를 인증하는 데 사용되는 비밀 키입니다.

• 중요성: 절대로 공개하면 안 됨
• 발급: 각 채널의 개발자 포털에서 발급
• 형식: 채널마다 다름

AI 모델 관련

Provider (제공자)

AI 모델을 제공하는 서비스입니다.

• Anthropic: Claude 모델 제공 (OpenClaw 기본)
• OpenAI: GPT 모델 제공
• xAI: Grok 모델 제공

Model (모델)

AI 모델의 특정 버전입니다.

Temperature (온도)

AI 응답의 창의성을 조절하는 매개변수입니다.

• 범위: 0.0 ~ 1.0
• 0.0: 결정적, 일관된 응답
• 0.7: 균형 (기본값)
• 1.0: 창의적, 다양한 응답

Token (토큰)

AI 모델이 텍스트를 처리하는 단위입니다.

• 영어: 대략 1토큰 = 4문자
• 한국어: 대략 1토큰 = 1-2음절
• 비용: 토큰 수에 따라 과금
• 제한: 모델별 최대 토큰 수 다름

스킬 관련

Skill (스킬)

OpenClaw의 기능을 확장하는 플러그인입니다.

• 내장 스킬: OpenClaw에 기본 포함 (예: 웹 검색)
• 커스텀 스킬: 사용자가 직접 개발
• 스킬 매니페스트: 스킬 정보와 설정 정의

Manifest (매니페스트)

스킬의 메타데이터와 설정을 정의하는 파일입니다.

• 파일명: skill-manifest.json
• 내용: 스킬 이름, 설명, 버전, 의존성
• 위치: 각 스킬 디렉터리의 루트

ClawHub (클로허브)

OpenClaw 스킬을 공유하는 중앙 저장소입니다.

• 역할: npm과 유사한 스킬 패키지 관리자
• 검색: 필요한 스킬 검색 및 설치
• 공유: 커스텀 스킬 공개

메모리 시스템

QMD (Query-based Memory Decay)

OpenClaw의 고급 메모리 시스템입니다.

• 기능: 관련성 있는 기억 우선 회수
• 자동 감쇠: 오래된 기억 자동 삭제
• 벡터 검색: 의미적 유사성 기반 검색

Vector Embedding (벡터 임베딩)

텍스트를 숫자 벡터로 변환하는 기술입니다.

• 용도: 의미적 유사성 계산
• 모델: 예: OpenAI text-embedding-3-small
• 차원: 보통 1536차원

Retention (보유)

메모리 데이터의 보존 기간입니다.

• 단위: 일(day)
• 기본값: 30일
• 설정: memory.retentionDays로 조절

기술 용어

HTTP (HyperText Transfer Protocol)

웹에서 데이터를 전송하는 프로토콜입니다.

• 역할: 클라이언트-서버 통신
• 메서드: GET, POST, PUT, DELETE
• 상태 코드: 200(성공), 401(인증 실패), 500(서버 오류)

WebSocket

실시간 양방향 통신을 위한 프로토콜입니다.

• 용도: 실시간 메시징
• 특징: 지속적 연결, 낮은 지연
• Slack: Socket Mode로 WebSocket 사용

JSON (JavaScript Object Notation)

데이터 교환 형식입니다.

• 구조: 키-값 쌍
• 용도: 설정 파일, API 응답

Environment Variable (환경 변수)

시스템 환경에 저장된 구성 값입니다.

• 장점: 설정 파일보다 안전
• 형식: OPENCLAW_SLACK_BOT_TOKEN
• 사용: API 키, 민감 정보

Daemon (데몬)

백그라운드에서 실행되는 프로그램입니다.

• OpenClaw: --daemon 플래그로 백그라운드 실행
• 특징: 터미널 종료 후에도 동작
• 관리: 프로세스 매니저로 제어

Rate Limiting (속도 제한)

API 요청 수를 제한하는 기능입니다.

• 목적: 과도한 요청 방지, 비용 절감
• 설정: security.rateLimiting
• 단위: 요청 수/시간 창

Heartbeat (하트비트)

주기적으로 작업을 수행하는 기능입니다.

• 용도: 폴링, 상태 확인
• 설정: 간격, 조건
• 예시: 매 10분마다 이메일 확인

Cron (크론)

특정 시간에 작업을 예약하는 기능입니다.

• 용도: 정기 작업 예약
• 형식: Cron 표현식
• 예시: 매일 아침 9시 뉴스 요약

이 용어 사전은 지속적으로 업데이트됩니다. 새로운 용어나 추가 설명이 필요한 용어는 GitHub Issues로 제안해 주세요.