용어 사전
기준일: 2026-07-13 난이도: 초급 공식 기준: Agent runtime, Agent workspace, Session management, Skills
제품 명칭과 기본값은 바뀔 수 있으므로 이 페이지는 개념을 설명하고, 정확한 config path와 현재 값은 live schema와 CLI로 확인합니다.
핵심 개념
| 용어 | 의미 | 확인 방법 |
|---|---|---|
| Gateway | 채널, agent runtime, RPC client를 연결하는 장기 실행 프로세스 | openclaw gateway status |
| Agent | 모델, workspace, 도구, 정책을 묶은 실행 단위 | openclaw agents list |
| Workspace | agent의 지침, persona, memory, Skills가 있는 작업 디렉터리 | openclaw config get agents.defaults.workspace |
| Session | 대화 기록과 실행 컨텍스트를 구분하는 단위 | openclaw sessions |
| Channel | Telegram, Discord, Slack 등 외부 메시징 연결 | openclaw channels list --all |
| Provider | 모델 API와 인증을 제공하는 서비스 | openclaw models auth list |
| Model | agent가 추론에 사용하는 provider-qualified 모델 | openclaw models status |
| Skill | SKILL.md와 관련 리소스로 agent에 절차를 제공하는 패키지 |
openclaw skills list |
| Plugin | runtime, channel, tool, Skill 등을 확장할 수 있는 패키지 | openclaw plugins list |
| Profile | state와 config를 격리하는 CLI 실행 범위 | openclaw --profile <name> config file |
| SecretRef | config에 비밀값 원문 대신 provider와 id를 저장하는 참조 | Config와 Secrets 문서 |
| ClawHub | Skills를 검색·설치·배포하는 registry | Skills CLI와 ClawHub 문서 |
선택 기준
- Workspace와 state directory: workspace는 agent가 사용하는 작업 파일 영역이고, state directory는 runtime 상태와 config가 있는 운영 영역입니다.
- Skill과 plugin: Skill은 주로 agent 지침과 리소스이고, plugin은 실행 코드와 새로운 runtime surface를 포함할 수 있습니다.
- Session과 channel: session은 대화 컨텍스트이며 channel은 transport입니다. session 존재가 channel online을 뜻하지 않습니다.
- Agent와 model: agent는 model 하나보다 넓은 실행 구성이며, model 변경이 workspace나 tool policy를 자동으로 바꾸지 않습니다.
실습
현재 설치의 용어를 실제 경로와 상태에 연결합니다.
openclaw config file
openclaw config get agents.defaults.workspace
openclaw agents list
openclaw sessions
openclaw channels status --probe
openclaw models status
openclaw skills list --eligible
openclaw plugins list
Workspace에는 공식적으로 AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, 선택적인 HEARTBEAT.md, BOOT.md, MEMORY.md, memory/YYYY-MM-DD.md, skills/ 등이 사용됩니다. TOOLS.md는 도구 사용 지침이며 도구 권한 자체를 부여하지 않습니다.
도구에 입력할 프롬프트
내 OpenClaw 상태 출력에서 Gateway, agent, workspace, session,
channel, provider/model, Skill, plugin을 구분해 표로 정리해줘.
각 항목은 공식 CLI 명령이나 config schema로 확인된 값만 사용해줘.
체크리스트
- workspace와 state directory를 구분했다.
- Skill과 plugin의 실행 위험 차이를 이해했다.
- session과 channel 상태를 혼동하지 않았다.
- agent와 model을 같은 개념으로 취급하지 않았다.
- 기본값은 문서에 고정하지 않고 CLI로 확인했다.
다음 단계
- Workspace에서 bootstrap 파일을 구성합니다.
- Skills에서 로드 순서와 allowlist를 봅니다.
- Configuration에서 live schema와 SecretRef를 사용합니다.