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 Contribuir1. 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 AmbientePré-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 EscritaTom 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
  1. Lista numerada
  2. 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 funcionalidade
  • fix: correção de bug
  • docs: documentação
  • style: formatação, sem mudança de código
  • refactor: refatoração de código
  • test: 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:

  1. Revisão automática: Verificações de CI/CD
  2. Revisão humana: Um mantenedor revisa
  3. Feedback: Sugestões de melhoria (se necessário)
  4. Aprovação: PR aprovado e merged

Tempo médio: 2-5 dias úteis


📅 Timeline Típica
EtapaTempo
Fork e branch5 minutos
Fazer alteraçõesVaria
Abrir PR5 minutos
Revisão inicial1-2 dias
Ajustes (se necessário)1-2 dias
MergeMesmo 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. 🇧🇷