Construindo um Assistente Pessoal

Visão Geral

O Clawdbot serve como um gateway que conecta plataformas de mensagens a agentes de IA, permitindo que você interaja com um assistente de IA através do seu aplicativo de mensagens preferido.

Considerações de Segurança

O Clawdbot pode executar comandos, acessar arquivos e enviar mensagens. Medidas de segurança importantes:

• Configure channels.whatsapp.allowFrom para restringir o acesso
• Use um número de telefone dedicado para o assistente
• Comece com os heartbeats desabilitados ("0m") até confiar
• Revise as permissões antes de conceder acesso ao shell

Pré-requisitos

• Node.js 22+
• Clawdbot instalado globalmente
• Um segundo número de telefone para o assistente (recomendado)

Arquitetura Recomendada

Use dois telefones para a configuração mais segura:

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Seu Telefone   │────▶│  Assistente     │────▶│  Seu Computador │
│  (Pessoal)      │     │  Número Tel.    │     │  (Clawdbot)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Seu dispositivo pessoal envia mensagens para um segundo telefone (o assistente) que está vinculado ao Clawdbot rodando no seu computador.

Início Rápido

1. Vincular WhatsApp Web

clawdbot channels login whatsapp

Escaneie o código QR com seu telefone assistente.

2. Iniciar Gateway

clawdbot gateway --port 18789

3. Configurar Lista de Permitidos

Edite ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"],
      "dmPolicy": "allowlist"
    }
  }
}

Espaço de Trabalho e Memória

Espaço de Trabalho Padrão

Localização: ~/.clawdbot/workspace

Contém arquivos de instruções:

Controle de Versão

Trate seu espaço de trabalho como um repositório git para backup:

cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"

Sessões

As sessões são armazenadas por remetente. Comandos para gerenciar sessões:

Heartbeats (Tarefas Proativas)

Heartbeats são verificações periódicas onde o agente lê HEARTBEAT.md para tarefas.

Configuração

Em ~/.clawdbot/clawdbot.json:

{
  "heartbeat": {
    "interval": "30m",
    "enabled": true
  }
}

Comportamento

• Padrão: A cada 30 minutos
• O agente lê HEARTBEAT.md para tarefas pendentes
• Responde com HEARTBEAT_OK se nada precisa de atenção
• Configure para "0m" para desabilitar

Exemplo de HEARTBEAT.md

# Tarefas de Heartbeat

- Verificar novos e-mails e resumir os importantes
- Revisar calendário para próximas reuniões
- Monitorar preços de ações para AAPL, GOOGL

Manipulação de Mídia

Anexos Recebidos

O Clawdbot pode receber e processar:

• Imagens
• Documentos
• Notas de voz
• Vídeos

Mídia de Saída

Envie mídia usando a sintaxe MEDIA:<caminho>:

MEDIA:/path/to/image.png

Operações

Comandos de Status

# Verificar saúde
clawdbot health

# Ver status
clawdbot status

# Verificar logs
tail -f /tmp/clawdbot/gateway.log

Registro

Os logs são armazenados em /tmp/clawdbot/:

Configuração Multi-Canal

Configure múltiplos canais em clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+1234567890"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Próximos Passos

• Pareamento - Configurar controle de acesso
• Vitrine - Veja o que outros construíram
• Habilidades - Estender com plugins