TL;DR
OpenClaw usa Ferramentas e Habilidades para agir. Ferramentas são capacidades de baixo nível (ler arquivos, executar comandos, pesquisar na web). Habilidades são fluxos de trabalho pré-construídos que combinam várias ferramentas (revisão de código, resumo de reuniões). Este guia explica todas as 25 ferramentas padrão, mais de 53 habilidades da comunidade, como ativá-las/desativá-las e como criar habilidades personalizadas.
Ferramentas vs Habilidades: Entendendo a Diferença
O poder do OpenClaw vem de dois sistemas que trabalham juntos:
Ferramentas = O que o OpenClaw PODE fazer (capacidades)
Habilidades = O que o OpenClaw SABE fazer (fluxos de trabalho)
Pense nas ferramentas como órgãos e nas habilidades como comportamentos aprendidos. As ferramentas dão ao OpenClaw a capacidade de ler arquivos ou executar comandos. As habilidades o ensinam a usar essas ferramentas para tarefas específicas, como revisar código ou resumir reuniões.
Exemplo: Revisão de Código
Sem Habilidades (Apenas Ferramentas):
Você: "Revise esta solicitação de pull"
OpenClaw: "Eu consigo ler arquivos e pesquisar na web, mas não sei como revisar código. Você pode ser mais específico?"
Com Habilidades:
Você: "Revise esta solicitação de pull"
OpenClaw: [Usa a habilidade code_review]
- Lê os arquivos alterados (ferramenta read)
- Verifica por erros comuns (análise)
- Pesquisa por problemas semelhantes (ferramenta web_search)
- Posta comentários (ferramenta github)
As habilidades orquestram ferramentas para realizar tarefas complexas.
As 25 Ferramentas Padrão
As ferramentas são incorporadas ao OpenClaw. Você as ativa ou desativa com base no que confia que o OpenClaw faça.
Ferramentas do Sistema de Arquivos
1. read
O que faz: Lê o conteúdo de arquivos
Casos de uso: Ver código, verificar configurações, analisar logs
Segurança: Somente leitura, não pode modificar arquivos
Exemplo:
Você: "Leia package.json"
OpenClaw: [Mostra o conteúdo do arquivo]
2. write
O que faz: Cria ou modifica arquivos
Casos de uso: Gerar código, atualizar configurações, criar documentos
Segurança: Pode sobrescrever arquivos — use com cautela
Exemplo:
Você: "Crie um arquivo chamado test.txt com 'Olá Mundo'"
OpenClaw: "Feito. test.txt criado"
3. list
O que faz: Lista arquivos e diretórios
Casos de uso: Explorar estrutura do projeto, encontrar arquivos
Segurança: Somente leitura
Exemplo:
Você: "Liste os arquivos em src/"
OpenClaw: "src/ contém:
- api/
- components/
- utils/
- index.js"
4. search
O que faz: Pesquisa o conteúdo de arquivos (como grep)
Casos de uso: Encontrar padrões de código, localizar funções
Segurança: Somente leitura
Exemplo:
Você: "Pesquise por 'TODO' em todos os arquivos JavaScript"
OpenClaw: "Encontrado 12 correspondências:
- src/api/users.js:45
- src/utils/helpers.js:23
..."
Ferramentas de Execução
5. exec
O que faz: Executa comandos de shell
Casos de uso: Rodar testes, construir projetos, implantar código
Segurança: ALTO RISCO — pode executar qualquer comando
Exemplo:
Você: "Execute npm test"
OpenClaw: [Executa testes e mostra resultados]
Nota de Segurança: Ative exec somente se você confiar totalmente no OpenClaw. Ele pode executar comandos destrutivos como rm -rf.
6. python
O que faz: Executa código Python
Casos de uso: Análise de dados, scripting, automação
Segurança: Pode executar código Python arbitrário
Exemplo:
Você: "Calcule a média de [10, 20, 30, 40]"
OpenClaw: [Executa Python] "Média: 25"
7. node
O que faz: Executa código Node.js
Casos de uso: Scripting JavaScript, chamadas de API
Segurança: Pode executar JavaScript arbitrário
Exemplo:
Você: "Buscar dados de https://api.example.com/users"
OpenClaw: [Executa Node.js fetch] "50 usuários recuperados"
Ferramentas Web
8. web_search
O que faz: Pesquisa na internet (Google, Bing)
Casos de uso: Pesquisa, verificação de fatos, busca de documentação
Segurança: Baixo risco — somente leitura
Exemplo:
Você: "Pesquisar documentação OpenClaw"
OpenClaw: "Encontrado:
1. docs.openclaw.ai - Docs Oficiais
2. github.com/openclaw - Repositório
..."
9. web_fetch
O que faz: Baixa conteúdo de páginas da web
Casos de uso: Coletar dados, ler artigos, monitorar sites
Segurança: Baixo risco — somente leitura
Exemplo:
Você: "Buscar o conteúdo de https://example.com"
OpenClaw: [Baixa e mostra o conteúdo da página]
10. web_screenshot
O que faz: Captura screenshots de páginas da web
Casos de uso: Testes visuais, monitoramento, documentação
Segurança: Baixo risco
Exemplo:
Você: "Screenshot de https://myapp.com"
OpenClaw: "Screenshot salva em screenshots/myapp.png"
Ferramentas de Memória
11. memory
O que faz: Armazena e recupera informações entre sessões
Casos de uso: Lembrar preferências, salvar contexto
Segurança: Baixo risco — apenas armazenamento local
Exemplo:
Você: "Lembre-se que eu prefiro TypeScript a JavaScript"
OpenClaw: "Salvo na memória."
[Mais tarde]
Você: "Gerar um novo endpoint de API"
OpenClaw: "Criando endpoint TypeScript..." [Usa a preferência lembrada]
12. context
O que faz: Gerencia o contexto da conversa
Casos de uso: Rastrear tarefas multi-etapas, manter estado
Segurança: Baixo risco
Exemplo:
Você: "Estou trabalhando no recurso de autenticação de usuário"
OpenClaw: "Anotado. Manterei este contexto para nossa conversa."
Você: "Adicione validação de senha"
OpenClaw: [Sabe que você ainda está trabalhando na autenticação] "Adicionando validação ao recurso de autenticação..."
Ferramentas de Agendamento
13. schedule
O que faz: Cria tarefas recorrentes (tipo cron)
Casos de uso: Relatórios diários, monitoramento, lembretes
Segurança: Risco médio — executa tarefas automaticamente
Exemplo:
Você: "Verifique o Hacker News todas as manhãs às 8h e me envie os 3 principais posts"
OpenClaw: "Agendado. Executarei isso diariamente às 8h."
14. heartbeat
O que faz: Executa tarefas em segundo plano em intervalos
Casos de uso: Monitoramento, polling, verificações periódicas
Segurança: Risco médio
Exemplo:
Você: "Monitore https://api.myapp.com a cada 5 minutos"
OpenClaw: "Heartbeat iniciado. Verificando a cada 5 minutos."
Ferramentas de Comunicação
15. email
O que faz: Envia e-mails
Casos de uso: Notificações, relatórios, alertas
Segurança: Risco médio — pode enviar e-mails em seu nome
Exemplo:
Você: "Envie um e-mail para a equipe com um resumo das implantações de hoje"
OpenClaw: "E-mail enviado para team@company.com"
16. slack
O que faz: Posta em canais do Slack
Casos de uso: Notificações da equipe, alertas, atualizações
Segurança: Risco médio
Exemplo:
Você: "Postar em #engineering: 'Implantação concluída'"
OpenClaw: "Postado em #engineering"
17. discord
O que faz: Envia mensagens no Discord
Casos de uso: Atualizações da comunidade, interações com bots
Segurança: Risco médio
Exemplo:
Você: "Envie uma mensagem para #general: 'Manutenção do servidor em 10 minutos'"
OpenClaw: "Mensagem enviada para #general"
Ferramentas de Integração
18. github
O que faz: Interage com o GitHub (repositórios, PRs, issues)
Casos de uso: Revisões de código, gerenciamento de issues, implantações
Segurança: Risco médio — pode modificar repositórios
Exemplo:
Você: "Crie uma issue: 'Corrigir bug de login no celular'"
OpenClaw: "Issue #456 criada no repositório myapp"
19. jira
O que faz: Gerencia tarefas do Jira
Casos de uso: Gerenciamento de projetos, rastreamento de tarefas
Segurança: Risco médio
Exemplo:
Você: "Quais tarefas estão atribuídas a mim?"
OpenClaw: "Você tem 3 tarefas:
- PROJ-123: Corrigir autenticação
- PROJ-124: Atualizar documentos
- PROJ-125: Revisão de código"
20. database
O que faz: Consulta bancos de dados (SQL, MongoDB)
Casos de uso: Análise de dados, relatórios, depuração
Segurança: ALTO RISCO — pode modificar dados
Exemplo:
Você: "Quantos usuários se cadastraram hoje?"
OpenClaw: [Consulta banco de dados] "47 novos usuários hoje"
Ferramentas de Utilidade
21. calculator
O que faz: Realiza cálculos
Casos de uso: Matemática, conversões, estimativas
Segurança: Sem risco
Exemplo:
Você: "Calcule 15% de $1.250"
OpenClaw: "$187,50"
22. date_time
O que faz: Lida com datas e horas
Casos de uso: Agendamento, fusos horários, cálculos
Segurança: Sem risco
Exemplo:
Você: "Que horas são em Tóquio?"
OpenClaw: "3:45 AM JST (6 de março de 2026)"
23. image_gen
O que faz: Gera imagens (DALL-E, Stable Diffusion)
Casos de uso: Miniaturas, mockups, ilustrações
Segurança: Baixo risco — custa créditos de API
Exemplo:
Você: "Gere uma imagem de um robô usando um computador"
OpenClaw: [Gera imagem] "Salva em images/robot.png"
24. pdf
O que faz: Cria e lê PDFs
Casos de uso: Relatórios, documentação, faturas
Segurança: Baixo risco
Exemplo:
Você: "Converta report.md para PDF"
OpenClaw: "report.pdf criado"
25. zip
O que faz: Comprime e extrai arquivos
Casos de uso: Backups, transferências de arquivos, arquivos
Segurança: Baixo risco
Exemplo:
Você: "Comprima o diretório src/"
OpenClaw: "src.zip criado (2,3 MB)"
Gerenciando Ferramentas
Visualizar Ferramentas Ativadas
Você: "Quais ferramentas eu tenho ativadas?"
OpenClaw: "Ferramentas ativadas:
✓ read, write, list, search
✓ web_search, web_fetch
✓ memory, context
✓ schedule, heartbeat
✗ exec (desativado)
✗ database (desativado)"
Ativar uma Ferramenta
Você: "Ativar a ferramenta exec"
OpenClaw: "⚠️ Aviso: exec permite executar comandos de shell. Isso é poderoso, mas arriscado. Tem certeza?"
Você: "Sim"
OpenClaw: "Ferramenta exec ativada"
Desativar uma Ferramenta
Você: "Desativar a ferramenta database"
OpenClaw: "Ferramenta database desativada. Não consigo mais consultar bancos de dados."
Melhores Práticas de Segurança
Comece com o Mínimo:
Ative apenas as ferramentas que você precisa. Você sempre pode adicionar mais tarde.
Ferramentas de Alto Risco:
exec- Pode executar qualquer comandodatabase- Pode modificar dadosemail- Pode enviar e-mails em seu nome
Ative-as apenas se você confiar totalmente no OpenClaw.
Ferramentas de Risco Médio:
write- Pode sobrescrever arquivosgithub- Pode modificar repositóriosslack- Pode postar mensagens
Ative-as quando precisar de automação, mas monitore seu uso.
Ferramentas de Baixo Risco:
read,list,search- Somente leituraweb_search,web_fetch- Somente leitura externamemory- Armazenamento local
Seguras para ativar por padrão.
As Mais de 53 Habilidades da Comunidade
Habilidades são fluxos de trabalho pré-construídos. A comunidade criou mais de 53 habilidades para tarefas comuns.
Habilidades de Desenvolvimento
code_review
O que faz: Revisa o código em busca de qualidade, bugs e estilo
Ferramentas usadas: read, search, web_search, github
Exemplo:
Você: "Revise a PR #42"
OpenClaw: [Analisa o código, verifica problemas, posta comentários]
debug_assistant
O que faz: Ajuda a depurar erros
Ferramentas usadas: read, search, exec, web_search
Exemplo:
Você: "Depurar este erro: TypeError: Cannot read property 'name' of undefined"
OpenClaw: [Analisa o código, sugere correções]
test_generator
O que faz: Gera testes unitários
Ferramentas usadas: read, write, exec
Exemplo:
Você: "Gere testes para src/api/users.js"
OpenClaw: [Cria arquivo de teste com testes abrangentes]
refactor_assistant
O que faz: Sugere melhorias de código
Ferramentas usadas: read, write, search
Exemplo:
Você: "Refatorar src/utils/helpers.js"
OpenClaw: [Sugere melhorias, aplica alterações]
Habilidades de Produtividade
meeting_summary
O que faz: Resume reuniões e extrai itens de ação
Ferramentas usadas: memory, context
Exemplo:
Você: [Encaminha transcrição da reunião]
OpenClaw: [Gera resumo estruturado com itens de ação]
task_manager
O que faz: Gerencia tarefas em várias ferramentas (Jira, Asana, Trello)
Ferramentas usadas: jira, memory, schedule
Exemplo:
Você: "O que tenho para fazer esta semana?"
OpenClaw: [Lista todas as tarefas das ferramentas conectadas]
email_assistant
O que faz: Rascunha e envia e-mails
Ferramentas usadas: email, memory
Exemplo:
Você: "Rascunhe um e-mail para a equipe sobre a implantação de amanhã"
OpenClaw: [Gera e-mail profissional]
Habilidades de Conteúdo
blog_writer
O que faz: Escreve posts de blog
Ferramentas usadas: web_search, write, memory
Exemplo:
Você: "Escreva um post de blog sobre casos de uso do OpenClaw"
OpenClaw: [Pesquisa o tópico, escreve post abrangente]
social_media_manager
O que faz: Cria conteúdo para mídias sociais
Ferramentas usadas: web_search, memory, slack
Exemplo:
Você: "Crie uma thread no Twitter sobre nosso novo recurso"
OpenClaw: [Gera thread envolvente]
video_script_writer
O que faz: Escreve roteiros de vídeo
Ferramentas usadas: web_search, write, memory
Exemplo:
Você: "Escreva um roteiro de 10 minutos para o YouTube sobre a configuração do OpenClaw"
OpenClaw: [Gera roteiro estruturado]
Habilidades de Monitoramento
api_monitor
O que faz: Monitora a saúde da API
Ferramentas usadas: web_fetch, heartbeat, slack
Exemplo:
Você: "Monitore https://api.myapp.com"
OpenClaw: [Verifica a API a cada 5 minutos, alerta sobre problemas]
error_tracker
O que faz: Rastreia e analisa erros
Ferramentas usadas: read, search, memory, slack
Exemplo:
Você: "Monitore os logs de erro e me alerte sobre novos erros"
OpenClaw: [Observa logs, envia alertas]
deployment_watcher
O que faz: Monitora implantações
Ferramentas usadas: github, exec, slack
Exemplo:
Você: "Observe novas implantações e execute testes de fumaça"
OpenClaw: [Monitora, testa, relata]
Instalando Habilidades
Navegar pelas Habilidades Disponíveis
Você: "Listar habilidades disponíveis"
OpenClaw: "Habilidades disponíveis:
**Desenvolvimento:**
- code_review
- debug_assistant
- test_generator
- refactor_assistant
**Produtividade:**
- meeting_summary
- task_manager
- email_assistant
**Conteúdo:**
- blog_writer
- social_media_manager
- video_script_writer
**Monitoramento:**
- api_monitor
- error_tracker
- deployment_watcher
Use 'install skill [nome]' para adicionar uma habilidade."
Instalar uma Habilidade
Você: "Instalar habilidade code_review"
OpenClaw: "Instalando habilidade code_review...
Ferramentas necessárias:
✓ read (ativado)
✓ search (ativado)
✓ web_search (ativado)
✗ github (não ativado)
Ativar ferramenta github? (s/n)"
Você: "s"
OpenClaw: "Ferramenta github ativada
✓ Habilidade code_review instalada
Experimente: 'Revisar PR #42'"
Desinstalar uma Habilidade
Você: "Desinstalar habilidade blog_writer"
OpenClaw: "Habilidade blog_writer desinstalada"
Criando Habilidades Personalizadas
Habilidades são arquivos YAML que definem fluxos de trabalho. Você pode criar as suas próprias.
Estrutura da Habilidade
name: daily_standup
description: Gera relatório diário de standup
tools:
- jira
- github
- slack
steps:
- action: query_jira
query: "assignee = currentUser() AND status = 'In Progress'"
- action: query_github
query: "author:me is:pr is:open"
- action: format_report
template: |
Relatório Diário de Standup
**Ontem:**
{tarefas_concluidas}
**Hoje:**
{tarefas_em_progresso}
**Impedimentos:**
{impedimentos}
- action: post_slack
channel: "#standup"
message: "{relatorio}"
Exemplo: Habilidade de Backup Personalizada
name: backup_project
description: Faz backup dos arquivos do projeto para o armazenamento em nuvem
tools:
- zip
- exec
steps:
- action: create_zip
source: "."
output: "backup-{date}.zip"
exclude:
- node_modules
- .git
- action: upload
command: "aws s3 cp backup-{date}.zip s3://meus-backups/"
- action: notify
message: "✓ Backup concluído: backup-{date}.zip"
Instalar Habilidade Personalizada
# Salve a habilidade em ~/.openclaw/skills/backup_project.yaml
openclaw skill install ~/.openclaw/skills/backup_project.yaml
Use-a:
Você: "Execute a habilidade backup_project"
OpenClaw: [Executa o fluxo de trabalho de backup]
Combinações de Habilidades
Combine habilidades para fluxos de trabalho poderosos.
Exemplo: Revisão de Código Automatizada + Implantação
Você: "Quando uma PR é mesclada ao main, revise o código, execute testes e implante no staging"
OpenClaw: "Fluxo de trabalho criado:
1. Monitorar GitHub para merges em main
2. Executar habilidade code_review
3. Executar habilidade test_generator
4. Se os testes passarem, executar habilidade deployment_watcher
5. Publicar resultados no Slack #engineering
Fluxo de trabalho ativo."
Exemplo: Pipeline de Conteúdo
Você: "Toda segunda-feira às 9h, pesquise tópicos de IA em alta, escreva um post de blog e crie uma thread no Twitter"
OpenClaw: "Fluxo de trabalho criado:
1. Agendamento: Segunda-feira 9h
2. Executar habilidade trend_monitor
3. Executar habilidade blog_writer
4. Executar habilidade social_media_manager
5. Enviar rascunho para aprovação
Fluxo de trabalho agendado."
Solução de Problemas
Habilidade Falha ao Instalar
Erro: "Ferramentas necessárias ausentes"
Correção: Ative as ferramentas necessárias primeiro:
Você: "Ativar ferramentas: github, slack"
OpenClaw: "github e slack ativados"
Você: "Instalar habilidade code_review"
OpenClaw: "✓ code_review instalado"
Habilidade Não Funciona como Esperado
Erro: "Execução da habilidade falhou"
Correção: Verifique os logs da habilidade:
Você: "Mostrar logs para a habilidade code_review"
OpenClaw: [Mostra logs de execução detalhados]
Permissão da Ferramenta Negada
Erro: "Permissão negada: ferramenta exec"
Correção: Ative a ferramenta:
Você: "Ativar ferramenta exec"
OpenClaw: "Ferramenta exec ativada"
Melhores Práticas
1. Comece com Ferramentas Seguras
Ative primeiro as ferramentas somente leitura:
- read, list, search
- web_search, web_fetch
- memory
Adicione ferramentas de execução (exec, write) apenas quando necessário.
2. Instale Habilidades Gradualmente
Não instale todas as 53 habilidades de uma vez. Comece com 2-3 que resolvam problemas imediatos.
3. Revise o Código da Habilidade
Antes de instalar habilidades da comunidade, revise o arquivo YAML para entender o que ele faz.
4. Monitore o Uso
Verifique quais ferramentas e habilidades o OpenClaw usa:
Você: "Mostrar estatísticas de uso de ferramentas"
OpenClaw: "Uso de ferramentas (últimos 7 dias):
- read: 342 vezes
- web_search: 89 vezes
- write: 45 vezes
- exec: 12 vezes"
5. Crie Aliases de Habilidade
Encurte comandos comuns:
Você: "Criar alias 'revisar' para 'executar habilidade code_review'"
OpenClaw: "Alias criado. Use 'revisar' para executar code_review."
FAQ
P: Posso desativar todas as ferramentas?
R: Sim, mas o OpenClaw não será capaz de fazer muito. Ele precisa de pelo menos memória e contexto para funcionar.
P: As habilidades são seguras?
R: As habilidades da comunidade são revisadas, mas sempre verifique o código antes de instalar. Habilidades maliciosas podem usar indevidamente as ferramentas.
P: Posso modificar habilidades existentes?
R: Sim, copie o YAML da habilidade para ~/.openclaw/skills/ e edite-o.
P: Quantas habilidades posso instalar?
R: Não há limite, mas muitas habilidades podem atrasar o OpenClaw. Instale apenas o que você usa.
P: As habilidades custam dinheiro?
R: As habilidades são gratuitas, mas podem usar ferramentas que custam dinheiro (por exemplo, image_gen usa créditos de API).
P: Posso compartilhar habilidades personalizadas?
R: Sim, publique-as no repositório da comunidade OpenClaw no GitHub.
P: E se uma habilidade quebrar?
R: Desinstale-a e reporte o problema ao autor da habilidade.
P: As habilidades podem acessar meus arquivos?
R: Somente se você ativar as ferramentas read ou write. As habilidades não podem ignorar as permissões das ferramentas.
Conclusão
As ferramentas dão capacidades ao OpenClaw. As habilidades o ensinam fluxos de trabalho. Juntos, eles transformam o OpenClaw de um chatbot em uma potência de automação.
Comece com ferramentas seguras (read, web_search, memory). Instale algumas habilidades que resolvam problemas reais (code_review, meeting_summary). À medida que você ganha confiança, ative ferramentas mais poderosas (exec, database) e crie habilidades personalizadas.
As 25 ferramentas e mais de 53 habilidades representam apenas o começo. A comunidade OpenClaw adiciona novas capacidades diariamente. Junte-se ao ecossistema, compartilhe suas habilidades personalizadas e ajude a construir o futuro da automação de IA.