Overview

개요

이 페이지를 사용하여 적절한 기능 표면을 선택하세요. 도구는 호출 가능한 작업이고, Skills는 에이전트에게 작업 방법을 가르치며, Plugin은 도구, 제공자, 채널, 훅, 패키징된 Skills 등의 런타임 기능을 추가합니다.

이 페이지는 개요 및 안내 페이지입니다. 도구 정책, 기본값, 그룹 구성, 제공자 제한 및 구성 필드에 대한 전체 내용은 도구 및 사용자 지정 제공자를 참조하세요.

여기서 시작하기

대부분의 에이전트는 기본 제공 도구 범주로 시작한 후, 에이전트에 표시되는 도구를 줄이거나 명시적인 호스트 접근 권한이 필요한 경우에만 정책을 조정하세요.

필요한 작업	먼저 사용할 항목	다음으로 읽을 문서
에이전트가 기존 기능으로 작업하도록 허용	기본 제공 도구	도구 범주
에이전트가 호출할 수 있는 항목 제어	도구 정책	도구 및 사용자 지정 제공자
에이전트에게 워크플로 가르치기	Skills	Skills, Skills 만들기, Skill 워크숍
새로운 통합 또는 런타임 표면 추가	Plugin	Plugin 및 Plugin 빌드
나중에 또는 백그라운드에서 작업 실행	자동화	자동화 개요
여러 에이전트 또는 하니스 조율	하위 에이전트	ACP 에이전트 및 에이전트 전송
대규모 OpenClaw 도구 카탈로그 검색	도구 검색	도구 검색

도구, Skills 또는 Plugin 선택하기

에이전트가 작업을 수행해야 할 때 도구 사용

도구는 exec, browser, web_search, message, image_generate처럼 에이전트가 호출할 수 있는 형식화된 함수입니다. 에이전트가 데이터를 읽거나, 파일을 변경하거나, 메시지를 보내거나, 제공자를 호출하거나, 다른 시스템을 조작해야 할 때 도구를 사용하세요. 표시되는 도구는 구조화된 함수 정의로 모델에 전송됩니다.

모델에는 활성 프로필, 허용/거부 정책, 제공자 제한, 샌드박스 상태, 채널 권한 및 Plugin 가용성을 모두 통과한 도구만 표시됩니다.

에이전트에게 지침이 필요할 때 Skills 사용

Skill은 에이전트 프롬프트에 로드되는 SKILL.md 지침 패키지입니다. 에이전트가 필요한 도구는 이미 갖추고 있지만 반복 가능한 워크플로, 검토 기준, 명령 순서 또는 운영 제약이 필요할 때 Skill을 사용하세요.

Skills는 워크스페이스, 공유 Skill 디렉터리, 관리형 OpenClaw Skill 루트 또는 Plugin 패키지에 둘 수 있습니다.

Skills | Skill 워크숍 | Skills 만들기 | Skills 구성

OpenClaw에 새로운 기능이 필요할 때 Plugin 사용

Plugin은 도구, Skills, 채널, 모델 제공자, 음성, 실시간 음성, 미디어 생성, 웹 검색, 웹 가져오기, 훅 및 기타 런타임 기능을 추가할 수 있습니다. 기능에 코드, 자격 증명, 수명 주기 훅, 매니페스트 메타데이터 또는 설치 가능한 패키징이 포함될 때 Plugin을 사용하세요. 기존 Plugin은 ClawHub, npm, git, 로컬 디렉터리 또는 아카이브에서 설치할 수 있습니다.

Plugin 설치 및 구성 | Plugin 빌드 | Plugin SDK

기본 제공 도구 범주

이 표에는 기능 표면을 파악할 수 있도록 대표적인 도구가 나열되어 있습니다. 전체 정책 참조 문서는 아닙니다. 정확한 그룹, 기본값 및 허용/거부 의미 체계는 도구 및 사용자 지정 제공자를 참조하세요.

