Ir al contenido

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.

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 primeroLuego lea
Permitir que un agente actúe con capacidades existentesHerramientas integradasCategorías de herramientas
Controlar lo que un agente puede llamarPolítica de herramientasHerramientas y proveedores personalizados
Enseñar un flujo de trabajo a un agenteHabilidadesHabilidades, Crear habilidades y Taller de habilidades
Añadir una nueva integración o superficie de tiempo de ejecuciónPluginsPlugins y Compilar plugins
Ejecutar trabajo más tarde o en segundo planoAutomatizaciónDescripción general de automatización
Coordinar múltiples agentes o arnesesSubagentesAgentes ACP y Envío de agente
Buscar en un catálogo grande de herramientas de OpenClawBúsqueda de herramientasBúsqueda de herramientas

Elegir herramientas, habilidades o complementos

Sección titulada «Elegir herramientas, habilidades o complementos»
  1. 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, message o image_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.

  2. Use una habilidad cuando el agente necesite instrucciones

    Una habilidad es un paquete de instrucciones SKILL.md cargado 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

  3. 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

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íaUsar cuando el agente necesite…Herramientas representativasLeer siguiente
Tiempo de ejecuciónEjecute comandos, gestione procesos o use análisis de Python respaldado por proveedoresexec, process, code_executionExec, Code execution
ArchivosLeer y cambiar archivos del espacio de trabajoread, write, edit, apply_patchApply patch
WebBuscar en la web, buscar publicaciones en X u obtener contenido de página legibleweb_search, x_search, web_fetchWeb tools, Web fetch
NavegadorOperar una sesión de navegadorbrowserBrowser
Mensajería y canalesEnviar respuestas o acciones de canalmessageAgent send
Sesiones y agentesInspeccionar sesiones, delegar trabajo, dirigir otra ejecución o reportar estadosessions_*, subagents, agents_list, session_status, goalGoal, Sub-agents, Session tool
AutomatizaciónProgramar trabajo o responder a eventos en segundo planocron, heartbeat_respondAutomation
Puerta de enlace y nodosInspeccionar el estado de la puerta de enlace o los dispositivos de destino emparejadosgateway, nodesGateway configuration, Nodes
MediosAnalizar, generar o reproducir mediosimage, image_generate, music_generate, video_generate, ttsMedia overview
Catálogos grandes de OpenClawBuscar y llamar a muchas herramientas elegibles sin enviar cada esquema al modelotool_search_code, tool_search, tool_describeTool 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 exec y bash
  • 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

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.

Elija la ruta de extensión según la tarea que necesite que realice OpenClaw:

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:

  1. Verifique el perfil activo, tools.allow, y tools.deny en Tools and custom providers.
  2. 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.
  3. Verifique los permisos del canal, el estado del sandbox y el acceso elevado con Sandbox vs tool policy vs elevated y Elevated exec.
  4. Verifique si el complemento propietario está instalado y habilitado en Plugins.
  5. Para ejecuciones delegadas, verifique las restricciones por agente en Per-agent sandbox and tool restrictions.
  6. Para catálogos grandes de OpenClaw, confirme si la ejecución usa exposición directa de herramientas o Tool Search.
  • 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