OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Overview

Descripción general

Use esta página para elegir la superficie de capacidades adecuada. Las herramientas son acciones invocables, las Skills enseñan a los agentes cómo trabajar y los plugins añaden capacidades de tiempo de ejecución, como herramientas, proveedores, canales, hooks y Skills empaquetadas.

Esta es una página de descripción general y orientación. Para consultar de forma exhaustiva las políticas de herramientas, los valores predeterminados, la pertenencia a grupos, las restricciones de proveedores y los campos de configuración, consulte Herramientas y proveedores personalizados.

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.

Si necesita... Use esto primero Después, consulte
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, Creación de Skills, Taller de Skills y Autoaprendizaje
Añadir una nueva integración o superficie de ejecución Plugins Plugins y Crear plugins
Ejecutar trabajo más tarde o en segundo plano Automatización Descripción general de la automatización
Coordinar varios agentes o entornos de ejecución Subagentes Agentes ACP y Envío de agentes
Orquestar agentes simultáneos desde código Swarm Modo de código y Subagentes
Buscar en un catálogo grande de herramientas de OpenClaw Búsqueda de herramientas Búsqueda de herramientas
Combinar varias herramientas en un programa compacto Modo de código Modo de código

Elija herramientas, Skills o plugins

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

  • 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 Skills

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

    Categoría Úsela cuando el agente necesite... Herramientas representativas Consulte a continuación
    Tiempo de ejecución Ejecutar comandos, gestionar procesos o usar análisis de Python respaldado por un proveedor exec, process, terminal, code_execution Exec, Terminal de la interfaz de control, Ejecución de código
    Archivos Leer y modificar archivos del espacio de trabajo read, write, edit, apply_patch Aplicar parche
    Intervención humana Pausar para que el usuario tome una decisión estructurada ask_user Preguntar al usuario
    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 de contenido web
    Navegador Operar una sesión del navegador browser Navegador
    Interfaz del operador Organizar paneles, vistas y navegación conectados de la interfaz de control screen Pantalla
    Mensajería y canales Enviar respuestas o acciones de canal message Envío de agentes
    Sesiones y agentes Inspeccionar sesiones, delegar trabajo, orquestar recopiladores, dirigir otra ejecución o informar del estado sessions_*, agents_wait, subagents, agents_list, session_status, get_goal, create_goal, update_goal Objetivo, Swarm, 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 los dispositivos de destino emparejados gateway, nodes Configuración del Gateway, Nodos
    Contenido multimedia Analizar, generar o reproducir contenido multimedia mediante voz image, image_generate, music_generate, video_generate, tts Descripción general del contenido multimedia
    Catálogos grandes de OpenClaw Buscar, invocar y combinar muchas herramientas aptas sin enviar cada esquema al modelo exec, wait, tool_search_code, tool_search, tool_describe Modo de código, Búsqueda de herramientas

    Herramientas proporcionadas por plugins

    Los plugins pueden registrar herramientas adicionales. Los autores de plugins conectan las herramientas mediante api.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 exec y bash
    • 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.

    Ampliar las capacidades

    Elija la vía de extensión según la tarea que necesite que OpenClaw realice:

    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:

    1. Compruebe el perfil activo, tools.allow y tools.deny en Herramientas y proveedores personalizados.
    2. 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.
    3. 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.
    4. Compruebe si el plugin propietario está instalado y habilitado en Plugins.
    5. Para las ejecuciones delegadas, compruebe las restricciones por agente en Restricciones de sandbox y herramientas por agente.
    6. 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
    Was this useful?
    On this page

    On this page