Como Contribuir para o OpenClaw Brasil
Guia completo para contribuidores da comunidade OpenClaw Brasil. Aprenda como colaborar com código, documentação e traduções.
Como Contribuir para o OpenClaw Brasil
Obrigado pelo interesse em contribuir! Este guia explica como você pode ajudar a melhorar o OpenClaw Brasil.
🎯 Formas de Contribuir
1. Reportar Problemas
Encontrou um erro? Algo não funciona?
- Abra uma issue no GitHub
- Use o template de bug report
- Inclua: passos para reproduzir, comportamento esperado, logs
2. Sugerir Melhorias
Tem uma ideia?
- Abra uma issue com label
enhancement - Descreva: problema atual, solução proposta, benefícios
3. Melhorar Documentação
A documentação pode sempre melhorar!
- Corrigir erros de português
- Adicionar exemplos práticos
- Traduzir conteúdo do inglês
- Criar tutoriais passo a passo
4. Contribuir com Código
Para desenvolvedores:
- Corrigir bugs
- Implementar features
- Melhorar performance
- Adicionar testes
5. Criar Skills
Expandir as capacidades do OpenClaw:
- Skills de integração
- Skills de automação
- Skills específicas para Brasil
🛠️ Configurando o Ambiente
Pré-requisitos
- Git instalado
- Node.js 24 LTS
- Hugo (para documentação)
- Editor de código (VS Code recomendado)
Clone o Repositório
# Site Brasil
git clone https://github.com/openclaw/openclaw-brasil
cd openclaw-brasil
# Instalar dependências (se houver)
npm install
# Rodar servidor local
hugo server -D
Estrutura do Projeto
openclaw-brasil/
├── content/ # Conteúdo Markdown
│ ├── blog/ # Artigos do blog
│ ├── docs/ # Documentação
│ ├── guias/ # Guias práticos
│ └── tutoriais/ # Tutoriais passo a passo
├── static/ # Arquivos estáticos
│ └── images/ # Imagens
├── layouts/ # Templates Hugo
├── assets/ # CSS, JS
└── config/ # Configuração Hugo
✍️ Padrões de Escrita
Tom de Voz
- Amigável: Como se estivesse ajudando um colega
- Claro: Evite jargão desnecessário
- Prático: Foque em resultados, não teoria
- Brasileiro: Use português do Brasil, não de Portugal
Exemplos
✅ Bom:
“Para instalar o OpenClaw, abra o terminal e rode…”
❌ Evite:
“Proceda à instalação do software através da execução do comando…”
Formatação Markdown
# Título Principal (H1) - apenas um por página
## Seção (H2)
### Subseção (H3)
**Texto em negrito** para destaque
`código inline` para comandos
```bash
# Bloco de código com linguagem
npm install openclaw
- Lista com bullets
- Para itens sem ordem
- Lista numerada
- Para passos em sequência
Citação ou destaque importante
### SEO Guidelines
- **Título**: Inclua palavra-chave principal
- **Descrição**: 150-160 caracteres, atraente
- **Keywords**: 5-10 termos relevantes
- **Links internos**: Conecte com outras páginas relevantes
---
## 📝 Processo de Contribuição
### 1. Fork o Repositório
Clique em "Fork" no GitHub para criar sua cópia.
### 2. Crie uma Branch
```bash
git checkout -b feature/minha-contribuicao
# ou
git checkout -b fix/correcao-bug
3. Faça suas Alterações
- Escreva código/documentação
- Teste localmente
- Verifique ortografia
4. Commit com Mensagem Clara
git commit -m "docs: adiciona tutorial de integração WhatsApp"
# ou
git commit -m "fix: corrige link quebrado na página de instalação"
Prefixos de Commit:
feat:nova funcionalidadefix:correção de bugdocs:documentaçãostyle:formatação, sem mudança de códigorefactor:refatoração de códigotest:adição de testes
5. Push e Pull Request
git push origin feature/minha-contribuicao
Então abra um Pull Request no GitHub com:
- Descrição clara do que foi feito
- Link para issue relacionada (se houver)
- Screenshots (se aplicável)
✅ Checklist de Qualidade
Antes de enviar seu PR, verifique:
Documentação
- Português correto (sem erros de ortografia)
- Links funcionando
- Imagens carregando
- Formatação Markdown correta
- Frontmatter completo (title, description, date)
Código
- Funciona localmente
- Não quebra funcionalidades existentes
- Segue padrões do projeto
- Comentários onde necessário
Geral
- Branch atualizada com main
- Commits organizados
- Mensagens de commit claras
👥 Quem Revisa
Pull requests são revisados pela equipe de mantenedores. O processo típico:
- Revisão automática: Verificações de CI/CD
- Revisão humana: Um mantenedor revisa
- Feedback: Sugestões de melhoria (se necessário)
- Aprovação: PR aprovado e merged
Tempo médio: 2-5 dias úteis
📅 Timeline Típica
| Etapa | Tempo |
|---|---|
| Fork e branch | 5 minutos |
| Fazer alterações | Varia |
| Abrir PR | 5 minutos |
| Revisão inicial | 1-2 dias |
| Ajustes (se necessário) | 1-2 dias |
| Merge | Mesmo dia da aprovação |
🎁 Reconhecimento
Contribuidores são reconhecidos:
- Nome listado no arquivo CONTRIBUTORS
- Menção em releases notes
- Badge de contribuidor (para contribuições significativas)
❓ Dúvidas?
- Discord: Comunidade OpenClaw
- GitHub Discussions: Para perguntas técnicas
- Issues: Para bugs e sugestões
📚 Recursos Adicionais
Obrigado por contribuir! Cada melhoria ajuda toda a comunidade brasileira de IA. 🇧🇷