Erro Skill Not Found — Skill Não Encontrada

Como resolver erro de skill não encontrada no OpenClaw. Instalação, paths e troubleshooting.

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 Comuns1. 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çõesVerificar 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ões
  • weather - Previsão do tempo
  • web_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:

  1. Crie diretório: mkdir -p ~/clawd/skills/minha-skill
  2. Crie SKILL.md com instruções
  3. Opcionalmente adicione código
  4. Reinicie gateway
Próximos Passos