> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 개요 이 페이지를 사용해 적절한 기능 표면을 선택하세요. **도구**는 호출 가능한 동작이고, **Skills**는 에이전트에게 작업 방법을 가르치며, **Plugin**은 도구, 프로바이더, 채널, 훅, 패키징된 Skills 같은 런타임 기능을 추가합니다. 이 문서는 개요 및 라우팅 페이지입니다. 전체 도구 정책, 기본값, 그룹 구성원, 프로바이더 제한, 구성 필드는 [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools)를 참조하세요. ## 여기서 시작하세요 대부분의 에이전트는 내장 도구 범주에서 시작한 다음, 에이전트가 더 적은 도구만 보거나 명시적인 호스트 접근이 필요할 때만 정책을 조정하세요. | 필요한 작업이... | 먼저 사용할 항목 | 다음으로 읽을 항목 | | ------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | 에이전트가 기존 기능으로 동작하게 하기 | [내장 도구](#built-in-tool-categories) | [도구 범주](#built-in-tool-categories) | | 에이전트가 호출할 수 있는 항목 제어하기 | [도구 정책](#configure-access-and-approvals) | [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools) | | 에이전트에게 워크플로 가르치기 | [Skills](#choose-tools-skills-or-plugins) | [Skills](/ko/tools/skills), [Skills 만들기](/ko/tools/creating-skills), [Skill Workshop](/ko/tools/skill-workshop) | | 새 통합 또는 런타임 표면 추가하기 | [Plugin](#extend-capabilities) | [Plugin](/ko/tools/plugin) 및 [Plugin 빌드](/ko/plugins/building-plugins) | | 나중에 또는 백그라운드에서 작업 실행하기 | [자동화](/ko/automation) | [자동화 개요](/ko/automation) | | 여러 에이전트 또는 하네스 조정하기 | [하위 에이전트](/ko/tools/subagents) | [ACP 에이전트](/ko/tools/acp-agents) 및 [에이전트 전송](/ko/tools/agent-send) | | 대규모 OpenClaw 도구 카탈로그 검색하기 | [도구 검색](/ko/tools/tool-search) | [도구 검색](/ko/tools/tool-search) | ## 도구, Skills, Plugin 선택 도구는 `exec`, `browser`, `web_search`, `message`, `image_generate`처럼 에이전트가 호출할 수 있는 형식화된 함수입니다. 에이전트가 데이터를 읽거나, 파일을 변경하거나, 메시지를 보내거나, 프로바이더를 호출하거나, 다른 시스템을 조작해야 할 때 도구를 사용하세요. 표시되는 도구는 구조화된 함수 정의로 모델에 전송됩니다. 모델은 활성 프로필, 허용/거부 정책, 프로바이더 제한, 샌드박스 상태, 채널 권한, Plugin 가용성을 통과한 도구만 볼 수 있습니다. Skill은 에이전트 프롬프트에 로드되는 `SKILL.md` 지침 패키지입니다. 에이전트가 필요한 도구는 이미 갖고 있지만 반복 가능한 워크플로, 리뷰 기준, 명령 시퀀스, 운영 제약이 필요할 때 Skill을 사용하세요. Skills는 워크스페이스, 공유 Skill 디렉터리, 관리형 OpenClaw Skill 루트, 또는 Plugin 패키지에 둘 수 있습니다. [Skills](/ko/tools/skills) | [Skill Workshop](/ko/tools/skill-workshop) | [Skills 만들기](/ko/tools/creating-skills) | [Skills 구성](/ko/tools/skills-config) Plugin은 도구, Skills, 채널, 모델 프로바이더, 음성, 실시간 음성, 미디어 생성, 웹 검색, 웹 가져오기, 훅 및 기타 런타임 기능을 추가할 수 있습니다. 기능에 코드, 자격 증명, 수명 주기 훅, 매니페스트 메타데이터, 또는 설치 가능한 패키징이 있을 때 Plugin을 사용하세요. 기존 Plugin은 ClawHub, npm, git, 로컬 디렉터리, 또는 아카이브에서 설치할 수 있습니다. [Plugin 설치 및 구성](/ko/tools/plugin) | [Plugin 빌드](/ko/plugins/building-plugins) | [Plugin SDK](/ko/plugins/sdk-overview) ## 내장 도구 범주 이 표는 표면을 알아볼 수 있도록 대표 도구를 나열합니다. 전체 정책 참조가 아닙니다. 정확한 그룹, 기본값, 허용/거부 의미 체계는 [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools)를 참조하세요. | 범주 | 에이전트에 필요한 작업이... | 대표 도구 | 다음으로 읽기 | | ----------------- | ---------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | 런타임 | 명령 실행, 프로세스 관리, 또는 프로바이더 기반 Python 분석 사용 | `exec`, `process`, `code_execution` | [Exec](/ko/tools/exec), [코드 실행](/ko/tools/code-execution) | | 파일 | 워크스페이스 파일 읽기 및 변경 | `read`, `write`, `edit`, `apply_patch` | [패치 적용](/ko/tools/apply-patch) | | 웹 | 웹 검색, X 게시물 검색, 또는 읽을 수 있는 페이지 콘텐츠 가져오기 | `web_search`, `x_search`, `web_fetch` | [웹 도구](/ko/tools/web), [웹 가져오기](/ko/tools/web-fetch) | | 브라우저 | 브라우저 세션 조작 | `browser` | [브라우저](/ko/tools/browser) | | 메시징 및 채널 | 응답 또는 채널 동작 보내기 | `message` | [에이전트 전송](/ko/tools/agent-send) | | 세션 및 에이전트 | 세션 검사, 작업 위임, 다른 실행 조정, 또는 상태 보고 | `sessions_*`, `subagents`, `agents_list`, `session_status`, `goal` | [목표](/ko/tools/goal), [하위 에이전트](/ko/tools/subagents), [세션 도구](/ko/concepts/session-tool) | | 자동화 | 작업 예약 또는 백그라운드 이벤트 응답 | `cron`, `heartbeat_respond` | [자동화](/ko/automation) | | Gateway 및 노드 | Gateway 상태 또는 페어링된 대상 장치 검사 | `gateway`, `nodes` | [Gateway 구성](/ko/gateway/configuration), [노드](/ko/nodes) | | 미디어 | 미디어 분석, 생성, 또는 말하기 | `image`, `image_generate`, `music_generate`, `video_generate`, `tts` | [미디어 개요](/ko/tools/media-overview) | | 대규모 OpenClaw 카탈로그 | 모든 스키마를 모델에 보내지 않고 적격 도구 다수를 검색하고 호출 | `tool_search_code`, `tool_search`, `tool_describe` | [도구 검색](/ko/tools/tool-search) | 도구 검색은 실험적인 OpenClaw 에이전트 표면입니다. Codex 하네스 실행은 `tools.toolSearch` 대신 Codex 네이티브 코드 모드, 네이티브 도구 검색, 지연 동적 도구, 중첩 도구 호출을 사용합니다. ## Plugin 제공 도구 Plugin은 추가 도구를 등록할 수 있습니다. Plugin 작성자는 `api.registerTool(...)`과 매니페스트의 `contracts.tools`를 통해 도구를 연결합니다. 계약 세부 정보는 [Plugin SDK](/ko/plugins/sdk-overview) 및 [Plugin 매니페스트](/ko/plugins/manifest)를 참조하세요. 일반적인 Plugin 제공 도구는 다음과 같습니다. * 파일 및 Markdown diff를 렌더링하는 [Diffs](/ko/tools/diffs) * JSON 전용 워크플로 단계용 [LLM Task](/ko/tools/llm-task) * 재개 가능한 승인 기능이 있는 형식화된 워크플로용 [Lobster](/ko/tools/lobster) * 시끄러운 `exec` 및 `bash` 도구 출력을 압축하는 [Tokenjuice](/ko/tools/tokenjuice) * 프롬프트에 모든 스키마를 넣지 않고 대규모 도구 카탈로그를 발견하고 호출하는 [도구 검색](/ko/tools/tool-search) * 노드 Canvas 제어 및 A2UI 렌더링용 [Canvas](/ko/plugins/reference/canvas) ## 접근 및 승인 구성 도구 정책은 모델 호출 전에 적용됩니다. 정책이 도구를 제거하면 모델은 해당 턴에 그 도구의 스키마를 받지 않습니다. 실행은 전역 구성, 에이전트별 구성, 채널 정책, 프로바이더 제한, 샌드박스 규칙, 채널/런타임 정책, 또는 Plugin 가용성 때문에 도구를 잃을 수 있습니다. * [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools)는 도구 프로필, 허용/거부 목록, 프로바이더별 제한, 루프 감지, 프로바이더 기반 도구 설정을 문서화합니다. * [Exec 승인](/ko/tools/exec-approvals)은 호스트 명령 승인 정책을 문서화합니다. * [상승된 exec](/ko/tools/elevated)는 샌드박스 밖의 제어된 실행을 문서화합니다. * [샌드박스 vs 도구 정책 vs 상승됨](/ko/gateway/sandbox-vs-tool-policy-vs-elevated)은 어떤 계층이 파일 및 프로세스 접근을 제어하는지 설명합니다. * [에이전트별 샌드박스 및 도구 제한](/ko/tools/multi-agent-sandbox-tools)은 위임된 실행의 에이전트별 제한을 문서화합니다. ## 기능 확장 OpenClaw가 수행해야 하는 작업에 따라 확장 경로를 선택하세요. * [Plugin](/ko/tools/plugin)으로 기존 Plugin을 설치하거나 관리합니다. * [Plugin 빌드](/ko/plugins/building-plugins)로 새 통합, 프로바이더, 채널, 도구, 또는 훅을 만듭니다. * [Skills](/ko/tools/skills) 및 [Skills 만들기](/ko/tools/creating-skills)로 재사용 가능한 에이전트 지침을 추가하거나 조정합니다. * 구현 계약이 필요할 때 [Plugin SDK](/ko/plugins/sdk-overview) 및 [Plugin 매니페스트](/ko/plugins/manifest)를 사용합니다. ## 누락된 도구 문제 해결 모델이 도구를 보거나 호출할 수 없다면 현재 턴의 유효 정책부터 확인하세요. 1. [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools)에서 활성 프로필, `tools.allow`, `tools.deny`를 확인합니다. 2. [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools)에서 프로바이더별 제한을 확인하고 선택한 [모델 프로바이더](/ko/concepts/model-providers)가 해당 도구 형태를 지원하는지 확인합니다. 3. [샌드박스 vs 도구 정책 vs 상승됨](/ko/gateway/sandbox-vs-tool-policy-vs-elevated) 및 [상승된 exec](/ko/tools/elevated)로 채널 권한, 샌드박스 상태, 상승된 접근을 확인합니다. 4. [Plugin](/ko/tools/plugin)에서 소유 Plugin이 설치되어 있고 활성화되어 있는지 확인합니다. 5. 위임된 실행의 경우 [에이전트별 샌드박스 및 도구 제한](/ko/tools/multi-agent-sandbox-tools)에서 에이전트별 제한을 확인합니다. 6. 대규모 OpenClaw 카탈로그의 경우 실행이 직접 도구 노출을 사용하는지 또는 [도구 검색](/ko/tools/tool-search)을 사용하는지 확인합니다. ## 관련 문서 * cron, 작업, heartbeat, 약속, 훅, 상시 지시, TaskFlow에 대한 [자동화](/ko/automation) * 에이전트 모델, 세션, 메모리, 다중 에이전트 조정에 대한 [에이전트](/ko/concepts/agent) * 표준 도구 정책 참조인 [도구 및 사용자 지정 프로바이더](/ko/gateway/config-tools) * Plugin 설치 및 관리에 대한 [Plugin](/ko/tools/plugin) * Plugin 작성자 참조용 [Plugin SDK](/ko/plugins/sdk-overview) * Skill 로드 순서, 게이팅, 구성에 대한 [Skills](/ko/tools/skills) * 생성 및 검토된 Skill 만들기를 위한 [Skill Workshop](/ko/tools/skill-workshop) * 압축된 OpenClaw 도구 카탈로그 발견을 위한 [도구 검색](/ko/tools/tool-search)