Erro Skill Not Found — Skill Não Encontrada
Como resolver erro de skill não encontrada no OpenClaw. Instalação, paths e troubleshooting.
⏱️ 2 min de leitura
Erro: Skill Not Found
O OpenClaw não conseguiu encontrar uma skill. Veja como resolver.
O Que Significa
Error: Skill 'weather' not found
Error: Cannot load skill at /path/to/skill
Error: SKILL.md not found in skill directory
O sistema tentou usar uma skill que não está instalada ou está com path incorreto.
Causas Comuns
1. Skill Não Instalada
A skill não foi instalada via ClawdHub ou manualmente.
2. Nome Incorreto
Digitou errado o nome da skill.
3. Path Incorreto
Skill está em diretório diferente do esperado.
4. SKILL.md Ausente
A skill existe mas falta o arquivo de definição.
Soluções
Verificar Skills Instaladas
# Listar skills disponíveis
clawdhub list
# Ou pergunte
"Quais skills tenho instaladas?"
Instalar Skill
# Via ClawdHub
clawdhub install weather
# Verificar instalação
clawdhub list | grep weather
Verificar Nome Correto
Nomes de skills são case-sensitive:
- ✅
weather - Não
Weather - Não
WEATHER
Verificar Path
Skills devem estar em:
~/clawd/skills/[nome]/SKILL.md
Ou no path global:
~/.openclaw/skills/[nome]/SKILL.md
Criar SKILL.md Faltante
Se a skill existe mas falta o arquivo:
# SKILL.md mínimo
---
name: nome-da-skill
description: O que a skill faz
---
## Uso
Como usar a skill...
Estrutura Correta de Skill
skills/
└── weather/
├── SKILL.md # Obrigatório
├── index.js # Código (opcional)
└── config.yaml # Config (opcional)
Verificar Logs
# Ver erro detalhado
openclaw logs | grep -i skill
# Modo debug
DEBUG=skills* openclaw gateway restart
Reinstalar Skill
Se nada funcionar:
# Remover
clawdhub uninstall weather
# Reinstalar
clawdhub install weather
Skills Built-in
Algumas skills já vêm com o OpenClaw:
calculator- Cálculos e conversõesweather- Previsão do tempoweb_search- Busca na web
Se uma built-in não funciona, atualize o OpenClaw:
npm update -g openclaw
Criar Skill Local
Se quiser criar skill própria:
- Crie diretório:
mkdir -p ~/clawd/skills/minha-skill - Crie SKILL.md com instruções
- Opcionalmente adicione código
- Reinicie gateway
Próximos Passos
- Criar sua skill
- ClawdHub - Marketplace
- Troubleshooting