Overview

개요

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

이 문서는 개요 및 라우팅 페이지입니다. 전체 도구 정책, 기본값, 그룹 멤버십, 공급자 제한, 구성 필드는 도구 및 사용자 지정 공급자를 사용하세요.

여기서 시작하기

대부분의 에이전트는 내장 도구 범주로 시작한 다음, 에이전트가 더 적은 도구를 보거나 명시적인 호스트 접근이 필요할 때만 정책을 조정하세요.

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

도구, Skills 또는 Plugin 선택하기

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

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

모델은 활성 프로필, 허용/거부 정책, 공급자 제한, 샌드박스 상태, 채널 권한, Plugin 가용성을 통과한 도구만 볼 수 있습니다.

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

Skills는 에이전트 프롬프트에 로드되는 SKILL.md 지침 팩입니다. 에이전트가 필요한 도구를 이미 갖고 있지만 반복 가능한 워크플로, 검토 기준, 명령 시퀀스, 또는 운영 제약이 필요할 때 Skills를 사용하세요.

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

Skills | 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`	Apply patch
웹	웹 검색, X 게시물 검색, 또는 읽을 수 있는 페이지 콘텐츠 가져오기	`web_search`, `x_search`, `web_fetch`	웹 도구, 웹 가져오기
브라우저	브라우저 세션 조작	`browser`	브라우저
메시징 및 채널	답장 또는 채널 작업 보내기	`message`	에이전트 보내기
세션 및 에이전트	세션 검사, 작업 위임, 다른 실행 조정, 또는 상태 보고	`sessions_*`, `subagents`, `agents_list`, `session_status`	하위 에이전트, 세션 도구
자동화	작업 예약 또는 백그라운드 이벤트에 응답	`cron`, `heartbeat_respond`	자동화
Gateway 및 노드	Gateway 상태 또는 페어링된 대상 장치 검사	`gateway`, `nodes`	Gateway 구성, 노드
미디어	미디어 분석, 생성 또는 말하기	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	미디어 개요
대규모 PI 카탈로그	모든 스키마를 모델에 보내지 않고 많은 적격 도구 검색 및 호출	`tool_search_code`, `tool_search`, `tool_describe`	도구 검색

Plugin 제공 도구

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

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

파일 및 markdown diff를 렌더링하는 Diffs
JSON 전용 워크플로 단계용 LLM Task
재개 가능한 승인으로 형식화된 워크플로를 제공하는 Lobster
노이즈가 많은 exec 및 bash 도구 출력을 압축하는 Tokenjuice
모든 스키마를 프롬프트에 넣지 않고 대규모 도구 카탈로그를 발견하고 호출하는 도구 검색
노드 Canvas 제어 및 A2UI 렌더링을 위한 Canvas

접근 및 승인 구성

도구 정책은 모델 호출 전에 적용됩니다. 정책이 도구를 제거하면, 모델은 해당 턴에 그 도구의 스키마를 받지 않습니다. 실행은 전역 구성, 에이전트별 구성, 채널 정책, 공급자 제한, 샌드박스 규칙, 소유자 전용 게이팅, 또는 Plugin 가용성 때문에 도구를 잃을 수 있습니다.

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

기능 확장

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

Plugin으로 기존 Plugin을 설치하거나 관리합니다.
Plugin 빌드로 새 통합, 공급자, 채널, 도구, 또는 훅을 빌드합니다.
Skills 및 Skills 만들기로 재사용 가능한 에이전트 지침을 추가하거나 조정합니다.
워크플로가 Plugin으로 배포되는 Skills 번들에 속할 때 Skills 워크숍으로 재사용 가능한 워크플로 자료를 패키징합니다.
구현 계약이 필요할 때 Plugin SDK 및 Plugin 매니페스트를 사용합니다.

누락된 도구 문제 해결

모델이 도구를 보거나 호출할 수 없다면, 현재 턴의 유효 정책부터 시작하세요.

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

개요