도구와 Plugins
에이전트가 텍스트 생성 외에 수행하는 모든 작업은 도구를 통해 이루어집니다. 도구는 에이전트가 파일을 읽고, 명령을 실행하고, 웹을 탐색하고, 메시지를 보내고, 디바이스와 상호작용하는 방식입니다.도구, Skills, plugins
OpenClaw에는 함께 작동하는 세 가지 계층이 있습니다.도구는 에이전트가 호출하는 대상입니다
도구는 에이전트가 호출할 수 있는 타입이 지정된 함수입니다(예:
exec, browser,
web_search, message). OpenClaw는 내장 도구 집합을 제공하며
plugins는 추가 도구를 등록할 수 있습니다.에이전트는 도구를 모델 API에 전송되는 구조화된 함수 정의로 인식합니다.Skills는 언제, 어떻게 사용할지 가르칩니다
skill은 시스템 프롬프트에 주입되는 markdown 파일(
SKILL.md)입니다.
Skills는 에이전트가 도구를 효과적으로 사용하도록 컨텍스트, 제약, 단계별 안내를 제공합니다.
Skills는 워크스페이스, 공유 폴더에 있거나 plugin 안에 포함되어 제공될 수 있습니다.Skills 참조 | Skills 만들기Plugins는 모든 것을 하나로 묶어 패키징합니다
plugin은 채널, 모델 provider, 도구, skills, 음성, 실시간 전사,
실시간 음성, 미디어 이해, 이미지 생성, 비디오 생성,
웹 가져오기, 웹 검색 등을 포함한 임의 조합의 기능을 등록할 수 있는 패키지입니다.
일부 plugins는 코어(OpenClaw와 함께 제공)이고, 다른 것들은 외부
(커뮤니티가 npm에 게시)입니다.Plugins 설치 및 구성 | 직접 만들기
내장 도구
이 도구들은 OpenClaw와 함께 제공되며 plugin을 설치하지 않아도 사용할 수 있습니다.| 도구 | 역할 | 페이지 |
|---|---|---|
exec / process | 셸 명령 실행, 백그라운드 프로세스 관리 | Exec |
code_execution | 샌드박스된 원격 Python 분석 실행 | Code Execution |
browser | Chromium 브라우저 제어(탐색, 클릭, 스크린샷) | Browser |
web_search / x_search / web_fetch | 웹 검색, X 게시물 검색, 페이지 콘텐츠 가져오기 | Web |
read / write / edit | 워크스페이스에서 파일 I/O | |
apply_patch | 다중 hunk 파일 패치 | Apply Patch |
message | 모든 채널에 메시지 전송 | Agent Send |
canvas | node Canvas 구동(present, eval, snapshot) | |
nodes | 페어링된 디바이스 검색 및 대상 지정 | |
cron / gateway | 예약 작업 관리, gateway 검사, 패치, 재시작 또는 업데이트 | |
image / image_generate | 이미지 분석 또는 생성 | Image Generation |
music_generate | 음악 트랙 생성 | Music Generation |
video_generate | 비디오 생성 | Video Generation |
tts | 일회성 text-to-speech 변환 | TTS |
sessions_* / subagents / agents_list | 세션 관리, 상태, 하위 에이전트 오케스트레이션 | Sub-agents |
session_status | 경량 /status 스타일 읽기 및 세션 모델 재정의 | Session Tools |
image를, 생성 또는 편집용으로 image_generate를 사용하세요. openai/*, google/*, fal/* 또는 다른 비기본 이미지 provider를 대상으로 하는 경우 먼저 해당 provider의 인증/API 키를 구성하세요.
음악 작업에는 music_generate를 사용하세요. google/*, minimax/* 또는 다른 비기본 음악 provider를 대상으로 하는 경우 먼저 해당 provider의 인증/API 키를 구성하세요.
비디오 작업에는 video_generate를 사용하세요. qwen/* 또는 다른 비기본 비디오 provider를 대상으로 하는 경우 먼저 해당 provider의 인증/API 키를 구성하세요.
워크플로 중심 오디오 생성에는 ComfyUI 같은 plugin이
등록하는 music_generate를 사용하세요. 이는 text-to-speech인 tts와는 별개입니다.
session_status는 sessions 그룹의 경량 상태/읽기 도구입니다.
현재 세션에 대한 /status 스타일 질문에 답할 수 있으며
선택적으로 세션별 모델 재정의를 설정할 수 있습니다. model=default는 해당
재정의를 해제합니다. /status와 마찬가지로, 최신 transcript usage 항목에서
희소한 토큰/캐시 카운터와 활성 런타임 모델 레이블을 보완할 수 있습니다.
gateway는 gateway 작업을 위한 소유자 전용 런타임 도구입니다.
- 편집 전에 경로 범위가 지정된 하나의 config 하위 트리를 조회하는
config.schema.lookup - 현재 config 스냅샷 + 해시를 가져오는
config.get - 재시작과 함께 부분 config 업데이트를 수행하는
config.patch - 전체 config 교체에만 사용하는
config.apply - 명시적 self-update + 재시작을 수행하는
update.run
config.schema.lookup 후 config.patch를 우선 사용하세요.
config.apply는 전체 config를 의도적으로 교체할 때만 사용하세요.
이 도구는 또한 tools.exec.ask 또는 tools.exec.security 변경을 거부합니다.
레거시 tools.bash.* 별칭은 동일한 보호된 exec 경로로 정규화됩니다.
Plugin이 제공하는 도구
Plugins는 추가 도구를 등록할 수 있습니다. 몇 가지 예:- Lobster — 재개 가능한 승인 기능을 갖춘 타입 지정 워크플로 런타임
- LLM Task — 구조화된 출력을 위한 JSON 전용 LLM 단계
- Music Generation — 워크플로 기반 providers를 사용하는 공유
music_generate도구 - Diffs — diff 뷰어 및 렌더러
- OpenProse — markdown 우선 워크플로 오케스트레이션
도구 구성
허용 및 거부 목록
config의tools.allow / tools.deny를 통해
에이전트가 호출할 수 있는 도구를 제어합니다. 거부는 항상 허용보다 우선합니다.
도구 프로필
tools.profile은 allow/deny가 적용되기 전에 기본 허용 목록을 설정합니다.
에이전트별 재정의: agents.list[].tools.profile.
| 프로필 | 포함 항목 |
|---|---|
full | 제한 없음(미설정과 동일) |
coding | group:fs, group:runtime, group:web, group:sessions, group:memory, cron, image, image_generate, music_generate, video_generate |
messaging | group:messaging, sessions_list, sessions_history, sessions_send, session_status |
minimal | session_status만 포함 |
도구 그룹
허용/거부 목록에서는group:* 축약형을 사용하세요.
| 그룹 | 도구 |
|---|---|
group:runtime | exec, process, code_execution (bash는 exec의 별칭으로 허용됨) |
group:fs | read, write, edit, apply_patch |
group:sessions | sessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status |
group:memory | memory_search, memory_get |
group:web | web_search, x_search, web_fetch |
group:ui | browser, canvas |
group:automation | cron, gateway |
group:messaging | message |
group:nodes | nodes |
group:agents | agents_list |
group:media | image, image_generate, music_generate, video_generate, tts |
group:openclaw | 모든 내장 OpenClaw 도구(plugin 도구 제외) |
sessions_history는 범위가 제한되고 안전 필터링된 회상 보기를 반환합니다. 이 도구는
thinking 태그, <relevant-memories> 스캐폴딩, 일반 텍스트 도구 호출 XML
payload(예: <tool_call>...</tool_call>,
<function_call>...</function_call>, <tool_calls>...</tool_calls>,
<function_calls>...</function_calls>, 잘린 도구 호출 블록 포함),
강등된 도구 호출 스캐폴딩, 누출된 ASCII/전각 모델 제어
토큰, 잘못된 MiniMax 도구 호출 XML을 assistant 텍스트에서 제거한 뒤,
원시 transcript 덤프로 동작하는 대신
redaction/truncation 및 필요 시 oversized-row placeholder를 적용합니다.
Provider별 제한
전역 기본값을 바꾸지 않고 특정 provider에 대한 도구를 제한하려면tools.byProvider를 사용하세요.