O Clawdbot expõe ferramentas de agente poderosas para automação de navegador, canvas, nós, tarefas agendadas e mais. Aprenda a configurar e usar as ferramentas do Clawdbot.

Visão geral das ferramentas do Clawdbot

O Clawdbot expõe ferramentas de agente de primeira classe para navegador, canvas, nós e cron. Essas ferramentas são tipadas, não requerem shell, e o agente pode confiar nelas diretamente.

Desabilitando ferramentas

Você pode permitir/negar ferramentas globalmente via tools.allow / tools.deny em clawdbot.json (negar tem prioridade):

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

Notas:

A correspondência não diferencia maiúsculas de minúsculas
Curingas * são suportados ("*" significa todas as ferramentas)

Perfis de ferramentas

tools.profile define uma lista de permissões base de ferramentas antes de tools.allow / tools.deny.

Perfil	Ferramentas incluídas
`minimal`	Apenas `session_status`
`coding`	`group:fs`, `group:runtime`, `group:sessions`, `group:memory`, `image`
`messaging`	`group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`
`full`	Sem restrições (igual a não definido)

Exemplo (apenas mensagens por padrão):

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

Grupos de ferramentas

As políticas de ferramentas suportam entradas group:* que se expandem para múltiplas ferramentas:

Grupo	Ferramentas
`group:runtime`	`exec`, `bash`, `process`
`group:fs`	`read`, `write`, `edit`, `apply_patch`
`group:sessions`	`sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `session_status`
`group:memory`	`memory_search`, `memory_get`
`group:web`	`web_search`, `web_fetch`
`group:ui`	`browser`, `canvas`
`group:automation`	`cron`, `gateway`
`group:messaging`	`message`
`group:nodes`	`nodes`

Exemplo (permitir apenas ferramentas de arquivo + navegador):

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

Inventário de ferramentas

Ferramentas principais

Ferramenta	Descrição
`apply_patch`	Aplicar patches de diff unificado a arquivos
`exec`	Executar comandos shell
`process`	Gerenciamento de processos
`web_search`	Pesquisar na web
`web_fetch`	Buscar páginas web
`browser`	Automação de navegador
`canvas`	Canvas para conteúdo visual
`nodes`	Comandos de dispositivos de nó
`image`	Processamento de imagens
`message`	Enviar mensagens
`cron`	Agendar tarefas
`gateway`	Gerenciamento de gateway

Ferramentas de sessão

Ferramenta	Descrição
`sessions_list`	Listar sessões ativas
`sessions_history`	Obter histórico da sessão
`sessions_send`	Enviar para uma sessão
`sessions_spawn`	Criar uma nova sessão
`session_status`	Obter status da sessão

Política de ferramentas específica do provedor

Use tools.byProvider para restringir ferramentas para provedores específicos:

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

Plugins + Ferramentas

Plugins podem registrar ferramentas adicionais além do conjunto principal. Consulte a documentação de Plugins para detalhes.

Segurança

As ferramentas são apresentadas ao agente com descrições claras
Use tools.deny para bloquear ferramentas perigosas
Sandboxing está disponível para entradas não confiáveis

Próximos passos

Habilidades do Clawdbot - Estender com habilidades
Comandos de barra do Clawdbot - Referência de comandos
Gateway do Clawdbot - Configuração do gateway

Ferramentas do Clawdbot