Comece aqui
Para a maioria dos agentes, comece com as categorias de ferramentas integradas e depois ajuste a política somente quando o agente deve ver menos ferramentas ou precisa de acesso explícito ao host.| Se você precisa… | Use isto primeiro | Depois leia |
|---|---|---|
| Permitir que um agente atue com capacidades existentes | Ferramentas integradas | Categorias de ferramentas |
| Controlar o que um agente pode chamar | Política de ferramentas | Ferramentas e provedores personalizados |
| Ensinar um fluxo de trabalho a um agente | Skills | Skills, Criação de Skills, e Workshop de Skills |
| Adicionar uma nova integração ou superfície de runtime | Plugins | Plugins e Criar plugins |
| Executar trabalho depois ou em segundo plano | Automação | Visão geral de automação |
| Coordenar múltiplos agentes ou harnesses | Subagentes | Agentes ACP e Envio de agente |
| Pesquisar um grande catálogo de ferramentas do OpenClaw | Pesquisa de Ferramentas | Pesquisa de Ferramentas |
Escolha ferramentas, Skills ou plugins
Use uma ferramenta quando o agente precisa agir
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
precisa ler dados, alterar arquivos, enviar mensagens, chamar um provedor ou operar
outro sistema. Ferramentas visíveis são enviadas ao modelo como definições de função
estruturadas.O modelo vê somente as ferramentas que sobrevivem ao perfil ativo, à política de permitir/negar,
às restrições de provedor, ao estado do sandbox, às permissões de canal e à
disponibilidade de plugins.Use uma Skill quando o agente precisa de instruções
Uma Skill é um pacote de instruções
SKILL.md carregado no prompt do agente. Use uma
Skill quando o agente já tem as ferramentas de que precisa, mas precisa de um
fluxo de trabalho repetível, rubrica de revisão, sequência de comandos ou restrição operacional.Skills podem ficar em um workspace, diretório compartilhado de Skills, raiz gerenciada de
Skills do OpenClaw ou pacote de plugin.Skills | Workshop de Skills | Criação de Skills | Configuração de SkillsUse um plugin quando o OpenClaw precisa de uma nova capacidade
Um plugin pode adicionar ferramentas, Skills, canais, provedores de modelo, fala, voz em tempo real,
geração de mídia, pesquisa na web, busca na web, hooks e outras capacidades de runtime.
Use um plugin quando a capacidade tem código, credenciais, hooks de ciclo de vida,
metadados de manifesto ou empacotamento instalável. Plugins existentes podem ser instalados
pelo ClawHub, npm, git, diretórios locais ou arquivos.Instalar e configurar plugins | Criar plugins | Plugin SDK
Categorias de ferramentas integradas
A tabela lista ferramentas representativas para que você reconheça a superfície. Ela não é a referência completa de política. Para grupos, padrões e semântica de permitir/negar exatos, use Ferramentas e provedores personalizados.| Categoria | Use quando o agente precisa… | Ferramentas representativas | Leia a seguir |
|---|---|---|---|
| Runtime | Executar comandos, gerenciar processos ou usar análise Python apoiada por provedor | exec, process, code_execution | Exec, Execução de código |
| Arquivos | Ler e alterar arquivos do workspace | read, write, edit, apply_patch | Aplicar patch |
| Web | Pesquisar na web, pesquisar posts do X ou buscar conteúdo legível de páginas | web_search, x_search, web_fetch | Ferramentas web, Busca web |
| Navegador | Operar uma sessão de navegador | browser | Navegador |
| Mensagens e canais | Enviar respostas ou ações de canal | message | Envio de agente |
| Sessões e agentes | Inspecionar sessões, delegar trabalho, conduzir outra execução ou relatar status | sessions_*, subagents, agents_list, session_status, goal | Objetivo, Subagentes, Ferramenta de sessão |
| Automação | Agendar trabalho ou responder a eventos em segundo plano | cron, heartbeat_respond | Automação |
| Gateway e nós | Inspecionar o estado do Gateway ou dispositivos de destino pareados | gateway, nodes | Configuração do Gateway, Nós |
| Mídia | Analisar, gerar ou falar mídia | image, image_generate, music_generate, video_generate, tts | Visão geral de mídia |
| Grandes catálogos do OpenClaw | Pesquisar e chamar muitas ferramentas qualificadas sem enviar todos os schemas ao modelo | tool_search_code, tool_search, tool_describe | Pesquisa de Ferramentas |
Pesquisa de Ferramentas é uma superfície experimental de agente do OpenClaw. Execuções do harness Codex usam
modo de código nativo do Codex, pesquisa de ferramentas nativa, ferramentas dinâmicas adiadas e chamadas de ferramentas
aninhadas em vez de
tools.toolSearch.Ferramentas fornecidas por plugins
Plugins podem registrar ferramentas adicionais. Autores de plugins conectam ferramentas por meio deapi.registerTool(...) e contracts.tools do manifesto; use
Plugin SDK e Manifesto de plugin
para detalhes de contrato.
Ferramentas comuns fornecidas por plugins incluem:
- Diffs para renderizar diffs de arquivos e markdown
- Tarefa LLM para etapas de fluxo de trabalho somente JSON
- Lobster para fluxos de trabalho tipados com aprovações retomáveis
- Tokenjuice para compactar saída ruidosa das ferramentas
execebash - Pesquisa de Ferramentas para descobrir e chamar grandes catálogos de ferramentas sem colocar todos os schemas no prompt
- Canvas para controle de Node Canvas e renderização A2UI
Configure acesso e aprovações
A política de ferramentas é aplicada antes da chamada ao modelo. Se a política remove uma ferramenta, o modelo não recebe o schema dessa ferramenta para o turno. Uma execução pode perder ferramentas por causa da configuração global, configuração por agente, política de canal, restrições de provedor, regras de sandbox, política de canal/runtime ou disponibilidade de plugins.- Ferramentas e provedores personalizados documenta perfis de ferramentas, listas de permissão/negação, restrições específicas de provedor, detecção de loop e configurações de ferramentas apoiadas por provedor.
- Aprovações de exec documenta a política de aprovação de comandos do host.
- Exec elevado documenta execução controlada fora do sandbox.
- Sandbox vs política de ferramentas vs elevado explica qual camada controla acesso a arquivos e processos.
- Sandbox e restrições de ferramentas por agente documenta restrições específicas de agente para execuções delegadas.
Estenda capacidades
Escolha o caminho de extensão pelo trabalho que você precisa que o OpenClaw faça:- Instale ou gerencie um plugin existente com Plugins.
- Crie uma nova integração, provedor, canal, ferramenta ou hook com Criar plugins.
- Adicione ou ajuste instruções reutilizáveis de agente com Skills e Criação de Skills.
- Use Plugin SDK e Manifesto de plugin quando precisar de contratos de implementação.
Solucione problemas de ferramentas ausentes
Se o modelo não consegue ver ou chamar uma ferramenta, comece pela política efetiva para o turno atual:- Verifique o perfil ativo,
tools.allowetools.denyem Ferramentas e provedores personalizados. - Verifique restrições específicas de provedor em Ferramentas e provedores personalizados e confirme que o provedor de modelo selecionado oferece suporte ao formato da ferramenta.
- Verifique permissões de canal, estado do sandbox e acesso elevado com Sandbox vs política de ferramentas vs elevado e Exec elevado.
- Verifique se o plugin proprietário está instalado e habilitado em Plugins.
- Para execuções delegadas, verifique restrições por agente em Sandbox e restrições de ferramentas por agente.
- Para grandes catálogos do OpenClaw, confirme se a execução usa exposição direta de ferramentas ou Pesquisa de Ferramentas.
Relacionados
- Automação para cron, tarefas, heartbeat, compromissos, hooks, ordens permanentes e Fluxo de Tarefas
- 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ítica de ferramentas
- Plugins para instalação e gerenciamento de plugins
- Plugin SDK para referência de autores de plugins
- Skills para ordem de carregamento, gating e configuração de Skills
- Workshop de Skills para criação de Skills geradas e revisadas
- Pesquisa de Ferramentas para descoberta compacta de catálogos de ferramentas do OpenClaw