Skip to main content
이 페이지를 사용하여 적절한 기능 표면을 선택하세요. 도구는 호출 가능한 작업이고, Skills는 에이전트에게 작업 방법을 가르치며, Plugin은 도구, 제공자, 채널, 훅, 패키징된 Skills 등의 런타임 기능을 추가합니다. 이 페이지는 개요 및 안내 페이지입니다. 도구 정책, 기본값, 그룹 구성, 제공자 제한 및 구성 필드에 대한 전체 내용은 도구 및 사용자 지정 제공자를 참조하세요.

​
여기서 시작하기

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

​
도구, Skills 또는 Plugin 선택하기

1

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

도구는 exec, browser, web_search, message, image_generate처럼 에이전트가 호출할 수 있는 형식화된 함수입니다. 에이전트가 데이터를 읽거나, 파일을 변경하거나, 메시지를 보내거나, 제공자를 호출하거나, 다른 시스템을 조작해야 할 때 도구를 사용하세요. 표시되는 도구는 구조화된 함수 정의로 모델에 전송됩니다.모델에는 활성 프로필, 허용/거부 정책, 제공자 제한, 샌드박스 상태, 채널 권한 및 Plugin 가용성을 모두 통과한 도구만 표시됩니다.
2

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

Skill은 에이전트 프롬프트에 로드되는 SKILL.md 지침 패키지입니다. 에이전트가 필요한 도구는 이미 갖추고 있지만 반복 가능한 워크플로, 검토 기준, 명령 순서 또는 운영 제약이 필요할 때 Skill을 사용하세요.Skills는 워크스페이스, 공유 Skill 디렉터리, 관리형 OpenClaw Skill 루트 또는 Plugin 패키지에 둘 수 있습니다.Skills | Skill 워크숍 | Skills 만들기 | Skills 구성
3

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

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

​
기본 제공 도구 범주

이 표에는 기능 표면을 파악할 수 있도록 대표적인 도구가 나열되어 있습니다. 전체 정책 참조 문서는 아닙니다. 정확한 그룹, 기본값 및 허용/거부 의미 체계는 도구 및 사용자 지정 제공자를 참조하세요.
도구 검색은 실험적인 OpenClaw 에이전트 표면입니다. Codex 하니스 실행에서는 tools.toolSearch 대신 Codex 네이티브 코드 모드, 네이티브 도구 검색, 지연된 동적 도구 및 중첩 도구 호출을 사용합니다.

​
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 가용성으로 인해 실행에서 도구가 제외될 수 있습니다.

​
기능 확장

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

​
누락된 도구 문제 해결

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

​
관련 항목