FAQ Configuração

Tudo sobre configurar seu OpenClaw: personalidade, memória e chaves de API.

SOUL.md — Personalidade

O Que é SOUL.md?

É o arquivo que define quem seu agente é. Personalidade, tom de voz, limites de comportamento. Pense como o “manual de instruções” da identidade do seu assistente.

Onde Fica?

~/clawd/SOUL.md

O Que Colocar Nele?

Um SOUL.md típico contém:

# Quem Sou

Sou um assistente profissional e direto. Evito enrolação.

## Tom de Voz
- Formal mas acessível
- Respostas concisas
- Uso de exemplos práticos

## Limites
- Não respondo sobre [tópicos sensíveis]
- Sempre confirmo antes de executar ações destrutivas

## Preferências do Usuário
- Chama o usuário de "você"
- Respostas em português brasileiro

Quando Ele é Lido?

O SOUL.md é carregado no início de cada sessão. Mudanças exigem reiniciar o gateway:

openclaw gateway restart

Posso Ter Múltiplas Personalidades?

Sim! Configure agentes diferentes:

~/clawd-trabalho/SOUL.md   # Agente profissional
~/clawd-pessoal/SOUL.md    # Agente casual

E inicie com workspaces separados.

MEMORY.md — Memória de Longo Prazo

O Que é MEMORY.md?

Sua memória curada. Diferente dos logs diários (automáticos), MEMORY.md contém informações importantes que você ou o agente salvam intencionalmente.

Onde Fica?

~/clawd/MEMORY.md

Qual a Diferença para memory/?

O Que Guardar Nele?

# Informações Importantes

## Sobre o Usuário
- Nome: Diego
- Localização: Florianópolis
- Trabalho: Desenvolvedor

## Preferências
- Gosta de café sem açúcar
- Prefere comunicação direta

## Projetos Ativos
- openclaw.ia.br - Site de IA
- golang.com.br - Comunidade Go

## Contatos Frequentes
- Daniele (namorada)
- João (cliente principal)

Como o Agente Acessa?

O agente usa memory_search para buscar semanticamente nos arquivos de memória. Você pode também pedir:

"Salve que eu prefiro reuniões pela manhã"
"O que você sabe sobre meus projetos?"

API Keys — Chaves de API

Quais APIs Preciso?

Mínimo obrigatório: Uma das duas:

• Anthropic (Claude) — Recomendado
• OpenAI (GPT-4)

Opcionais:

• Brave Search (buscas web)
• Calendário (Google Calendar API)
• E-mail (IMAP/SMTP ou API)

Onde Consigo a Key da Anthropic?

1. Acesse console.anthropic.com
2. Crie uma conta
3. Vá em “API Keys”
4. Clique “Create Key”
5. Copie a chave (começa com sk-ant-...)

Créditos: Novos usuários ganham $5 de crédito grátis.

Onde Consigo a Key da OpenAI?

1. Acesse platform.openai.com
2. Crie uma conta
3. Vá em “API Keys”
4. Clique “Create new secret key”
5. Copie a chave (começa com sk-...)

Onde Configuro a Key?

No arquivo de configuração:

nano ~/.openclaw/config.yaml

anthropic:
  api_key: sk-ant-sua-chave-aqui

# OU para OpenAI
openai:
  api_key: sk-sua-chave-aqui

Ou via variável de ambiente:

export ANTHROPIC_API_KEY=sk-ant-sua-chave-aqui

Como Protejo Minha Key?

1. Nunca comite no git — Use .gitignore
2. Permissões do arquivo — chmod 600 ~/.openclaw/config.yaml
3. Use variáveis de ambiente em vez de hardcode
4. Gere nova key se vazar

Posso Usar Múltiplas Keys?

Sim! Para diferentes modelos ou fallback:

anthropic:
  api_key: sk-ant-chave-principal

openai:
  api_key: sk-chave-fallback

Quanto Custa Cada API?

Veja detalhes em FAQ Custos, mas resumindo:

Modelos Disponíveis

Quais Modelos Posso Usar?

Anthropic (Claude):

• claude-3-5-sonnet-20241022 — Melhor custo-benefício
• claude-3-opus-20240229 — Máxima qualidade
• claude-3-haiku-20240307 — Mais rápido e barato

OpenAI:

• gpt-4o — Versão otimizada do GPT-4
• gpt-4-turbo — Alta qualidade
• gpt-3.5-turbo — Econômico

Locais (Ollama):

• llama3 — Meta Llama 3
• mistral — Mistral 7B
• mixtral — Mistral 8x7B

Como Mudo o Modelo?

# ~/.openclaw/config.yaml
model: claude-3-5-sonnet-20241022

Ou temporariamente via comando:

/model claude-3-opus

Qual Modelo Escolher?

Oracle Cloud — Instalação Gratuita

Posso Rodar OpenClaw de Graça?

Sim! Oracle Cloud oferece VMs gratuitas para sempre:

• 4 OCPUs ARM
• 24GB RAM
• 200GB disco

Mais que suficiente para OpenClaw.

Como Configurar?

Veja nosso guia completo: Instalar OpenClaw Grátis na Oracle Cloud

Resumo:

1. Crie conta Oracle Cloud (cartão exigido, mas não cobra)
2. Provisione VM ARM (always free)
3. Instale Node.js + OpenClaw
4. Configure port forwarding para WhatsApp/Telegram

Vantagens vs Rodar Local

Próximas Perguntas

• FAQ Geral
• FAQ Custos
• FAQ Integrações
• FAQ Técnico