메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

이 페이지를 사용하여 올바른 Capabilities 표면을 선택하세요. 도구는 호출 가능한 작업이고, Skills는 에이전트에게 작업 방법을 가르치며, Plugin은 도구, 공급자, 채널, 훅, 패키지된 Skills 같은 런타임 기능을 추가합니다. 이 문서는 개요 및 라우팅 페이지입니다. 전체 도구 정책, 기본값, 그룹 멤버십, 공급자 제한, 구성 필드는 도구 및 사용자 지정 공급자를 사용하세요.

​
여기서 시작하기

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

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

1

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

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

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

Skills는 에이전트 프롬프트에 로드되는 SKILL.md 지침 팩입니다. 에이전트가 필요한 도구를 이미 갖고 있지만 반복 가능한 워크플로, 검토 기준, 명령 시퀀스, 또는 운영 제약이 필요할 때 Skills를 사용하세요.Skills는 워크스페이스, 공유 Skills 디렉터리, 관리형 OpenClaw Skills 루트, 또는 Plugin 패키지에 위치할 수 있습니다.Skills | 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_patchApply patch
웹웹 검색, X 게시물 검색, 또는 읽을 수 있는 페이지 콘텐츠 가져오기web_search, x_search, web_fetch웹 도구, 웹 가져오기
브라우저브라우저 세션 조작browser브라우저
메시징 및 채널답장 또는 채널 작업 보내기message에이전트 보내기
세션 및 에이전트세션 검사, 작업 위임, 다른 실행 조정, 또는 상태 보고sessions_*, subagents, agents_list, session_status하위 에이전트, 세션 도구
자동화작업 예약 또는 백그라운드 이벤트에 응답cron, heartbeat_respond자동화
Gateway 및 노드Gateway 상태 또는 페어링된 대상 장치 검사gateway, nodesGateway 구성, 노드
미디어미디어 분석, 생성 또는 말하기image, image_generate, music_generate, video_generate, tts미디어 개요
대규모 PI 카탈로그모든 스키마를 모델에 보내지 않고 많은 적격 도구 검색 및 호출tool_search_code, tool_search, tool_describe도구 검색
도구 검색은 실험적인 PI 에이전트 표면입니다. 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가 수행해야 하는 작업에 따라 확장 경로를 선택하세요.
  • Plugin으로 기존 Plugin을 설치하거나 관리합니다.
  • Plugin 빌드로 새 통합, 공급자, 채널, 도구, 또는 훅을 빌드합니다.
  • Skills 및 Skills 만들기로 재사용 가능한 에이전트 지침을 추가하거나 조정합니다.
  • 워크플로가 Plugin으로 배포되는 Skills 번들에 속할 때 Skills 워크숍으로 재사용 가능한 워크플로 자료를 패키징합니다.
  • 구현 계약이 필요할 때 Plugin SDK 및 Plugin 매니페스트를 사용합니다.

​
누락된 도구 문제 해결

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

​
관련 항목