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 |
| 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 múltiples 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 de función
estructuradas.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.Las Skills pueden estar en un workspace, un directorio compartido de Skills, una raíz administrada 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 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 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 grupos exactos, valores predeterminados y semántica de permitir/denegar, usa Herramientas y proveedores personalizados.| Categoría | Úsala cuando el agente necesite… | Herramientas representativas | Lee a continuación |
|---|---|---|---|
| Runtime | 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 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 agente |
| Sesiones y agentes | Inspeccionar sesiones, delegar trabajo, dirigir otra ejecución o informar estado | sessions_*, subagents, agents_list, session_status, 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 objetivo 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 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
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
SDK de Plugin y Manifiesto de Plugin
para detalles del contrato.
Las herramientas comunes proporcionadas por plugins incluyen:
- Diferencias 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 cada esquema en el prompt
- Canvas para control de Canvas de nodo y 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 la configuración global, la configuración por agente, la política de canal, las restricciones del proveedor, las reglas del sandbox, la política de canal/runtime o la disponibilidad de plugins.- Herramientas y proveedores personalizados documenta perfiles de herramientas, listas de permitir/denegar, restricciones específicas de proveedor, detección de bucles y configuración de herramientas respaldadas por proveedor.
- 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 de agente con Skills y Crear Skills.
- Usa SDK de Plugin y Manifiesto de Plugin cuando necesites contratos de implementación.
Soluciona problemas de herramientas faltantes
Si el modelo no puede ver o invocar una herramienta, empieza con la política efectiva para el turno actual:- Revisa el perfil activo,
tools.allowytools.denyen Herramientas y proveedores personalizados. - Revisa 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.
- Revisa permisos de canal, estado del sandbox y acceso elevado con Sandbox vs política de herramientas vs elevado y Exec elevado.
- Revisa si el plugin propietario está instalado y habilitado en Plugins.
- Para ejecuciones delegadas, revisa 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 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
- SDK de Plugin para la referencia de autores de plugins
- Skills para orden de carga, control y configuración de Skills
- Taller de Skills para creación de Skills generada y revisada
- Búsqueda de herramientas para descubrimiento compacto de catálogos de herramientas de OpenClaw