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, Crear Skills, y Taller de Skills |
| Añadir una nueva integración o superficie de tiempo de ejecución | Plugins | Plugins y Crear plugins |
| Ejecutar trabajo más tarde o en segundo plano | Automatización | Descripción general de 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, cambiar archivos, enviar mensajes, llamar a un proveedor u
operar otro sistema. Las herramientas visibles se envían al modelo como definiciones
estructuradas de funciones.El modelo solo ve las 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.Skills pueden residir en un espacio de trabajo, un directorio compartido de Skills, una raíz
gestionada de Skills de OpenClaw o un paquete de plugin.Skills | Taller de Skills | Crear Skills | Configuración de SkillsUsa 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 medios, búsqueda web, obtención web, hooks y otras
capacidades de tiempo de ejecución. Usa un plugin cuando la capacidad tenga 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 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 grupos exactos, valores predeterminados y semántica de permitir/denegar, usa Herramientas y proveedores personalizados.| Categoría | Úsala cuando el agente necesite… | Herramientas representativas | Leer a continuación |
|---|---|---|---|
| Tiempo de ejecución | Ejecutar comandos, gestionar procesos o usar análisis de Python respaldado por proveedor | exec, process, code_execution | Exec, Ejecución de código |
| Archivos | Leer y cambiar 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 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 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 de Gateway o dispositivos de destino emparejados | gateway, nodes | Configuración de Gateway, Nodos |
| Medios | Analizar, generar o vocalizar medios | image, image_generate, music_generate, video_generate, tts | Descripción general de medios |
| Catálogos grandes de OpenClaw | Buscar e invocar muchas herramientas elegibles sin enviar todos los esquemas al modelo | tool_search_code, tool_search, tool_describe | Búsqueda de herramientas |
Búsqueda de herramientas es una superficie experimental de agente de OpenClaw. Las ejecuciones del arnés Codex usan
modo de código nativo de Codex, búsqueda de herramientas nativa, herramientas dinámicas diferidas y
llamadas anidadas a herramientas 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
SDK de Plugin y Manifiesto de Plugin
para los detalles del contrato.
Las herramientas comunes proporcionadas por plugins incluyen:
- Diffs para renderizar diferencias de archivos y markdown
- Tarea LLM para pasos de flujo de trabajo solo JSON
- Lobster para flujos de trabajo tipados con aprobaciones reanudables
- Tokenjuice para compactar la salida ruidosa de 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 control de Canvas de Node y renderizado A2UI
Configurar 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 debido a la configuración global, la configuración por agente, la política de canal, las restricciones de proveedor, las reglas del sandbox, la política de canal/tiempo de ejecución o la 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 ajustes 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 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.
Ampliar capacidades
Elige la ruta de extensión según el trabajo que necesites que haga OpenClaw:- 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 de agente reutilizables con Skills y Crear Skills.
- Usa SDK de Plugin y Manifiesto de Plugin cuando necesites contratos de implementación.
Solucionar problemas de 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 modelo seleccionado admite la forma 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 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 grandes de OpenClaw, 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 flujo de tareas
- 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 la instalación y administración de plugins
- Plugin SDK para la referencia de autores de plugins
- Skills para el orden de carga, los controles de acceso y la configuración de Skills
- Taller de Skills para la creación de Skills generadas y revisadas
- Búsqueda de herramientas para el descubrimiento compacto del catálogo de herramientas de OpenClaw