Herramientas de Clawdbot

Clawdbot expone potentes herramientas de agente para automatización del navegador, canvas, nodos, tareas programadas y más. Aprende a configurar y usar las herramientas de Clawdbot.

Descripción general de las herramientas de Clawdbot

Clawdbot expone herramientas de agente de primera clase para navegador, canvas, nodos y cron. Estas herramientas están tipadas, no requieren shell, y el agente puede confiar en ellas directamente.

Deshabilitar herramientas

Puedes permitir/denegar herramientas globalmente a través de tools.allow / tools.deny en clawdbot.json (denegar tiene prioridad):

{
  "tools": {
    "deny": ["browser"]
  }
}

Notas:

  • La coincidencia no distingue entre mayúsculas y minúsculas
  • Se admiten comodines * ("*" significa todas las herramientas)

Perfiles de herramientas

tools.profile establece una lista blanca de herramientas base antes de tools.allow / tools.deny.

PerfilHerramientas incluidas
minimalSolo session_status
codinggroup:fs, group:runtime, group:sessions, group:memory, image
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
fullSin restricciones (igual que no establecido)

Ejemplo (solo mensajería por defecto):

{
  "tools": {
    "profile": "messaging",
    "allow": ["slack", "discord"]
  }
}

Grupos de herramientas

Las políticas de herramientas admiten entradas group:* que se expanden a múltiples herramientas:

GrupoHerramientas
group:runtimeexec, bash, process
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, session_status
group:memorymemory_search, memory_get
group:webweb_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes

Ejemplo (permitir solo herramientas de archivos + navegador):

{
  "tools": {
    "allow": ["group:fs", "browser"]
  }
}

Inventario de herramientas

Herramientas principales

HerramientaDescripción
apply_patchAplicar parches de diferencias unificadas a archivos
execEjecutar comandos de shell
processGestión de procesos
web_searchBuscar en la web
web_fetchObtener páginas web
browserAutomatización del navegador
canvasCanvas para contenido visual
nodesComandos de dispositivos de nodo
imageProcesamiento de imágenes
messageEnviar mensajes
cronProgramar tareas
gatewayGestión de gateway

Herramientas de sesión

HerramientaDescripción
sessions_listListar sesiones activas
sessions_historyObtener historial de sesión
sessions_sendEnviar a una sesión
sessions_spawnCrear una nueva sesión
session_statusObtener estado de sesión

Política de herramientas específica del proveedor

Usa tools.byProvider para restringir herramientas para proveedores específicos:

{
  "tools": {
    "profile": "coding",
    "byProvider": {
      "google-antigravity": {
        "profile": "minimal"
      }
    }
  }
}

Plugins + Herramientas

Los plugins pueden registrar herramientas adicionales más allá del conjunto principal. Consulta la documentación de Plugins para más detalles.

Seguridad

  • Las herramientas se presentan al agente con descripciones claras
  • Usa tools.deny para bloquear herramientas peligrosas
  • El sandboxing está disponible para entradas no confiables

Próximos pasos