Overview

Visão geral

Use esta página para escolher a superfície de Capacidades correta. Ferramentas são ações chamáveis, Skills ensinam os agentes a trabalhar, e plugins adicionam recursos de runtime, como ferramentas, provedores, canais, hooks e Skills empacotadas.

Esta é uma página de visão geral e roteamento. Para política completa de ferramentas, padrões, participação em grupos, restrições de provedores e campos de configuração, use Ferramentas e provedores personalizados.

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 precisar 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 e Criação 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 da automação
Coordenar vários agentes ou harnesses	Subagentes	Agentes ACP e Envio de agente
Pesquisar um grande catálogo de ferramentas PI	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 só vê ferramentas que sobrevivem ao perfil ativo, à política de permissão/negação, às restrições do provedor, ao estado do sandbox, às permissões do canal e à disponibilidade do plugin.

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 de Skills gerenciada pelo OpenClaw ou pacote de plugin.

Skills | Criação de Skills | Configuração de Skills

Use 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 envolve código, credenciais, hooks de ciclo de vida, metadados de manifesto ou empacotamento instalável. Plugins existentes podem ser instalados do ClawHub, npm, git, diretórios locais ou arquivos compactados.

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 exatos, padrões e semântica de permissão/negação, 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, orientar outra execução ou relatar status	`sessions_*`, `subagents`, `agents_list`, `session_status`	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 PI	Pesquisar e chamar muitas ferramentas elegíveis sem enviar todos os schemas ao modelo	`tool_search_code`, `tool_search`, `tool_describe`	Pesquisa de Ferramentas

Ferramentas fornecidas por plugins

Plugins podem registrar ferramentas adicionais. Autores de plugins conectam ferramentas por meio de api.registerTool(...) e contracts.tools do manifesto; use Plugin SDK e Manifesto do plugin para detalhes do contrato.

Ferramentas comuns fornecidas por plugins incluem:

Diffs para renderizar diffs de arquivos e markdown
LLM Task 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 exec e bash
Tool Search para descobrir e chamar grandes catálogos de ferramentas sem colocar todos os schemas no prompt
Canvas para controle de Canvas de nós e renderização A2UI

Configurar acesso e aprovações

A política de ferramentas é aplicada antes da chamada do 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 de configuração global, configuração por agente, política de canal, restrições de provedor, regras de sandbox, bloqueio somente para proprietário ou disponibilidade de plugin.

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 o acesso a arquivos e processos.
Sandbox por agente e restrições de ferramentas documenta restrições específicas de agente para execuções delegadas.

Estender 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.
Empacote material de fluxo de trabalho reutilizável com Workshop de Skills quando o fluxo de trabalho pertence a um pacote de Skills distribuído por plugin.
Use Plugin SDK e Manifesto do plugin quando precisar de contratos de implementação.

Solucionar 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.allow e tools.deny em Ferramentas e provedores personalizados.
Verifique restrições específicas de provedor em Ferramentas e provedores personalizados e confirme se o provedor de modelo selecionado é compatível com o 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 por agente e restrições de ferramentas.
Para grandes catálogos PI, confirme se a execução usa exposição direta de ferramentas ou Tool Search.

Relacionados

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í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, bloqueio e configuração de Skills
Tool Search para descoberta compacta de catálogos de ferramentas PI

Was this useful?