---
title: OpenClaw 매뉴얼
updated: 2026-03-12
---

## 도구/스킬/플러그인 시스템 (4/8)

[OpenClaw 매뉴얼 4/8 - 도구/스킬/플러그인 시스템]
도구 시스템:
- 프로필: minimal|coding|messaging|full (agents.defaults.tools 또는 per-agent)
- exec 보안: deny(기본)|allowlist|full
- exec 설정: backgroundMs:10000, timeoutSec:1800
- 루프 감지: historySize:30, warningThreshold:10, criticalThreshold:20
- 웹 도구: tools.web.search(Brave API)/tools.web.fetch
- 미디어 도구: tools.media.audio/video (whisper, gemini 등)
- 에이전트 간 통신: tools.agentToAgent.enabled
- 서브에이전트: tools.subagents.model/maxConcurrent/runTimeoutSeconds

스킬 시스템:
- 위치: workspace/skills/ > ~/.openclaw/skills/ > bundled (우선순위)
- 매니페스트: skills/{name}/SKILL.md (YAML frontmatter)
- 필드: name, description, user-invocable, metadata(requires.bins/env/config/os)
- ClawHub: npx clawhub install/update/sync
- 현재 IronDesk: 3/51 ready (healthcheck, skill-creator, weather)

플러그인 시스템:
- 명령: openclaw plugins list|info|install|enable|disable|doctor
- 매니페스트: openclaw.plugin.json (id, configSchema 필수)
- 슬롯: plugins.slots.memory/contextEngine
- 현재 loaded: device-pair, memory-core, phone-control, talk-voice, telegram (5개)
- memory-lancedb: disabled (벡터 검색용, 임베딩 API 키 필요)

## 세션/채널/게이트웨이 관리 (6/8)

[OpenClaw 매뉴얼 6/8 - 세션/채널/게이트웨이 관리]
세션 관리:
- dmScope: main(기본, 전체공유)|per-peer|per-channel-peer(IronDesk 현재 설정)|per-account-channel-peer
- 세션 키: agent:{agentId}:{mainKey} 또는 agent:{agentId}:dm:{peerId}
- 그룹: agent:{agentId}:{channel}:group:{id}, 텔레그램 토픽: ...group:{id}:topic:{threadId}
- 리셋: session.reset.mode=daily(atHour:4)|idle(idleMinutes:60), resetTriggers:["/new","/reset"]
- 저장소: ~/.openclaw/agents/{agentId}/sessions/sessions.json
- 유지보수: pruneAfter:30d, maxEntries:500, maxDiskBytes:500mb
- 채팅 명령: /new, /reset, /status, /context list|detail, /compact

채널:
- Telegram: botToken, dmPolicy(pairing|allowlist|open|disabled), streaming(off|partial|block|progress), groups, topics
- Discord: token, guilds, channels, voice, thread bindings, reactions
- WhatsApp: dmPolicy, allowFrom, textChunkLimit, sendReadReceipts
- Slack: socketMode 또는 HTTP, slash commands
- Signal, iMessage, IRC, Matrix, Mattermost, MS Teams, LINE, Google Chat 등

게이트웨이:
- mode: local|remote, port:18789(기본)
- bind: loopback|lan|tailnet|custom|auto
- auth: none|token|password|trusted-proxy
- Tailscale: mode=off|serve|funnel
- 서비스: openclaw gateway install|start|stop|restart|status|uninstall
- RPC: openclaw gateway call {method} --params {json}
- 헬스: openclaw gateway health|probe|discover
- HTTP 엔드포인트: chatCompletions, responses (OpenAI 호환)