Saltar al contenido principal

​
Herramientas y plugins

Todo lo que hace el agente más allá de generar texto ocurre mediante herramientas. Las herramientas son la forma en que el agente lee archivos, ejecuta comandos, navega por la web, envía mensajes e interactúa con dispositivos.

​
Herramientas, Skills y plugins

OpenClaw tiene tres capas que funcionan juntas:
1

Las herramientas son lo que invoca el agente

Una herramienta es una función tipada que el agente puede invocar (por ejemplo, exec, browser, web_search, message). OpenClaw incluye un conjunto de herramientas integradas y los plugins pueden registrar otras adicionales.El agente ve las herramientas como definiciones estructuradas de funciones enviadas a la API del modelo.
2

Las Skills enseñan al agente cuándo y cómo

Una Skill es un archivo Markdown (SKILL.md) inyectado en el prompt del sistema. Las Skills proporcionan al agente contexto, restricciones y orientación paso a paso para usar las herramientas de forma eficaz. Las Skills viven en tu espacio de trabajo, en carpetas compartidas, o se incluyen dentro de plugins.Referencia de Skills | Crear Skills
3

Los plugins lo empaquetan todo junto

Un plugin es un paquete que puede registrar cualquier combinación de capacidades: canales, proveedores de modelos, herramientas, Skills, voz, transcripción en tiempo real, voz en tiempo real, comprensión multimedia, generación de imágenes, generación de vídeo, web fetch, web search y más. Algunos plugins son core (incluidos con OpenClaw), otros son externos (publicados en npm por la comunidad).Instalar y configurar plugins | Crear el tuyo

​
Herramientas integradas

Estas herramientas se incluyen con OpenClaw y están disponibles sin instalar ningún plugin:
ToolQué hacePágina
exec / processEjecuta comandos de shell, gestiona procesos en segundo planoExec
code_executionEjecuta análisis remoto de Python en entorno aisladoCode Execution
browserControla un navegador Chromium (navegar, hacer clic, capturar pantalla)Browser
web_search / x_search / web_fetchBusca en la web, busca publicaciones en X, obtiene contenido de páginasWeb
read / write / editE/S de archivos en el espacio de trabajo
apply_patchParches de archivos con varios hunksApply Patch
messageEnvía mensajes a través de todos los canalesAgent Send
canvasControla Canvas del nodo (present, eval, snapshot)
nodesDescubre y selecciona dispositivos emparejados
cron / gatewayGestiona trabajos programados; inspecciona, corrige, reinicia o actualiza el gateway
image / image_generateAnaliza o genera imágenes
ttsConversión puntual de texto a vozTTS
sessions_* / subagents / agents_listGestión de sesiones, estado y orquestación de subagentesSub-agents
session_statusLectura ligera tipo /status y anulación del modelo por sesiónSession Tools
Para el trabajo con imágenes, usa image para análisis e image_generate para generación o edición. Si apuntas a openai/*, google/*, fal/* u otro proveedor de imágenes no predeterminado, configura primero la autenticación/API key de ese proveedor. session_status es la herramienta ligera de estado/lectura del grupo de sesiones. Responde preguntas de estilo /status sobre la sesión actual y puede establecer opcionalmente una anulación del modelo por sesión; model=default borra esa anulación. Al igual que /status, puede rellenar contadores escasos de tokens/caché y la etiqueta del modelo activo de runtime a partir de la entrada de uso de transcripción más reciente. gateway es la herramienta de runtime solo para propietarios para operaciones del gateway:
  • config.schema.lookup para un subárbol de configuración acotado a una ruta antes de editar
  • config.get para la instantánea de configuración actual + hash
  • config.patch para actualizaciones parciales de configuración con reinicio
  • config.apply solo para reemplazo completo de la configuración
  • update.run para autoactualización explícita + reinicio
Para cambios parciales, prefiere config.schema.lookup y luego config.patch. Usa config.apply solo cuando pretendas reemplazar toda la configuración. La herramienta también se niega a cambiar tools.exec.ask o tools.exec.security; los alias heredados tools.bash.* se normalizan a las mismas rutas exec protegidas.

​
Herramientas proporcionadas por plugins

Los plugins pueden registrar herramientas adicionales. Algunos ejemplos:
  • Lobster — runtime de flujo de trabajo tipado con aprobaciones reanudables
  • LLM Task — paso de LLM solo JSON para salida estructurada
  • Diffs — visor y renderizador de diffs
  • OpenProse — orquestación de flujo de trabajo centrada en Markdown

​
Configuración de herramientas

​
Listas de permitidos y denegados

Controla qué herramientas puede invocar el agente mediante tools.allow / tools.deny en la configuración. Denegar siempre prevalece sobre permitir. 
{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}

​
Perfiles de herramientas

tools.profile establece una lista base de permitidos antes de aplicar allow/deny. Anulación por agente: agents.list[].tools.profile.
PerfilQué incluye
fullSin restricciones (igual que no establecerlo)
codinggroup:fs, group:runtime, group:web, group:sessions, group:memory, cron, image, image_generate
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
minimalSolo session_status

​
Grupos de herramientas

Usa atajos group:* en listas de permitidos/denegados:
GrupoHerramientas
group:runtimeexec, process, code_execution (bash se acepta como alias de exec)
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status
group:memorymemory_search, memory_get
group:webweb_search, x_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes
group:agentsagents_list
group:mediaimage, image_generate, tts
group:openclawTodas las herramientas integradas de OpenClaw (excluye herramientas de plugins)
sessions_history devuelve una vista de recuperación acotada y filtrada por seguridad. Elimina etiquetas de thinking, andamiaje de <relevant-memories>, cargas útiles XML de llamadas a herramientas en texto plano (incluyendo <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, y bloques de llamadas a herramientas truncados), andamiaje degradado de llamadas a herramientas, tokens de control del modelo filtrados en ASCII/ancho completo, y XML malformado de llamadas a herramientas de MiniMax del texto del asistente, y luego aplica redacción/truncamiento y posibles marcadores de fila sobredimensionada en lugar de actuar como un volcado de transcripción sin procesar.

​
Restricciones específicas del proveedor

Usa tools.byProvider para restringir herramientas para proveedores específicos sin cambiar los valores predeterminados globales: 
{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}