Overview

Visão geral

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.

Se você precisar...	Use isto primeiro	Depois, leia
Permitir que um agente atue com os recursos 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 Oficina de Skills
Adicionar uma nova integração ou superfície de execução	Plugins	Plugins e Criar Plugins
Executar trabalho posteriormente ou em segundo plano	Automação	Visão geral da automação
Coordenar vários agentes ou ambientes de execução	Subagentes	Agentes ACP e Envio do agente
Pesquisar um catálogo amplo de ferramentas do OpenClaw	Pesquisa de ferramentas	Pesquisa de ferramentas

Escolha ferramentas, Skills ou Plugins

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.

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

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.

Categoria	Use quando o agente precisar...	Ferramentas representativas	Leia em seguida
Tempo de execução	Executar comandos, gerenciar processos ou usar análise em Python fornecida pelo 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 publicações no X ou obter conteúdo legível de páginas	`web_search`, `x_search`, `web_fetch`	Ferramentas da web, Obtenção de conteúdo da web
Navegador	Operar uma sessão de navegador	`browser`	Navegador
Mensagens e canais	Enviar respostas ou ações de canal	`message`	Envio do agente
Sessões e agentes	Inspecionar sessões, delegar trabalho, orientar outra execução ou relatar o status	`sessions_*`, `subagents`, `agents_list`, `session_status`, `get_goal`, `create_goal`, `update_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 Nodes	Inspecionar o estado do Gateway ou dispositivos de destino pareados	`gateway`, `nodes`	Configuração do Gateway, Nodes
Mídia	Analisar, gerar ou reproduzir mídia por voz	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Visão geral de mídia
Catálogos amplos do OpenClaw	Pesquisar e chamar muitas ferramentas qualificadas sem enviar todos os esquemas ao modelo	`tool_search_code`, `tool_search`, `tool_describe`	Pesquisa de ferramentas

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.

Ferramentas e provedores personalizados documenta perfis de ferramentas, listas de permissão/negação, restrições específicas de provedores, detecção de loops e configurações de ferramentas fornecidas por provedores.
Aprovações de Exec documenta a política de aprovação de comandos do host.
Exec elevado documenta a execução controlada fora do sandbox.
Sandbox versus política de ferramentas versus acesso elevado explica qual camada controla o acesso a arquivos e processos.
Restrições de sandbox e ferramentas por agente documenta restrições específicas do agente para execuções delegadas.

Amplie os recursos

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

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 agentes com Skills e Criação de Skills.
Use o SDK de Plugins e o Manifesto de Plugin quando precisar de contratos de implementação.

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:

Verifique o perfil ativo, tools.allow e tools.deny em Ferramentas e provedores personalizados.
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.
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.
Verifique se o Plugin responsável está instalado e habilitado em Plugins.
Para execuções delegadas, verifique as restrições por agente em Restrições de sandbox e ferramentas por agente.
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

Was this useful?