--- title: "FAQ Configuração — SOUL.md, MEMORY.md e API Keys" url: "https://openclaw.ia.br/faq/configuracao/" markdown_url: "https://openclaw.ia.br/faq/configuracao.MD" description: "Como configurar o OpenClaw: personalizar a personalidade (SOUL.md), memória de longo prazo (MEMORY.md) e chaves de API (Anthropic, OpenAI)." date: "2026-02-01" author: "" --- # FAQ Configuração — SOUL.md, MEMORY.md e API Keys Como configurar o OpenClaw: personalizar a personalidade (SOUL.md), memória de longo prazo (MEMORY.md) e chaves de API (Anthropic, OpenAI). # 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: ```markdown # 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: ```bash 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/? | Arquivo | Propósito | Quem Atualiza | |---------|-----------|---------------| | MEMORY.md | Informações importantes curadas | Você ou o agente | | memory/YYYY-MM-DD.md | Logs diários | Automático | ### O Que Guardar Nele? ```markdown # 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](https://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](https://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: ```bash nano ~/.openclaw/config.yaml ``` ```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: ```bash 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: ```yaml anthropic: api_key: sk-ant-chave-principal openai: api_key: sk-chave-fallback ``` ### Quanto Custa Cada API? Veja detalhes em [FAQ Custos](/faq/custos/), mas resumindo: | Provider | Modelo | Custo (1M tokens) | |----------|--------|-------------------| | Anthropic | Sonnet 3.5 | $3 in / $15 out | | Anthropic | Haiku | $0.25 in / $1.25 out | | OpenAI | GPT-4o | $5 in / $15 out | | OpenAI | GPT-3.5 | $0.50 in / $1.50 out | --- ## 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? ```yaml # ~/.openclaw/config.yaml model: claude-3-5-sonnet-20241022 ``` Ou temporariamente via comando: ``` /model claude-3-opus ``` ### Qual Modelo Escolher? | Uso | Modelo Recomendado | |-----|-------------------| | Dia a dia | Sonnet 3.5 | | Tarefas complexas | Opus | | Alto volume | Haiku | | Privacidade total | Llama3 (local) | | Sem custo | Llama3 (local) | --- ## 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](/blog/instalar-openclaw-gratis-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 | Aspecto | Local | Oracle Cloud | |---------|-------|--------------| | Custo | Sua eletricidade | Grátis | | Disponibilidade | Só quando PC ligado | 24/7 | | Manutenção | Você faz | Você faz | | Performance | Seu hardware | 4 OCPUs, 24GB RAM | --- ## Próximas Perguntas - [FAQ Geral](/faq/geral/) - [FAQ Custos](/faq/custos/) - [FAQ Integrações](/faq/integracoes/) - [FAQ Técnico](/faq/tecnico/)