Overview
Descripción general
Usa esta página para elegir la superficie de Capacidades adecuada. Las herramientas son acciones invocables, las Skills enseñan a los agentes cómo trabajar y los plugins añaden capacidades de ejecución, como herramientas, proveedores, canales, hooks y Skills empaquetadas.
Esta es una página de descripción general y orientación. Para consultar exhaustivamente la política de herramientas, los valores predeterminados, la pertenencia a grupos, las restricciones de proveedores y los campos de configuración, usa Herramientas y proveedores personalizados.
Empieza aquí
Para la mayoría de los agentes, empieza con las categorías de herramientas integradas y después ajusta la política solo cuando el agente deba ver menos herramientas o necesite acceso explícito al host.
| Si necesitas... | Usa primero esto | Después consulta |
|---|---|---|
| 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, Crear Skills y Taller de Skills |
| Añadir una nueva integración o superficie de ejecución | Plugins | Plugins y Crear plugins |
| Ejecutar trabajo más tarde o en segundo plano | Automatización | Descripción general de la automatización |
| Coordinar varios agentes o arneses | Subagentes | Agentes ACP y Envío de agente |
| Buscar en un catálogo grande de herramientas de OpenClaw | 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, modificar archivos, enviar mensajes, invocar a un proveedor u
operar otro sistema. Las herramientas visibles se envían al modelo como definiciones
de funciones estructuradas.
El modelo solo ve las herramientas que superan el perfil activo, la política de permitir/denegar, las restricciones del proveedor, el estado del sandbox, los permisos del canal y la disponibilidad de los 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 disponga de las herramientas necesarias, pero necesite un
flujo de trabajo repetible, criterios de revisión, una secuencia de comandos o una
restricción operativa.
Las Skills pueden residir en un espacio de trabajo, un directorio compartido de Skills, la raíz administrada de Skills de OpenClaw o un paquete de plugin.
Skills | Taller de Skills | Crear Skills | Configuración de Skills
Usa un plugin cuando OpenClaw necesite una capacidad nueva
Un plugin puede añadir herramientas, Skills, canales, proveedores de modelos, voz, voz en tiempo real, generación multimedia, búsqueda web, obtención de contenido web, hooks y otras capacidades de ejecución. Usa un plugin cuando la capacidad incluya código, credenciales, hooks de ciclo de vida, metadatos de manifiesto o un paquete instalable. Los plugins existentes pueden instalarse desde ClawHub, npm, git, directorios locales o archivos comprimidos.
Instalar y configurar plugins | Crear plugins | SDK de Plugin
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 consultar los grupos exactos, los valores predeterminados y la semántica de permitir/denegar, usa Herramientas y proveedores personalizados.
| Categoría | Úsala cuando el agente necesite... | Herramientas representativas | Consulta después |
|---|---|---|---|
| Ejecución | Ejecutar comandos, gestionar procesos o usar análisis de Python respaldado por un proveedor | exec, process, code_execution |
Exec, Ejecución de código |
| Archivos | Leer y modificar archivos del espacio de trabajo | 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 de contenido web |
| Navegador | Operar una sesión de navegador | browser |
Navegador |
| Mensajería y canales | Enviar respuestas o acciones de canal | message |
Envío de agente |
| Sesiones y agentes | Inspeccionar sesiones, delegar trabajo, dirigir otra ejecución o informar del estado | sessions_*, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
Objetivo, 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 |
| Multimedia | Analizar, generar o reproducir mediante voz contenido multimedia | image, image_generate, music_generate, video_generate, tts |
Descripción general de multimedia |
| Catálogos grandes de OpenClaw | Buscar e invocar muchas herramientas aptas sin enviar todos los esquemas al modelo | tool_search_code, tool_search, tool_describe |
Búsqueda de herramientas |
Herramientas proporcionadas por plugins
Los plugins pueden registrar herramientas adicionales. Los autores de plugins conectan las herramientas mediante
api.registerTool(...) y contracts.tools del manifiesto; consulta
SDK de Plugin y Manifiesto de Plugin
para obtener detalles de los contratos.
Entre las herramientas comunes proporcionadas por plugins se incluyen:
- Diferencias para representar diferencias de archivos y Markdown
- Mostrar widget para SVG y HTML autocontenidos e integrados en el chat web
- Tarea de LLM para pasos de flujos de trabajo exclusivamente en 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 incluir todos los esquemas en el prompt
- Canvas para controlar Canvas en nodos y representar A2UI
Configura el acceso y las 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 durante el turno. Una ejecución puede perder herramientas debido a la configuración global, la configuración específica del agente, la política del canal, las restricciones del proveedor, las reglas del sandbox, la política del canal o del entorno de ejecución, o la disponibilidad de los plugins.
- Herramientas y proveedores personalizados documenta los perfiles de herramientas, las listas de permitir/denegar, las restricciones específicas de cada proveedor, la detección de bucles y la 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 frente a política de herramientas frente a acceso elevado explica qué capa controla el acceso a archivos y procesos.
- Sandbox y restricciones de herramientas por agente documenta las restricciones específicas del agente para ejecuciones delegadas.
Amplía las capacidades
Elige la vía de ampliación según la tarea que necesites que OpenClaw realice:
- Instala o gestiona un plugin existente con Plugins.
- Crea una nueva integración, proveedor, canal, herramienta o hook con Crear plugins.
- Añade o ajusta instrucciones reutilizables para agentes con Skills y Crear Skills.
- Usa SDK de Plugin y Manifiesto de Plugin cuando necesites contratos de implementación.
Soluciona problemas de herramientas ausentes
Si el modelo no puede ver o invocar una herramienta, empieza por la política efectiva del 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 estructura de la herramienta.
- Comprueba los permisos del canal, el estado del sandbox y el acceso elevado con Sandbox frente a política de herramientas frente a acceso elevado y Exec elevado.
- Comprueba si el plugin propietario está instalado y habilitado en Plugins.
- Para ejecuciones delegadas, comprueba las restricciones por agente en Sandbox y restricciones de herramientas por agente.
- Para catálogos grandes de OpenClaw, confirma si la ejecución usa la exposición directa de herramientas o la Búsqueda de herramientas.
Contenido relacionado
- Automatización para Cron, tareas, Heartbeat, compromisos, hooks, órdenes permanentes y TaskFlow
- Agentes para el modelo de agente, las sesiones, la memoria y la coordinación multiagente
- Herramientas y proveedores personalizados como referencia canónica de políticas de herramientas
- Plugins para instalar y gestionar plugins
- SDK de Plugin como referencia para autores de plugins
- Skills para el orden de carga, las restricciones y la configuración de Skills
- Taller de Skills para crear Skills generadas y revisadas
- Búsqueda de herramientas para descubrir el catálogo compacto de herramientas de OpenClaw
