부록 F. 용어 사전
기술 용어가 많아질수록 머리가 복잡해진다. 그럴 때는 새로 공부를 시작하는 대신, 먼저 단어의 뜻을 다시 붙잡는 편이 빠르다. 이 부록은 책 전체를 관통하는 핵심 용어를 짧고 정확하게 정리한 기준표다.
아키텍처와 연결 용어
이 절의 용어는 OpenClaw의 공식 아키텍처 문서를 바탕으로 정리했다.1
| 용어 | 뜻 | 실전에서 이렇게 이해하면 쉽다 |
|---|---|---|
| Gateway | OpenClaw의 중심 데몬이다. 메시지 채널 연결, 라우팅, 인증, 상태 확인, WebSocket API를 한곳에서 맡는다. | 시스템의 관제탑이다. 메신저에서 온 말도, 웹 UI에서 누른 버튼도 먼저 여기로 들어온다. |
| Agent | 성격, 규칙, 모델, 도구 정책, 메모리를 가진 AI 작업 단위다. | "나의 비서", "코딩 담당", "리포팅 담당" 같은 역할별 AI 한 명으로 생각하면 된다. |
| Agent Runtime | 에이전트가 컨텍스트를 모으고, 모델을 호출하고, 도구를 실행하는 실행 엔진이다. | 말만 하는 부분이 아니라 실제로 일을 굴리는 엔진이다. |
| Client | Gateway를 조작하거나 상태를 보는 인터페이스다. CLI, macOS 앱, 웹 UI가 여기에 들어간다. | 운전석이다. 사람은 보통 Client를 통해 OpenClaw를 만진다. |
| Node | role: node로 Gateway에 붙는 기기 실행 주체다. 카메라, 화면 녹화, 위치 같은 기기 기능을 제공할 수 있다. | 에이전트의 손발이다. 휴대폰이나 다른 장치가 능력을 보태는 구조다. |
| Channel | Telegram, WhatsApp, Slack, Discord 같은 메시징 연결 단위다. | 에이전트와 대화하는 "입구"다. |
| Binding | 어떤 채널·계정·대화에서 온 메시지를 어느 Agent로 보낼지 정하는 라우팅 규칙이다. | 우체국 분류 규칙이라고 생각하면 된다. |
| Session | 한 대화 흐름의 맥락과 기록을 묶는 단위다. | 같은 사람과 같은 방에서 이어지는 대화의 기억 상자다. |
| Main Session | 기본 1:1 대화에 쓰이는 대표 세션이다. | 가장 자주 쓰는 기본 채팅방이다. |
| Workspace | 에이전트의 규칙, 성격, 기억, 스킬 파일이 들어 있는 작업 폴더다. | 에이전트의 방이자 책상이다. |
| Canvas | 에이전트가 HTML/CSS/JS 형태의 인터랙티브 UI를 보여줄 수 있는 화면 영역이다. | 텍스트 대신 작은 웹 앱을 바로 띄우는 창이다. |
| Hub-and-Spoke | Gateway를 중심 허브로 두고, 채널·클라이언트·노드가 바퀴살처럼 연결되는 구조다. | OpenClaw를 "중앙 허브형 운영체제"처럼 보게 해 주는 그림이다. |
추론·실행·자동화 용어
이 절의 자동화 용어는 공식 Heartbeat 문서와 공개 아키텍처 해설을 함께 참고해 정리했다.23
| 용어 | 뜻 | 실전에서 이렇게 이해하면 쉽다 |
|---|---|---|
| ReAct | Reason + Act의 줄임말이다. 생각하고, 도구를 쓰고, 결과를 보고, 다시 판단하는 반복 패턴이다. | 챗봇이 "대답만" 한다면, 에이전트는 "생각하고 움직인다". |
| Tool Use | 모델이 외부 기능을 호출해 실제 작업을 수행하는 방식이다. | AI가 말 대신 손을 쓰는 순간이다. |
| Tool | 읽기, 쓰기, 실행, 브라우저 제어, 메시지 전송처럼 에이전트가 사용할 수 있는 개별 기능이다. | 에이전트의 공구함 안에 든 망치 하나, 드라이버 하나에 해당한다. |
| Skill | 특정 작업을 더 잘 하도록 도메인 지식을 묶어 둔 확장 단위다. 보통 SKILL.md를 중심으로 설명과 규칙을 담는다. | "깃허브 리뷰 전문가" 같은 작은 전문 교육 패키지다. |
| SKILL.md | 스킬의 설명, 사용 조건, 절차를 적는 핵심 파일이다. | 에이전트에게 주는 짧은 업무 매뉴얼이다. |
| Context | 현재 대화, 시스템 규칙, 메모리, 스킬 설명, 사용자 정보 등 모델에게 한 번에 넣어 주는 정보 묶음이다. | 에이전트가 지금 이 순간 참고하는 머릿속 재료다. |
| Context Window | 모델이 한 번에 처리할 수 있는 최대 텍스트 범위다. | 책상을 너무 넓게 펼치면 좋지만, 책상 크기에는 한계가 있는 셈이다. |
| Cron | 정해진 시간이나 주기에 맞춰 작업을 실행하는 스케줄 방식이다. | "매일 오전 9시"처럼 벽시계 기준으로 움직이는 자동화다. |
| Heartbeat | 일정 간격으로 에이전트가 스스로 한 번씩 깨어나 점검하는 주기 실행이다. | 누가 부르지 않아도 안부를 묻는 디지털 비서의 맥박이다. |
| Compaction | 긴 대화 기록을 요약해 컨텍스트 길이를 줄이는 과정이다. | 낡은 영수증을 버리고 가계부 요약만 남기는 일과 비슷하다. |
| Memory Flush | 압축 전에 꼭 남겨야 할 사실을 메모리 파일로 옮겨 적는 과정이다. | 잊기 전에 핵심을 메모장에 적어 두는 행동이다. |
| Subagent | 특정 작업만 처리하려고 잠깐 만들어 쓰는 보조 에이전트다. | 본대장이 세부 업무를 외주 주는 작은 팀원이라고 보면 된다. |
| MCP | Model Context Protocol의 줄임말이다. 외부 도구나 서비스와 모델을 연결하는 표준 인터페이스 계열을 뜻한다. | SaaS와 AI를 깔끔하게 잇는 멀티탭 같은 개념이다. |
워크스페이스 파일 용어
이 절은 OpenClaw가 파일 기반 워크스페이스를 중심으로 동작한다는 공개 운영 자료를 바탕으로 정리했다.34
| 용어 | 뜻 | 실전에서 이렇게 이해하면 쉽다 |
|---|---|---|
| SOUL.md | 에이전트의 성격, 말투, 가치관, 우선순위를 적는 파일이다. | "이 AI는 어떤 사람처럼 행동해야 하는가?"를 정하는 성격 설정지다. |
| AGENTS.md | 작업 규칙, 금지 사항, 협업 방식, 메모리 정책 같은 운영 규칙을 담는 파일이다. | 성격이 아니라 업무 규정집이다. |
| USER.md | 사용자의 이름, 호칭, 시간대, 선호 스타일, 일정 맥락 등을 적는 파일이다. | 에이전트가 나를 헷갈리지 않게 하는 사용자 프로필이다. |
| MEMORY.md | 오래 남겨야 할 핵심 기억을 수동 또는 반자동으로 정리해 두는 장기 기억 파일이다. | 잊으면 안 되는 사실만 적는 장기 노트다. |
memory/YYYY-MM-DD.md | 날짜별로 쌓이는 일일 메모리 로그다. | 오늘과 어제의 작업 메모, 즉 단기 기억에 가깝다. |
| HEARTBEAT.md | 하트비트 때 무엇을 점검할지 적는 체크리스트 파일이다. | "정기 순찰할 때 이건 꼭 봐"라고 적어 둔 메모다. |
| TOOLS.md | 도구 사용 방식, 외부 서비스 규칙, 환경별 주의점을 설명하는 안내 파일이다. | 도구 권한 자체를 주는 파일은 아니지만, 도구를 어떻게 써야 하는지 알려 주는 설명서다. |
| Bootstrap File | 세션 시작 시 컨텍스트에 들어가는 핵심 워크스페이스 파일 묶음을 가리키는 표현이다. | 에이전트가 출근하자마자 읽는 기본 서류철이다. |
| agentDir | 에이전트별 인증 정보, 세션 기록, 내부 상태 파일이 저장되는 전용 디렉터리다. | 워크스페이스가 책상이라면, agentDir은 서랍 안쪽 시스템 파일 공간이다. |
보안과 운영 용어
이 절의 보안 용어는 공식 샌드박싱 문서와 멀티 에이전트 보안 설정 문서를 기준으로 요약했다.56
| 용어 | 뜻 | 실전에서 이렇게 이해하면 쉽다 |
|---|---|---|
| Pairing | 새 장치나 새 클라이언트의 연결을 승인하는 절차다. 승인 후 장치 토큰이 발급된다. | 새 기기를 집 열쇠 목록에 올리는 과정이다. |
| Gateway Token | Gateway의 WebSocket API에 접속할 때 쓰는 공유 비밀값이다. | 현관 비밀번호 같은 것이다. |
| API Key | OpenAI, Anthropic 같은 모델 제공자에 인증할 때 쓰는 비밀 키다. | 모델 사용료가 연결된 카드 키라고 생각하면 된다. |
| Auth Profile | 어떤 제공자의 어떤 인증 방식을 쓸지 저장한 프로필이다. | 서비스별 로그인 정보 묶음이다. |
| Allowlist | 허용한 사람, 파일 경로, 도메인, 명령만 통과시키는 정책이다. | "이 명단에 있는 것만 들어와" 방식의 보안이다. |
| DM Policy | 1:1 메시지를 누구에게 열어 둘지 정하는 정책이다. | 모르는 사람 DM을 받을지 말지 정하는 문지기다. |
| Group Policy | 어떤 그룹 채팅에서 에이전트가 동작할지 제어하는 정책이다. | 단톡방 출입 규칙이다. |
| Require Mention | 그룹에서 @멘션이 있을 때만 응답하게 하는 설정이다. | 괜히 끼어들지 말고, 불렸을 때만 말하라는 뜻이다. |
| Sandbox | 도구 실행을 격리된 환경에서 돌려 피해 범위를 줄이는 장치다. | 본체 대신 작은 실험 상자 안에서 일시키는 방법이다. |
| Sandbox Mode | 샌드박스를 언제 적용할지 정하는 모드다. off, non-main, all 같은 값이 있다. | 어떤 대화는 본체에서, 어떤 대화는 격리 환경에서 돌릴지 정하는 스위치다. |
| Sandbox Scope | 샌드박스 컨테이너를 세션별, 에이전트별, 공용으로 나눌지 정하는 범위다. | 상자를 한 사람당 하나 줄지, 대화방마다 하나 줄지 정하는 선택이다. |
| workspaceAccess | 샌드박스에서 워크스페이스를 읽기 전용, 읽기/쓰기, 또는 비공개로 둘지 정하는 설정이다. | 상자 안에서 원본 책상에 얼마나 손댈 수 있는지 정하는 규칙이다. |
| Elevated Exec | 샌드박스를 우회해 호스트에서 직접 실행되는 고권한 명령 실행 경로다. | 비상용 마스터키다. 편하지만 가장 조심해야 한다. |
| Loopback | 127.0.0.1처럼 자기 자신에게만 열리는 로컬 네트워크 주소다. | 집 안에서만 들리는 초인종이다. |
| SSH Tunnel | 원격 서버의 로컬 포트를 암호화된 통로로 내 컴퓨터에 연결하는 방식이다. | 인터넷에 문을 활짝 여는 대신, 잠긴 전용 통로를 만드는 셈이다. |
| Prompt Injection | 웹페이지, 이메일, 문서 속 숨은 지시가 에이전트의 판단을 흔드는 공격 기법이다. | 읽은 내용 속에 몰래 끼워 넣은 "속닥속닥 명령"이다. |
| Confused Deputy | 권한 없는 사용자가, 권한 많은 에이전트를 대신 움직여 원래 못 할 일을 하게 만드는 상황이다. | 본인은 열쇠가 없는데 경비 아저씨를 속여 문을 열게 하는 꼴이다. |
| Supply Chain Attack | 외부 스킬, 패키지, 플러그인 같은 공급망을 통해 악성 코드가 들어오는 공격이다. | 내가 믿는 택배 상자 안에 문제가 숨어 들어오는 경우다. |
생태계와 확장 용어
이 절의 일반 용어는 공개 용어집과 운영 가이드를 보조 참고해 정리했다.47
| 용어 | 뜻 | 실전에서 이렇게 이해하면 쉽다 |
|---|---|---|
| ClawHub | OpenClaw용 스킬을 찾고 설치하고 배포하는 허브 또는 마켓이다. | 앱스토어의 스킬 버전이라고 생각하면 가장 빠르다. |
| Provider | AI 모델을 API로 제공하는 회사나 서비스다. | OpenAI, Anthropic, Google 같은 공급자다. |
| Model | 실제 응답을 만들어 내는 개별 AI 엔진이다. | 같은 자동차 회사라도 차종이 다르듯, 제공자 안에 여러 모델이 있다. |
| Self-Hosting | 내 컴퓨터나 내 서버에서 직접 OpenClaw를 운영하는 방식이다. | 편의는 줄어도 통제권은 커진다. |
| Local-First | 가능한 한 데이터와 실행 환경을 내 장치 가까이에 두려는 철학이다. | 클라우드 만능주의가 아니라, 내 파일과 내 환경을 우선하는 태도다. |
| Multi-Agent | 역할이 다른 여러 에이전트를 함께 운영하는 구조다. | 대표, 실무자, 검토자, 보고 담당을 분리하는 팀 운영 방식이다. |
| Plugin | 채널, 도구, 명령, 기능을 확장하는 추가 모듈이다. | OpenClaw의 확장팩이다. |
| Web Dashboard / Control UI | 브라우저에서 Gateway 상태, 세션, 채널, 노드 등을 확인하는 관리 화면이다. | 터미널 대신 계기판으로 보는 운영 화면이다. |
헷갈리기 쉬운 쌍 정리
| 헷갈리는 쌍 | 차이 |
|---|---|
| Gateway vs Agent | Gateway는 전체 교통정리와 연결 관리, Agent는 실제 업무를 수행하는 AI 인격이다. |
| Skill vs Tool | Skill은 "어떻게 할지"를 담은 지식 패키지, Tool은 "실제로 실행하는 기능"이다. |
| Cron vs Heartbeat | Cron은 정확한 시간 실행, Heartbeat는 주기적으로 살펴보고 필요할 때만 알리는 방식이다. |
| Workspace vs agentDir | Workspace는 사람이 자주 손보는 규칙·기억 폴더, agentDir은 인증과 세션 같은 내부 운영 저장소다. |
| Pairing vs Allowlist | Pairing은 새 연결 승인 절차, Allowlist는 애초에 허용 대상만 남기는 더 좁은 통제다. |
| Sandbox vs Elevated Exec | Sandbox는 격리, Elevated Exec은 그 격리를 일부러 우회하는 예외 통로다. |
이 부록은 한 번 읽고 끝내는 페이지가 아니다. 설치할 때는 Gateway, 자동화를 짤 때는 Heartbeat와 Cron, 보안을 다질 때는 Pairing과 Sandbox, 확장을 붙일 때는 Skill과 ClawHub 항목으로 다시 돌아오면 된다. 용어가 선명해지면, OpenClaw도 훨씬 덜 무섭고 훨씬 더 쓸 만해진다.
참고
3OpenClaw Architecture Deep Dive: Gateway, ReAct Loop, Memory and Tool Execution
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.