O OpenClaw é um framework de tempo de execução para assistentes de Inteligência Artificial (IA) de código aberto, que suporta arquiteturas multi-modelo, multi-canal e multi-plugin. Mas seu verdadeiro poder não está na configuração padrão, e sim na sua capacidade extrema de personalização. Este artigo detalha todo o processo de customização, desde os arquivos de configuração até a implantação.
Seja para construir um bot de atendimento ao cliente dedicado, um assistente pessoal com personalidade rica ou um Agente empresarial integrado a ferramentas internas, o OpenClaw oferece a flexibilidade necessária. Como acompanhamos aqui no Brasil Vibe Coding, a personalização de IA é um tema cada vez mais quente.
Antes de Começar: Entendendo a Estrutura de Arquivos
A configuração do OpenClaw possui duas camadas: o arquivo de configuração global e os arquivos de Workspace. Entender ambos é a base para todo o trabalho de customização.
O Arquivo de Configuração
A configuração global reside em ~/.openclaw/openclaw.json, utiliza o formato JSON5 (permitindo comentários e vírgulas no final) e passa por uma rigorosa validação de esquema. Veja um exemplo:
{
// Modelo padrão
"defaultModel": "anthropic/claude-sonnet-4-20250514",
// Porta do Gateway
"port": 18789,
// Configuração Multi-Agente
"agents": {
"list": [
{
"name": "main",
"workspace": "/.openclaw/workspace",
"agentDir": "/.openclaw/agents/main",
},
{
"name": "customer-service",
"workspace": "/.openclaw/workspace-cs",
"agentDir": "/.openclaw/agents/cs",
},
],
},
// Plugins de Canal
"channels": {
"telegram": {
"token": "YOUR_BOT_TOKEN",
},
},
}
Cada Agente recebe diretórios independentes de workspace, agentDir e sessões. Isso permite executar assistentes de IA completamente diferentes na mesma instância do OpenClaw.
Nota: O JSON5 é mais tolerante, mas a validação de esquema é rigorosa — campos extras causarão erros.
Arquivos de Workspace
O diretório workspace contém os arquivos que definem a "alma" da sua IA:
SOUL.md— Personalidade, tom, valores definidos.IDENTITY.md— Informações de identidade (nome, gênero, função).AGENTS.md— Instruções operacionais e regras de comportamento.USER.md— Perfil do usuário para ajudar a IA a entender quem está atendendo.TOOLS.md— Notas de ferramentas, chaves API e dicas de uso.
Esses arquivos são carregados automaticamente em cada início de sessão. A maior parte da customização se resume a editar esses arquivos Markdown simples.
Personalização da Personalidade: SOUL.md e IDENTITY.md
A maneira mais direta de personalizar o OpenClaw é editando os arquivos de personalidade. O mesmo modelo subjacente pode apresentar comportamentos completamente diferentes.
Criando a Personalidade da Sua IA
Aqui está um exemplo de SOUL.md para um cenário de atendimento técnico ao cliente:
# SOUL.md - Assistente de Suporte Técnico
## Princípios Fundamentais
Profissional, mas não frio. Usuários com problemas técnicos costumam estar ansiosos.
Equilibre precisão com empatia.
Resolva primeiro, explique depois. Ofereça a solução, depois explique brevemente
por que o problema ocorreu.
Reconheça a incerteza. Se não tiver certeza, diga. Não fabrique informações.
## Tom- Use tratamento formal
- Evite excesso de pontos de exclamação
- Mantenha termos técnicos em inglês com breves explicações
- Respostas com menos de 200 palavras, a menos que o usuário solicite detalhes
## Limites- Responda apenas a perguntas técnicas relacionadas ao produto
- Questões de faturamento/reembolso → direcione ao suporte humano
- Não faça comparações com concorrentes
Um bom SOUL.md é composto por quatro partes: princípios fundamentais (o tipo de IA), regras de tom (como se comunicar), limites comportamentais (o que não fazer) e tratamento de casos incomuns (o que fazer em situações ambíguas). Quanto mais específico, mais consistente será o comportamento.