Guias OpenClaw

Dominar o OpenClaw é mais que instalar. Estes guias cobrem segurança, performance e casos avançados.

Começando do Jeito Certo

Primeiro Dia

Acabou de instalar? Faça isso em ordem:

  1. Teste básico: Envie “Olá” pelo canal configurado
  2. Personalize: Edite ~/clawd/SOUL.md com seu estilo preferido
  3. Configure memória: Crie ~/clawd/MEMORY.md para contexto persistente
  4. Defina limites: Configure allowlist para segurança

Guia completo do Primeiro Dia

API Keys

Onde conseguir e como configurar:

Configure em ~/clawd/config.yaml:

anthropic:
  apiKey: "sk-ant-..."

openai:
  apiKey: "sk-..."

Guia completo de API Keys

Segurança (Importante)

O Mínimo que Você Precisa Saber

O OpenClaw pode executar comandos no seu sistema. Configure limites:

# config.yaml
security:
  # Só você pode usar
  allowList:
    - "seu-telegram-id"
  
  # Comandos perigosos bloqueados
  denyCommands:
    - "rm -rf"
    - "sudo"

Nunca use allowAll: true em produção.

Privacidade

O que fica local:

  • Histórico de conversas
  • Arquivos de memória
  • Configurações

O que vai para a API:

  • Texto das mensagens que você envia
  • Contexto necessário para resposta

Guia de Segurança | Guia de Privacidade

Otimizando Custos

APIs de IA cobram por token. Dicas para economizar:

1. Escolha o Modelo Certo

ModeloCusto/1M tokensQuando usar
Claude Haiku$0.25Tarefas simples, chat casual
Claude Sonnet$3.00Uso geral, código
Claude Opus$15.00Tarefas complexas

Configure modelo padrão econômico:

model: anthropic/claude-3-haiku-20240307

2. Limite Contexto

Menos histórico = menos tokens:

context:
  maxMessages: 20  # Padrão é 50

3. Use Resumos

Para conversas longas, peça resumos periódicos em vez de manter histórico completo.

Guia de Otimização de Custos

Automação Avançada

Cron Jobs

Execute tarefas em horários específicos:

cron:
  jobs:
    - name: "Resumo matinal"
      schedule: "0 8 * * *"  # 8h todo dia
      task: "Me dê um resumo do dia: clima, calendário, emails importantes"

Heartbeats

O assistente “acorda” periodicamente e age se necessário:

heartbeat:
  intervalMinutes: 30
  prompt: "Verifique emails urgentes e me avise se houver algo importante"

Multi-Agente

Um assistente pode criar sub-agentes para tarefas específicas:

"Pesquise sobre X em background e me avise quando terminar"

Guia de Automação Avançada

Comandos de Voz

No macOS e iOS, você pode falar com o assistente:

  1. Configure Voice Wake: openclaw voice setup
  2. Diga “Hey Claude” (ou sua palavra de ativação)
  3. Fale seu comando

Guia de Voz

Debugging

Quando algo não funciona:

# Diagnóstico completo
openclaw doctor

# Logs em tempo real
openclaw gateway logs -f

# Testar conexão
openclaw test connection

# Verificar config
openclaw config validate

Guia de Debugging

Para Times

Compartilhar assistente com equipe:

  • Configurar múltiplos usuários na allowlist
  • Usar canais compartilhados (Slack, Discord)
  • Separar memória por usuário

Guia para Equipes

Próximos Passos