메인 콘텐츠로 건너뛰기
이 페이지를 사용해 적절한 기능 표면을 선택하세요. 도구는 호출 가능한 동작이고, Skills는 에이전트에게 작업 방법을 가르치며, Plugin은 도구, 프로바이더, 채널, 훅, 패키징된 Skills 같은 런타임 기능을 추가합니다. 이 문서는 개요 및 라우팅 페이지입니다. 전체 도구 정책, 기본값, 그룹 구성원, 프로바이더 제한, 구성 필드는 도구 및 사용자 지정 프로바이더를 참조하세요.

​
여기서 시작하세요

대부분의 에이전트는 내장 도구 범주에서 시작한 다음, 에이전트가 더 적은 도구만 보거나 명시적인 호스트 접근이 필요할 때만 정책을 조정하세요.
필요한 작업이…먼저 사용할 항목다음으로 읽을 항목
에이전트가 기존 기능으로 동작하게 하기내장 도구도구 범주
에이전트가 호출할 수 있는 항목 제어하기도구 정책도구 및 사용자 지정 프로바이더
에이전트에게 워크플로 가르치기SkillsSkills, Skills 만들기, Skill Workshop
새 통합 또는 런타임 표면 추가하기PluginPlugin 및 Plugin 빌드
나중에 또는 백그라운드에서 작업 실행하기자동화자동화 개요
여러 에이전트 또는 하네스 조정하기하위 에이전트ACP 에이전트 및 에이전트 전송
대규모 OpenClaw 도구 카탈로그 검색하기도구 검색도구 검색

​
도구, Skills, Plugin 선택

1

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

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

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

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

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

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

​
내장 도구 범주

이 표는 표면을 알아볼 수 있도록 대표 도구를 나열합니다. 전체 정책 참조가 아닙니다. 정확한 그룹, 기본값, 허용/거부 의미 체계는 도구 및 사용자 지정 프로바이더를 참조하세요.
범주에이전트에 필요한 작업이…대표 도구다음으로 읽기
런타임명령 실행, 프로세스 관리, 또는 프로바이더 기반 Python 분석 사용exec, process, code_executionExec, 코드 실행
파일워크스페이스 파일 읽기 및 변경read, write, edit, apply_patch패치 적용
웹웹 검색, X 게시물 검색, 또는 읽을 수 있는 페이지 콘텐츠 가져오기web_search, x_search, web_fetch웹 도구, 웹 가져오기
브라우저브라우저 세션 조작browser브라우저
메시징 및 채널응답 또는 채널 동작 보내기message에이전트 전송
세션 및 에이전트세션 검사, 작업 위임, 다른 실행 조정, 또는 상태 보고sessions_*, subagents, agents_list, session_status, goal목표, 하위 에이전트, 세션 도구
자동화작업 예약 또는 백그라운드 이벤트 응답cron, heartbeat_respond자동화
Gateway 및 노드Gateway 상태 또는 페어링된 대상 장치 검사gateway, nodesGateway 구성, 노드
미디어미디어 분석, 생성, 또는 말하기image, image_generate, music_generate, video_generate, tts미디어 개요
대규모 OpenClaw 카탈로그모든 스키마를 모델에 보내지 않고 적격 도구 다수를 검색하고 호출tool_search_code, tool_search, tool_describe도구 검색
도구 검색은 실험적인 OpenClaw 에이전트 표면입니다. Codex 하네스 실행은 tools.toolSearch 대신 Codex 네이티브 코드 모드, 네이티브 도구 검색, 지연 동적 도구, 중첩 도구 호출을 사용합니다.

​
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 가용성 때문에 도구를 잃을 수 있습니다.

​
기능 확장

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

​
누락된 도구 문제 해결

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

​
관련 문서