Empiece aquí
Para la mayoría de los agentes, empiece con las categorías de herramientas integradas y, después, ajuste la política solo cuando el agente deba ver menos herramientas o necesite acceso explícito al host.Elija herramientas, Skills o plugins
1
Use 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. Use 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
permisos y denegaciones, las restricciones del proveedor, el estado del entorno aislado, los permisos del canal y
la disponibilidad de los plugins.2
Use una Skill cuando el agente necesite instrucciones
Una Skill es un paquete de instrucciones
SKILL.md que se carga en el prompt del agente. Use
una Skill cuando el agente ya tenga las herramientas que necesita, pero requiera 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 | Autoaprendizaje | Creación de Skills | Configuración de Skills3
Use un plugin cuando OpenClaw necesite una nueva capacidad
Un plugin puede añadir herramientas, Skills, canales, proveedores de modelos, voz,
voz en tiempo real, generación de contenido multimedia, búsqueda web, obtención de contenido web, hooks y otras
capacidades de tiempo de ejecución. Use un plugin cuando la capacidad incluya código,
credenciales, hooks de ciclo de vida, metadatos de manifiesto o
empaquetado instalable. Los plugins existentes se pueden instalar desde ClawHub, npm, git,
directorios locales o archivos.Instalar y configurar plugins | Crear plugins | SDK de plugins
Categorías de herramientas integradas
La tabla enumera herramientas representativas para facilitar el reconocimiento de la superficie. No es la referencia completa de políticas. Para consultar los grupos exactos, los valores predeterminados y la semántica de permisos y denegaciones, consulte Herramientas y proveedores personalizados.El Modo de código y la Búsqueda de herramientas son superficies experimentales para agentes de OpenClaw. Las ejecuciones del entorno
Codex usan el modo de código nativo de Codex, la búsqueda de herramientas nativa, herramientas dinámicas
diferidas e invocaciones de herramientas anidadas en lugar de
tools.codeMode o tools.toolSearch.Herramientas proporcionadas por plugins
Los plugins pueden registrar herramientas adicionales. Los autores de plugins conectan las herramientas medianteapi.registerTool(...) y el campo contracts.tools del manifiesto; consulte
SDK de plugins y Manifiesto de plugins
para obtener los detalles del contrato.
Entre las herramientas proporcionadas habitualmente por plugins se incluyen:
- Diferencias para renderizar diferencias de archivos y Markdown
- Mostrar widget para SVG y HTML integrados y autocontenidos en clientes de chat compatibles
- Pantalla para organizar una interfaz de control conectada
- Tarea de LLM para pasos de flujo de trabajo que solo usan 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 y llamar a grandes catálogos de herramientas sin incluir cada esquema en el prompt
- Canvas para controlar Canvas de Node y renderizar A2UI
Configurar 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 por 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 permitidos y denegados, las restricciones específicas del proveedor, la detección de bucles y la configuración de herramientas respaldadas por proveedores.
- Aprobaciones de ejecución documenta la política de aprobación de comandos del host.
- Ejecución elevada documenta la ejecución controlada fuera del sandbox.
- Sandbox frente a política de herramientas frente a ejecución elevada explica qué capa controla el acceso a archivos y procesos.
- Restricciones de sandbox y herramientas por agente documenta las restricciones específicas de cada agente para las ejecuciones delegadas.
Ampliar las capacidades
Elija la vía de extensión según la tarea que necesite que OpenClaw realice:- Instale o administre un plugin existente con Plugins.
- Cree una nueva integración, proveedor, canal, herramienta o hook con Crear plugins.
- Añada o ajuste instrucciones reutilizables para agentes con Skills y Crear Skills.
- Use el SDK de plugins y el manifiesto de plugins cuando necesite contratos de implementación.
Solucionar problemas de herramientas ausentes
Si el modelo no puede ver o llamar a una herramienta, comience por la política efectiva del turno actual:- Compruebe el perfil activo,
tools.allowytools.denyen Herramientas y proveedores personalizados. - Compruebe las restricciones específicas del proveedor en Herramientas y proveedores personalizados y confirme que el proveedor del modelo seleccionado admite la estructura de la herramienta.
- Compruebe los permisos del canal, el estado del sandbox y el acceso elevado con Sandbox frente a política de herramientas frente a ejecución elevada y Ejecución elevada.
- Compruebe si el plugin propietario está instalado y habilitado en Plugins.
- Para las ejecuciones delegadas, compruebe las restricciones por agente en Restricciones de sandbox y herramientas por agente.
- Para catálogos grandes de OpenClaw, confirme si la ejecución usa la exposición directa de herramientas, el modo de código o la búsqueda de herramientas.
Temas relacionados
- Automatización para cron, tareas, heartbeat, hooks, órdenes permanentes y flujo de tareas
- Agentes para el modelo de agentes, las sesiones, la memoria y la coordinación multiagente
- Herramientas y proveedores personalizados como referencia canónica de la política de herramientas
- Plugins para instalar y administrar plugins
- SDK de plugins como referencia para autores de plugins
- Skills para el orden de carga, las condiciones de activación y la configuración de las Skills
- Taller de Skills para crear Skills generadas y revisadas
- Búsqueda de herramientas para descubrir de forma compacta el catálogo de herramientas de OpenClaw
- Modo de código para flujos de trabajo compactos de JavaScript o TypeScript sobre un catálogo oculto de herramientas de OpenClaw
- Enjambre para la distribución y recopilación estructuradas desde el modo de código