Usa esta página para elegir la superficie de capacidades adecuada. Tools son acciones invocables, Skills enseñan a los agentes cómo trabajar, y plugins agregan capacidades de runtime como herramientas, proveedores, canales, hooks y Skills empaquetadas. Esta es una página de resumen y enrutamiento. Para la política exhaustiva de herramientas, valores predeterminados, pertenencia a grupos, restricciones de proveedores y campos de configuración, usa Herramientas y proveedores personalizados.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.
Empieza aquí
Para la mayoría de los agentes, empieza con las categorías de herramientas integradas y luego ajusta la política solo cuando el agente deba ver menos herramientas o necesite acceso explícito al host.| Si necesitas… | Usa esto primero | Luego lee |
|---|---|---|
| Permitir que un agente actúe con capacidades existentes | Herramientas integradas | Categorías de herramientas |
| Controlar qué puede invocar un agente | Política de herramientas | Herramientas y proveedores personalizados |
| Enseñar un flujo de trabajo a un agente | Skills | Skills y Crear Skills |
| Agregar una nueva integración o superficie de runtime | Plugins | Plugins y Crear plugins |
| Ejecutar trabajo más tarde o en segundo plano | Automatización | Resumen de automatización |
| Coordinar varios agentes o harnesses | Subagentes | Agentes ACP y Envío de agentes |
| Buscar en un catálogo grande de herramientas PI | Búsqueda de herramientas | Búsqueda de herramientas |
Elige herramientas, Skills o plugins
Usa una herramienta cuando el agente necesite actuar
Una herramienta es una función tipada que el agente puede invocar, como
exec, browser,
web_search, message o image_generate. Usa herramientas cuando el agente
necesite leer datos, cambiar archivos, enviar mensajes, invocar un proveedor u operar
otro sistema. Las herramientas visibles se envían al modelo como definiciones de función
estructuradas.El modelo solo ve herramientas que sobreviven al perfil activo, la política de permitir/denegar,
las restricciones del proveedor, el estado del sandbox, los permisos del canal y la
disponibilidad de plugins.Usa una Skill cuando el agente necesite instrucciones
Una Skill es un paquete de instrucciones
SKILL.md cargado en el prompt del agente. Usa una
Skill cuando el agente ya tenga las herramientas que necesita, pero necesite un flujo de trabajo
repetible, una rúbrica de revisión, una secuencia de comandos o una restricción operativa.Las Skills pueden vivir en un workspace, un directorio compartido de Skills, la raíz administrada de Skills de OpenClaw
o un paquete de plugin.Skills | Crear Skills | Configuración de SkillsUsa un plugin cuando OpenClaw necesite una nueva capacidad
Un plugin puede agregar herramientas, Skills, canales, proveedores de modelos, voz, voz en tiempo real,
generación de medios, búsqueda web, obtención web, hooks y otras capacidades de runtime.
Usa un plugin cuando la capacidad tenga código, credenciales, hooks de ciclo de vida,
metadatos de manifiesto o empaquetado instalable. Los plugins existentes pueden instalarse desde
ClawHub, npm, git, directorios locales o archivos.Instalar y configurar plugins | Crear plugins | Plugin SDK
Categorías de herramientas integradas
La tabla enumera herramientas representativas para que puedas reconocer la superficie. No es la referencia completa de políticas. Para grupos exactos, valores predeterminados y semántica de permitir/denegar, usa Herramientas y proveedores personalizados.| Categoría | Usa cuando el agente necesite… | Herramientas representativas | Leer después |
|---|---|---|---|
| Runtime | Ejecutar comandos, gestionar procesos o usar análisis de Python respaldado por proveedores | exec, process, code_execution | Exec, Ejecución de código |
| Archivos | Leer y cambiar archivos del workspace | read, write, edit, apply_patch | Aplicar parche |
| Web | Buscar en la web, buscar publicaciones de X u obtener contenido legible de páginas | web_search, x_search, web_fetch | Herramientas web, Obtención web |
| Navegador | Operar una sesión de navegador | browser | Navegador |
| Mensajería y canales | Enviar respuestas o acciones de canal | message | Envío de agentes |
| Sesiones y agentes | Inspeccionar sesiones, delegar trabajo, dirigir otra ejecución o informar estado | sessions_*, subagents, agents_list, session_status | Subagentes, Herramienta de sesión |
| Automatización | Programar trabajo o responder a eventos en segundo plano | cron, heartbeat_respond | Automatización |
| Gateway y nodos | Inspeccionar el estado del Gateway o dispositivos de destino emparejados | gateway, nodes | Configuración del Gateway, Nodos |
| Medios | Analizar, generar o pronunciar medios | image, image_generate, music_generate, video_generate, tts | Resumen de medios |
| Catálogos PI grandes | Buscar e invocar muchas herramientas elegibles sin enviar todos los esquemas al modelo | tool_search_code, tool_search, tool_describe | Búsqueda de herramientas |
Tool Search es una superficie experimental de agente PI. Las ejecuciones del harness de Codex usan
modo de código nativo de Codex, búsqueda de herramientas nativa, herramientas dinámicas diferidas y llamadas
a herramientas anidadas en lugar de
tools.toolSearch.Herramientas proporcionadas por plugins
Los plugins pueden registrar herramientas adicionales. Los autores de plugins conectan herramientas medianteapi.registerTool(...) y contracts.tools del manifiesto; usa
Plugin SDK y Manifiesto de plugin
para los detalles del contrato.
Herramientas comunes proporcionadas por plugins incluyen:
- Diffs para renderizar diffs de archivos y Markdown
- LLM Task para pasos de flujo de trabajo solo JSON
- Lobster para flujos de trabajo tipados con aprobaciones reanudables
- Tokenjuice para compactar la salida ruidosa de las herramientas
execybash - Búsqueda de herramientas para descubrir e invocar catálogos grandes de herramientas sin poner todos los esquemas en el prompt
- Canvas para el control de Canvas de Node y el renderizado A2UI
Configura acceso y aprobaciones
La política de herramientas se aplica antes de la llamada al modelo. Si la política elimina una herramienta, el modelo no recibe el esquema de esa herramienta para el turno. Una ejecución puede perder herramientas por configuración global, configuración por agente, política de canal, restricciones de proveedor, reglas de sandbox, gating solo para propietarios o disponibilidad de plugins.- Herramientas y proveedores personalizados documenta perfiles de herramientas, listas de permitir/denegar, restricciones específicas de proveedores, detección de bucles y configuración de herramientas respaldadas por proveedores.
- Aprobaciones de exec documenta la política de aprobación de comandos del host.
- Exec elevado documenta la ejecución controlada fuera del sandbox.
- Sandbox vs política de herramientas vs elevado explica qué capa controla el acceso a archivos y procesos.
- Restricciones de sandbox y herramientas por agente documenta restricciones específicas de agente para ejecuciones delegadas.
Extiende capacidades
Elige la ruta de extensión según el trabajo que necesites que OpenClaw haga:- Instala o gestiona un plugin existente con Plugins.
- Crea una nueva integración, proveedor, canal, herramienta o hook con Crear plugins.
- Agrega o ajusta instrucciones reutilizables para agentes con Skills y Crear Skills.
- Empaqueta material de flujo de trabajo reutilizable con Taller de Skills cuando el flujo de trabajo pertenezca a un paquete de Skills distribuido por plugin.
- Usa Plugin SDK y Manifiesto de plugin cuando necesites contratos de implementación.
Soluciona herramientas faltantes
Si el modelo no puede ver o invocar una herramienta, empieza con la política efectiva para el turno actual:- Comprueba el perfil activo,
tools.allowytools.denyen Herramientas y proveedores personalizados. - Comprueba las restricciones específicas del proveedor en Herramientas y proveedores personalizados y confirma que el proveedor de modelos seleccionado admite la forma de la herramienta.
- Comprueba permisos de canal, estado del sandbox y acceso elevado con Sandbox vs política de herramientas vs elevado y Exec elevado.
- Comprueba si el plugin propietario está instalado y habilitado en Plugins.
- Para ejecuciones delegadas, comprueba las restricciones por agente en Restricciones de sandbox y herramientas por agente.
- Para catálogos PI grandes, confirma si la ejecución usa exposición directa de herramientas o Búsqueda de herramientas.
Relacionado
- Automatización para cron, tareas, heartbeat, compromisos, hooks, órdenes permanentes y Task Flow
- Agentes para el modelo de agente, sesiones, memoria y coordinación multiagente
- Herramientas y proveedores personalizados para la referencia canónica de políticas de herramientas
- Plugins para instalación y gestión de plugins
- Plugin SDK para la referencia de autores de plugins
- Skills para el orden de carga, gating y configuración de Skills
- Búsqueda de herramientas para descubrimiento compacto de catálogos PI de herramientas