범주	에이전트가 다음 작업을 수행해야 할 때 사용	대표 도구	다음으로 읽을 문서
런타임	명령 실행, 프로세스 관리 또는 제공자 기반 Python 분석 사용	`exec`, `process`, `code_execution`	Exec, 코드 실행
파일	워크스페이스 파일 읽기 및 변경	`read`, `write`, `edit`, `apply_patch`	패치 적용
웹	웹 검색, X 게시물 검색 또는 읽을 수 있는 페이지 콘텐츠 가져오기	`web_search`, `x_search`, `web_fetch`	웹 도구, 웹 가져오기
브라우저	브라우저 세션 조작	`browser`	브라우저
메시징 및 채널	답글 또는 채널 작업 전송	`message`	에이전트 전송
세션 및 에이전트	세션 검사, 작업 위임, 다른 실행 제어 또는 상태 보고	`sessions_*`, `subagents`, `agents_list`, `session_status`, `get_goal`, `create_goal`, `update_goal`	목표, 하위 에이전트, 세션 도구
자동화	작업 예약 또는 백그라운드 이벤트에 응답	`cron`, `heartbeat_respond`	자동화
Gateway 및 Node	Gateway 상태 또는 페어링된 대상 기기 검사	`gateway`, `nodes`	Gateway 구성, Node
미디어	미디어 분석, 생성 또는 음성 출력	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	미디어 개요
대규모 OpenClaw 카탈로그	모든 스키마를 모델에 전송하지 않고 적격 도구를 다수 검색하고 호출	`tool_search_code`, `tool_search`, `tool_describe`	도구 검색

Plugin 제공 도구

Plugin은 추가 도구를 등록할 수 있습니다. Plugin 작성자는 api.registerTool(...) 및 매니페스트의 contracts.tools를 통해 도구를 연결합니다. 계약 세부 정보는 Plugin SDK 및 Plugin 매니페스트를 참조하세요.

일반적인 Plugin 제공 도구는 다음과 같습니다.

파일 및 Markdown 차이를 렌더링하는 차이
웹 채팅에서 독립적으로 동작하는 인라인 SVG 및 HTML을 제공하는 위젯 표시
JSON 전용 워크플로 단계에 사용하는 LLM 작업
재개 가능한 승인을 지원하는 형식화된 워크플로에 사용하는 Lobster
잡음이 많은 exec 및 bash 도구 출력을 압축하는 Tokenjuice
모든 스키마를 프롬프트에 넣지 않고 대규모 도구 카탈로그를 검색하고 호출하는 도구 검색
Node Canvas 제어 및 A2UI 렌더링에 사용하는 Canvas

접근 및 승인 구성

도구 정책은 모델 호출 전에 적용됩니다. 정책에서 도구가 제거되면 모델은 해당 턴에서 그 도구의 스키마를 받지 못합니다. 전역 구성, 에이전트별 구성, 채널 정책, 제공자 제한, 샌드박스 규칙, 채널/런타임 정책 또는 Plugin 가용성으로 인해 실행에서 도구가 제외될 수 있습니다.

도구 및 사용자 지정 제공자에서는 도구 프로필, 허용/거부 목록, 제공자별 제한, 루프 감지 및 제공자 기반 도구 설정을 설명합니다.
Exec 승인에서는 호스트 명령 승인 정책을 설명합니다.
권한 상승 Exec에서는 샌드박스 외부의 제어된 실행을 설명합니다.
샌드박스와 도구 정책 및 권한 상승 비교에서는 파일 및 프로세스 접근을 제어하는 계층을 설명합니다.
에이전트별 샌드박스 및 도구 제한에서는 위임된 실행에 적용되는 에이전트별 제한을 설명합니다.

기능 확장

OpenClaw가 수행해야 하는 작업에 따라 확장 경로를 선택하세요.

Plugin을 사용하여 기존 Plugin을 설치하거나 관리합니다.
Plugin 빌드를 사용하여 새로운 통합, 제공자, 채널, 도구 또는 훅을 빌드합니다.
Skills 및 Skills 만들기를 사용하여 재사용 가능한 에이전트 지침을 추가하거나 조정합니다.
구현 계약이 필요할 때 Plugin SDK 및 Plugin 매니페스트를 사용합니다.

누락된 도구 문제 해결

모델에서 도구를 보거나 호출할 수 없다면 현재 턴에 적용되는 유효 정책부터 확인하세요.

도구 및 사용자 지정 제공자에서 활성 프로필, tools.allow 및 tools.deny를 확인합니다.
도구 및 사용자 지정 제공자에서 제공자별 제한을 확인하고 선택한 모델 제공자가 해당 도구 형식을 지원하는지 확인합니다.
샌드박스와 도구 정책 및 권한 상승 비교 및 권한 상승 Exec에서 채널 권한, 샌드박스 상태 및 권한 상승 접근을 확인합니다.
Plugin에서 해당 도구를 소유한 Plugin이 설치되고 활성화되어 있는지 확인합니다.
위임된 실행의 경우 에이전트별 샌드박스 및 도구 제한에서 에이전트별 제한을 확인합니다.
대규모 OpenClaw 카탈로그의 경우 실행에서 도구를 직접 노출하는지 또는 도구 검색을 사용하는지 확인합니다.

개요