Skip to main content
Use esta página para escolher a superfície de recursos adequada. Ferramentas são ações que podem ser chamadas, Skills ensinam os agentes a trabalhar e Plugins adicionam recursos de tempo de execução, como ferramentas, provedores, canais, hooks e Skills empacotadas. Esta é uma página de visão geral e direcionamento. Para consultar políticas de ferramentas, padrões, associação a grupos, restrições de provedores e campos de configuração de forma completa, use Ferramentas e provedores personalizados.

​
Comece aqui

Para a maioria dos agentes, comece com as categorias de ferramentas integradas e ajuste a política somente quando o agente precisar ver menos ferramentas ou necessitar de acesso explícito ao host.

​
Escolha ferramentas, Skills ou Plugins

1

Use a tool when the agent needs to act

Uma ferramenta é uma função tipada que o agente pode chamar, como exec, browser, web_search, message ou image_generate. Use ferramentas quando o agente precisar ler dados, alterar arquivos, enviar mensagens, chamar um provedor ou operar outro sistema. As ferramentas visíveis são enviadas ao modelo como definições estruturadas de funções.O modelo vê somente as ferramentas que permanecem após a aplicação do perfil ativo, da política de permissão/negação, das restrições do provedor, do estado do sandbox, das permissões do canal e da disponibilidade de Plugins.
2

Use a skill when the agent needs instructions

Uma Skill é um pacote de instruções SKILL.md carregado no prompt do agente. Use uma Skill quando o agente já tiver as ferramentas necessárias, mas precisar de um fluxo de trabalho repetível, critérios de revisão, uma sequência de comandos ou uma restrição operacional.As Skills podem residir em um workspace, em um diretório compartilhado de Skills, na raiz gerenciada de Skills do OpenClaw ou em um pacote de Plugin.Skills | Oficina de Skills | Criação de Skills | Configuração de Skills
3

Use a plugin when OpenClaw needs a new capability

Um Plugin pode adicionar ferramentas, Skills, canais, provedores de modelos, fala, voz em tempo real, geração de mídia, pesquisa na web, obtenção de conteúdo da web, hooks e outros recursos de tempo de execução. Use um Plugin quando o recurso envolver código, credenciais, hooks de ciclo de vida, metadados de manifesto ou um pacote instalável. Plugins existentes podem ser instalados pelo ClawHub, npm, git, diretórios locais ou arquivos compactados.Instalar e configurar Plugins | Criar Plugins | SDK de Plugins

​
Categorias de ferramentas integradas

A tabela apresenta ferramentas representativas para que você possa reconhecer a superfície. Ela não é a referência completa de políticas. Para consultar grupos, padrões e semântica de permissão/negação exatos, use Ferramentas e provedores personalizados.
A Pesquisa de ferramentas é uma superfície experimental de agentes do OpenClaw. As execuções no ambiente do Codex usam o modo de código nativo do Codex, a pesquisa nativa de ferramentas, ferramentas dinâmicas adiadas e chamadas de ferramentas aninhadas em vez de tools.toolSearch.

​
Ferramentas fornecidas por Plugins

Plugins podem registrar ferramentas adicionais. Os autores de Plugins conectam as ferramentas por meio de api.registerTool(...) e de contracts.tools no manifesto; use SDK de Plugins e Manifesto de Plugin para obter detalhes dos contratos. Entre as ferramentas normalmente fornecidas por Plugins estão:
  • Diffs para renderizar diffs de arquivos e Markdown
  • Exibir widget para SVG e HTML autocontidos e incorporados no chat da web
  • Tarefa de LLM para etapas de fluxo de trabalho somente em JSON
  • Lobster para fluxos de trabalho tipados com aprovações retomáveis
  • Tokenjuice para compactar a saída ruidosa das ferramentas exec e bash
  • Pesquisa de ferramentas para descobrir e chamar grandes catálogos de ferramentas sem inserir todos os esquemas no prompt
  • Canvas para controlar o Canvas do Node e renderizar A2UI

​
Configure o acesso e as aprovações

A política de ferramentas é aplicada antes da chamada ao modelo. Se a política remover uma ferramenta, o modelo não receberá o esquema dessa ferramenta no turno. Uma execução pode perder ferramentas devido à configuração global, à configuração específica do agente, à política do canal, às restrições do provedor, às regras do sandbox, à política do canal ou do tempo de execução ou à disponibilidade de Plugins.

​
Amplie os recursos

Escolha o caminho de extensão de acordo com a tarefa que o OpenClaw precisa executar:

​
Solucione problemas de ferramentas ausentes

Se o modelo não conseguir ver ou chamar uma ferramenta, comece pela política efetiva para o turno atual:
  1. Verifique o perfil ativo, tools.allow e tools.deny em Ferramentas e provedores personalizados.
  2. Verifique as restrições específicas do provedor em Ferramentas e provedores personalizados e confirme se o provedor de modelos selecionado oferece suporte ao formato da ferramenta.
  3. Verifique as permissões do canal, o estado do sandbox e o acesso elevado em Sandbox versus política de ferramentas versus acesso elevado e Exec elevado.
  4. Verifique se o Plugin responsável está instalado e habilitado em Plugins.
  5. Para execuções delegadas, verifique as restrições por agente em Restrições de sandbox e ferramentas por agente.
  6. Para catálogos amplos do OpenClaw, confirme se a execução usa exposição direta de ferramentas ou Pesquisa de ferramentas.

​
Relacionado

  • Automação para cron, tarefas, heartbeat, compromissos, hooks, ordens permanentes e Task Flow
  • Agentes para o modelo de agente, sessões, memória e coordenação multiagente
  • Ferramentas e provedores personalizados para a referência canônica de políticas de ferramentas
  • Plugins para instalação e gerenciamento de plugins
  • SDK de Plugins para a referência de autores de plugins
  • Skills para ordem de carregamento, controle de acesso e configuração de Skills
  • Oficina de Skills para a criação de Skills geradas e revisadas
  • Pesquisa de ferramentas para descobrir de forma compacta o catálogo de ferramentas do OpenClaw