Descripción general
Utilice esta página para elegir la superficie de Capacidades adecuada. Las herramientas son acciones invocables, las habilidades enseñan a los agentes cómo trabajar y los complementos añaden capacidades de tiempo de ejecución, como herramientas, proveedores, canales, ganchos y habilidades empaquetadas.
Esta es una página de resumen y enrutamiento. Para obtener una política de herramientas exhaustiva, valores predeterminados, membresía de grupo, restricciones de proveedor y campos de configuración, utilice Herramientas y proveedores personalizados.
Comience aquí
Sección titulada «Comience aquí»Para la mayoría de los agentes, comience con las categorías de herramientas integradas y luego ajuste la política únicamente cuando el agente deba ver menos herramientas o necesite acceso explícito al host.
| Si necesita… | Use esto primero | Luego lea |
|---|---|---|
| Permitir que un agente actúe con capacidades existentes | Herramientas integradas | Categorías de herramientas |
| Controlar lo que un agente puede llamar | Política de herramientas | Herramientas y proveedores personalizados |
| Enseñar un flujo de trabajo a un agente | Habilidades | Habilidades, Crear habilidades y Taller de habilidades |
| Añadir una nueva integración o superficie de tiempo de ejecución | Plugins | Plugins y Compilar plugins |
| Ejecutar trabajo más tarde o en segundo plano | Automatización | Descripción general 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 |
Elegir herramientas, habilidades o complementos
Sección titulada «Elegir herramientas, habilidades o complementos»Usar una herramienta cuando el agente necesite actuar
Una herramienta es una función tipada que el agente puede llamar, como
exec,browser,web_search,messageoimage_generate. Use 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 funciones 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 del complemento.
Use una habilidad cuando el agente necesite instrucciones
Una habilidad es un paquete de instrucciones
SKILL.mdcargado en el mensaje del agente. Use una habilidad 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 habilidades pueden residir en un espacio de trabajo, un directorio de habilidades compartidas, una raíz de habilidades de OpenClaw administrada o un paquete de plugins.
Habilidades | Taller de habilidades | Crear habilidades | Configuración de habilidades
Use un plugin cuando OpenClaw necesite una nueva capacidad
Un plugin puede añadir herramientas, habilidades, canales, proveedores de modelos, voz, voz en tiempo real, generación de medios, búsqueda web, obtención web, enlaces y otras capacidades de tiempo de ejecución. Use un plugin cuando la capacidad tenga código, credenciales, enlaces 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 | Compilar plugins | SDK de plugins
Categorías de herramientas integradas
Sección titulada «Categorías de herramientas integradas»La tabla enumera herramientas representativas para que pueda reconocer la superficie. No es la referencia completa de la política. Para grupos exactos, valores predeterminados y semánticas de permitir/denegar, use Herramientas y proveedores personalizados.
| Categoría | Usar cuando el agente necesite… | Herramientas representativas | Leer siguiente |
|---|---|---|---|
| Tiempo de ejecución | Ejecute comandos, gestione procesos o use análisis de Python respaldado por proveedores | exec, process, code_execution | Exec, Code execution |
| Archivos | Leer y cambiar archivos del espacio de trabajo | read, write, edit, apply_patch | Apply patch |
| Web | Buscar en la web, buscar publicaciones en X u obtener contenido de página legible | web_search, x_search, web_fetch | Web tools, Web fetch |
| Navegador | Operar una sesión de navegador | browser | Browser |
| Mensajería y canales | Enviar respuestas o acciones de canal | message | Agent send |
| Sesiones y agentes | Inspeccionar sesiones, delegar trabajo, dirigir otra ejecución o reportar estado | sessions_*, subagents, agents_list, session_status, goal | Goal, Sub-agents, Session tool |
| Automatización | Programar trabajo o responder a eventos en segundo plano | cron, heartbeat_respond | Automation |
| Puerta de enlace y nodos | Inspeccionar el estado de la puerta de enlace o los dispositivos de destino emparejados | gateway, nodes | Gateway configuration, Nodes |
| Medios | Analizar, generar o reproducir medios | image, image_generate, music_generate, video_generate, tts | Media overview |
| Catálogos grandes de OpenClaw | Buscar y llamar a muchas herramientas elegibles sin enviar cada esquema al modelo | tool_search_code, tool_search, tool_describe | Tool Search |
Herramientas proporcionadas por complementos
Sección titulada «Herramientas proporcionadas por complementos»Los plugins pueden registrar herramientas adicionales. Los autores de plugins conectan las herramientas a través de
api.registerTool(...) y el contracts.tools del manifiesto; utilice
Plugin SDK y Plugin manifest
para obtener detalles del contrato.
Las herramientas comunes proporcionadas por complementos 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 ruidosa salida de la herramienta
execybash - Tool Search para descubrir y llamar a catálogos de herramientas grandes sin poner cada esquema en el prompt
- Canvas para el control de Canvas de nodos y el renderizado de A2UI
Configurar el acceso y las aprobaciones
Sección titulada «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 para 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 entorno sandbox, la política del canal/tiempo de ejecución o la disponibilidad de complementos.
- Tools and custom providers documenta los perfiles de herramientas, listas de permiso/denegación, restricciones específicas del proveedor, detección de bucles y configuraciones de herramientas respaldadas por el proveedor.
- Exec approvals documenta la política de aprobación de comandos del host.
- Elevated exec documenta la ejecución controlada fuera del sandbox.
- Sandbox vs tool policy vs elevated explica qué capa controla el acceso a archivos y procesos.
- Per-agent sandbox and tool restrictions documenta las restricciones específicas del agente para ejecuciones delegadas.
Ampliar capacidades
Sección titulada «Ampliar capacidades»Elija la ruta de extensión según la tarea que necesite que realice OpenClaw:
- Instale o administre un complemento existente con Plugins.
- Cree una nueva integración, proveedor, canal, herramienta o enlace con Build plugins.
- Añada o ajuste las instrucciones reutilizables del agente con Skills y Creating skills.
- Use Plugin SDK y Plugin manifest cuando necesite contratos de implementación.
Solucionar problemas de herramientas que faltan
Sección titulada «Solucionar problemas de herramientas que faltan»Si el modelo no puede ver o llamar a una herramienta, comienza con la política efectiva para el turno actual:
- Verifique el perfil activo,
tools.allow, ytools.denyen Tools and custom providers. - Verifique las restricciones específicas del proveedor en Tools and custom providers y confirme que el model provider seleccionado admite la forma de la herramienta.
- Verifique los permisos del canal, el estado del sandbox y el acceso elevado con Sandbox vs tool policy vs elevated y Elevated exec.
- Verifique si el complemento propietario está instalado y habilitado en Plugins.
- Para ejecuciones delegadas, verifique las restricciones por agente en Per-agent sandbox and tool restrictions.
- Para catálogos grandes de OpenClaw, confirme si la ejecución usa exposición directa de herramientas o Tool Search.
Relacionado
Sección titulada «Relacionado»- Automation para cron, tareas, heartbeat, compromisos, hooks, órdenes permanentes y Task Flow
- Agents para el modelo de agente, sesiones, memoria y coordinación multiagente
- Tools and custom providers para la referencia canónica de la política de herramientas
- Plugins para la instalación y gestión de complementos
- Plugin SDK para la referencia del autor de complementos
- Skills para el orden de carga, restricciones y configuración de habilidades
- Skill Workshop para la creación y revisión de habilidades
- Tool Search para el descubrimiento compacto del catálogo de herramientas de OpenClaw