Você quer um assistente de IA pessoal que possa ser usado em todos os aplicativos de chat, lembre-se do que você disse e até envie lembretes de forma proativa? O Clawdbot é exatamente esse projeto de código aberto revolucionário que transforma o Claude AI em seu assistente exclusivo.
Valor Central: Ao ler este artigo, você dominará os conceitos fundamentais do Clawdbot, aprenderá como instalá-lo e configurá-lo, e descobrirá como conectá-lo via API para que ele te atenda em mais de 8 plataformas, como Discord, Telegram e WhatsApp.
O que é o Clawdbot? Explicação rápida
O Clawdbot é um projeto de assistente pessoal de IA de código aberto desenvolvido por Peter Steinberger (fundador da PSPDFKit). Diferente do ChatGPT ou Claude em versão web tradicional, o Clawdbot funciona diretamente nos aplicativos de chat que você já usa: se você envia uma mensagem no WhatsApp, ele responde no WhatsApp; se faz uma pergunta no Discord, ele responde no Discord.
| Recurso | Clawdbot | Chat de IA Tradicional |
|---|---|---|
| Forma de uso | Dentro de apps de mensagens comuns | Requer abrir uma página web específica |
| Memória de diálogo | Memória persistente multiplataforma | Conversas independentes a cada chat |
| Envio proativo | Suporta lembretes e notificações ativas | Apenas resposta passiva |
| Armazenamento de dados | Arquivos Markdown locais | Armazenado na nuvem |
| Customização | Sistema de Skills totalmente programável | Opções de personalização limitadas |
🎯 Sacada principal: O Clawdbot não é um modelo de IA, mas sim um "gateway de IA" — ele é responsável por conectar seus aplicativos de chat às APIs de Modelos de Linguagem Grande, integrando o poder da IA perfeitamente às suas ferramentas de comunicação diárias.
Arquitetura Principal do Clawdbot: Design em 3 Camadas
Entender a arquitetura do Clawdbot ajuda na configuração e na resolução de problemas futuros. Ele utiliza um design claro de três camadas:
Primeira Camada: Gateway (Portal)
O Gateway é o plano de controle central do Clawdbot, ouvindo por padrão em localhost:18789:
- Gerencia todas as sessões de mensagens.
- Faz o roteamento de mensagens entre diferentes canais.
- Processa chamadas de ferramentas e a execução de Skills.
- Mantém o histórico de conversas e o sistema de memória.
Segunda Camada: Channels (Canais)
Os Channels são responsáveis por conectar o bot a várias plataformas de chat:
| Tipo de Canal | Plataformas Suportadas | Método de Conexão |
|---|---|---|
| Mensageria Instantânea | WhatsApp, Telegram, Signal | API de Bot / Protocolo Web |
| Plataformas de Colaboração | Discord, Slack, Teams | API de Bot |
| Ecossistema Apple | iMessage, macOS | CLI imsg / Integração Nativa |
| Protocolos Abertos | Matrix, WebChat | Integração via Protocolo Padrão |
| Aplicativos Regionais | Zalo, BlueBubbles | Plugins da Comunidade |
Terceira Camada: Modelo de Linguagem Grande (LLM)
O Clawdbot suporta diversos backends de modelos de IA:
| Provedor do Modelo | Método de Autenticação | Cenário de Uso |
|---|---|---|
| Anthropic Claude | Chave de API / OAuth | Recomendação principal, otimizado nativamente para Clawdbot |
| OpenAI GPT | Chave de API / OAuth | Cenários gerais |
| Proxy de API de Terceiros | Chave de API | Otimização de custos, facilidade de acesso |
🎯 Sugestão Técnica: Para chamadas aos modelos Claude, recomendamos obter a chave de API através da plataforma APIYI (apiyi.com). Esta plataforma suporta toda a série de modelos Claude 4, oferece uma interface unificada compatível com OpenAI, tem preços mais acessíveis e facilita o acesso sem complicações com pagamentos internacionais.
Detalhes das 4 principais vantagens do Clawdbot
Vantagem 1: Acesso multicanal contínuo
O conceito "omnichannel" do Clawdbot significa que:
- Um único assistente, múltiplos pontos de entrada: A pergunta que você faz pelo WhatsApp no celular pode ser continuada pelo Discord no computador.
- Sincronização automática de contexto: Não importa por qual canal você fale, o assistente se lembra do conteúdo das conversas anteriores.
- Roteamento inteligente de mensagens: É possível configurar tipos específicos de mensagens para canais específicos.
Vantagem 2: Sistema de memória persistente
Enquanto os chats de IA tradicionais sofrem de "amnésia" a cada nova conversa, o Clawdbot:
- Armazena memórias como arquivos Markdown, de forma semelhante às notas do Obsidian.
- Suporta busca semântica, sendo capaz de relacionar informações que você mencionou anteriormente.
- Oferece armazenamento totalmente local, garantindo que seus dados não sejam enviados para a nuvem.
~/clawd/
├── memories/ # Memórias de conversa
│ ├── 2026-01-26.md # Organizado por data
│ └── topics/ # Classificado por assunto
├── skills/ # Habilidades personalizadas
└── config.yaml # Arquivo de configuração
Vantagem 3: Capacidade de notificações proativas
Este é o recurso matador que diferencia o Clawdbot de outros assistentes de IA:
| Cenários de Proatividade | Exemplo |
|---|---|
| Briefing matinal | Envia sua agenda e a previsão do tempo todo dia às 8h |
| Lembrete de tarefas | Avisa você antes dos prazos de entrega que foram mencionados |
| Alertas de monitoramento | Notifica proativamente se um site que você monitora apresentar erro |
| Execução agendada | Executa scripts periodicamente e reporta os resultados para você |
Vantagem 4: Sistema de Habilidades (Skills)
As Skills são o sistema de "plugins" do Clawdbot, definidas através de arquivos Markdown ou TypeScript:
# skill: web-search
Usa a Brave Search API para pesquisar conteúdos na web
## Gatilhos
Quando o usuário fizer perguntas que exijam informações em tempo real
Passos de execução
- Chama a API do Brave Search
- Analisa os resultados da busca
- Gera uma resposta resumida
A comunidade já contribuiu com mais de 100 Skills prontas para uso, abrangendo:
- Navegação na web e capturas de tela
- Operações de leitura e escrita de arquivos
- Integração de gerenciamento de agenda
- Ambiente de execução de código
- Controle de casa inteligente (Smart Home)
---
## Instalação e Configuração do Clawdbot: 3 passos para começar rápido
### Requisitos de ambiente
| Item | Requisito |
|------|-----------|
| **Node.js** | ≥ 22.x |
| **Sistema Operacional** | macOS / Linux / Windows (WSL2) |
| **Memória** | ≥ 2GB disponível |
| **API de IA** | API Key do Claude ou OpenAI |
### Passo 1: Instalação global
```bash
# Instalar via npm (recomendado)
npm install -g clawdbot@latest
# Ou use o pnpm
pnpm add -g clawdbot@latest
Passo 2: Executar o assistente de configuração
# Inicia o assistente de configuração interativo
clawdbot onboard --install-daemon
O assistente guiará você por:
- Configuração do modelo de IA – Insira sua API Key do Claude ou OpenAI
- Configuração do diretório de trabalho – O padrão é
~/clawd - Ativação de canais – Escolha as plataformas de chat que deseja conectar
- Instalação do daemon – Permite que o Gateway rode continuamente em segundo plano
🚀 Início Rápido: Se você ainda não tem uma API Key do Claude, recomendamos usar a plataforma APIYI (apiyi.com) para obter uma rapidamente. A plataforma oferece interfaces de API prontas para uso e você ganha créditos de teste grátis ao se cadastrar, permitindo concluir a configuração em apenas 5 minutos.
Passo 3: Verificar a instalação
# Verificar o status do serviço
clawdbot status
# Verificação de saúde (health check) profunda
clawdbot health
# Diagnosticar problemas de configuração
clawdbot doctor
Saída esperada:
Gateway: ✓ Running on localhost:18789
Channels: ✓ Discord, Telegram connected
LLM: ✓ Claude API configured
Memory: ✓ 42 memories indexed
Guia de Configuração da Integração do Clawdbot com o Discord
O Discord é um dos canais mais utilizados para o Clawdbot. Siga os passos abaixo para configurar:
Passo 1: Criar o Discord Bot
- Acesse o Discord Developer Portal:
discord.com/developers/applications - Clique em "New Application" para criar o aplicativo.
- Vá para a página "Bot" e clique em "Add Bot".
- Anote o Bot Token (clique em "Reset Token" para gerá-lo).
Passo 2: Configurar as Permissões do Bot
Em "OAuth2 → URL Generator", marque as seguintes opções:
| Categoria de Permissão | Permissão Específica |
|---|---|
| Scopes | bot, applications.commands |
| Bot Permissions | Send Messages, Read Message History, Embed Links |
Passo 3: Convidar o Bot para o Servidor
Use a URL OAuth2 gerada para convidar o Bot para o seu servidor do Discord.
Passo 4: Configurar o Clawdbot
# Configuração interativa do canal do Discord
clawdbot configure --section channels.discord
Após inserir o Bot Token, o Clawdbot concluirá a conexão automaticamente.
Passo 5: Testar a Conversa
No servidor do Discord, mencione (@) o seu Bot ou envie uma mensagem direta:
@ClawdBot Olá, conte-me um pouco sobre você
O Bot usará a API do Claude para gerar uma resposta e enviá-la ao Discord.
Detalhes da Configuração da API do Clawdbot
A inteligência do Clawdbot vem dos Modelos de Linguagem Grandes subjacentes, por isso, configurar a API corretamente é essencial.
API Oficial da Anthropic
# ~/clawd/config.yaml
llm:
provider: anthropic
model: claude-sonnet-4-20250514
apiKey: sk-ant-xxxxx
Vantagens:
- Conexão direta com a fonte oficial, menor latência.
- Suporte aos modelos mais recentes.
Limitações:
- Requer cartão de crédito internacional para pagamento.
- Acesso restrito em algumas regiões.
Proxy de API de Terceiros (Recomendado)
# ~/clawd/config.yaml
llm:
provider: openai-compatible
model: claude-sonnet-4-20250514
apiKey: sk-xxxxx
baseUrl: https://api.apiyi.com/v1 # Usando a interface unificada da APIYI
💰 Otimização de Custos: Para muitos usuários, utilizar a APIYI (apiyi.com) como proxy de API é uma escolha mais vantajosa. A plataforma oferece uma interface compatível com o formato OpenAI, suporta toda a linha de modelos Claude, possui preços competitivos e facilita o pagamento com métodos locais, eliminando a necessidade de canais internacionais complexos.
Autenticação de Assinatura OAuth
Se você já possui uma assinatura Claude Pro/Max:
clawdbot configure --section llm.oauth
A vantagem é que você utiliza sua cota de assinatura existente, sem custos adicionais de API.
Configurações de Skills Comuns do Clawdbot
Skill de Pesquisa na Web
# Configurar Brave Search API
clawdbot configure --section web
# Insira sua Brave Search API Key
Após a configuração, o Clawdbot pode pesquisar informações na web em tempo real para responder a perguntas.
Skill de Operação de Arquivos
O Clawdbot possui capacidade nativa de leitura e escrita de arquivos:
Eu: Me ajude a ler o conteúdo de ~/Documents/notes.md
Bot: Lendo arquivo... [conteúdo do arquivo]
Eu: Adicione uma linha no final do arquivo: "Tarefa de hoje: Finalizar relatório"
Bot: Conteúdo adicionado ao arquivo
Skill de Navegador
Eu: Me ajude a acessar example.com e tirar um print
Bot: [Iniciando navegador] → [Carregando página] → [Gerando captura de tela] → [Retornando imagem]
Skill Personalizada
Basta criar um arquivo Markdown no diretório ~/clawd/skills/:
# skill: daily-report
Gerador de relatório diário de trabalho
## Descrição
Gera um relatório diário com base no histórico de conversas de hoje
Palavras-gatilho
Gerar relatório diário, Resumo de hoje
Lógica de execução
- Ler toda a memória de conversa de hoje
- Extrair conteúdos relacionados ao trabalho
- Gerar um relatório diário estruturado
---
## Estimativa de Custos e Comparação do Clawdbot
| Item de Custo | Custo Mensal | Descrição |
|----------|--------|------|
| **Servidor VPS** | R$ 25-50 (est.) | Opcional, a execução local é gratuita |
| **Claude API** | R$ 50-100 (est.) | Depende do volume de uso |
| **Assinatura Claude Pro** | R$ 110 (aprox.) | Pode economizar taxa de API usando autenticação OAuth |
| **Assinatura Claude Max** | R$ 1100 (aprox.) | Para usuários intensivos, Opus ilimitado |
### Sugestões de Otimização de Custos
1. **Execução Local**: Rode no seu computador pessoal ou em um Mac mini para economizar nos custos de VPS.
2. **Proxy de API**: Use o APIYI (apiyi.com) para chamar a API do Claude com preços mais competitivos.
3. **Escolha do Modelo**: Use o `claude-haiku` para conversas do dia a dia e mude para o `claude-sonnet` apenas para tarefas complexas.
4. **Gerenciamento de Memória**: Limpe memórias desnecessárias regularmente para reduzir o consumo de Tokens.
---
## Clawdbot vs. Outras Soluções
| Dimensão de Comparação | Clawdbot | ChatGPT App | Claude App | Bot Próprio |
|----------|----------|-------------|------------|----------|
| **Suporte Multiplataforma** | ⭐⭐⭐⭐⭐ 8+ plataformas | ⭐⭐ Apenas App | ⭐⭐ Apenas App | ⭐⭐⭐ Requer desenvolvimento individual |
| **Memória de Diálogo** | ⭐⭐⭐⭐⭐ Armazenamento local persistente | ⭐⭐⭐ Nuvem limitada | ⭐⭐⭐ Nuvem limitada | ⭐⭐ Requer implementação manual |
| **Notificações Ativas** | ⭐⭐⭐⭐⭐ Suporte total | ❌ Sem suporte | ❌ Sem suporte | ⭐⭐⭐ Requer implementação manual |
| **Proteção de Privacidade** | ⭐⭐⭐⭐⭐ Armazenamento local | ⭐⭐ Armazenamento em nuvem | ⭐⭐ Armazenamento em nuvem | ⭐⭐⭐⭐ Depende da implementação |
| **Customização** | ⭐⭐⭐⭐⭐ Sistema de Skills | ⭐⭐ GPTs limitado | ⭐⭐ Projects | ⭐⭐⭐⭐⭐ Totalmente customizável |
| **Dificuldade de Início** | ⭐⭐⭐ Requer base técnica | ⭐⭐⭐⭐⭐ Pronto para usar | ⭐⭐⭐⭐⭐ Pronto para usar | ⭐ Exige muito desenvolvimento |
> 💡 **Dicas de Escolha**: O Clawdbot é ideal para quem tem certa base técnica e busca privacidade e personalização profunda. Se você precisa apenas de conversas simples com IA, os apps oficiais já bastam; mas se você quer que a IA se integre de verdade ao seu fluxo de trabalho diário, vale a pena dedicar um tempo para aprender o Clawdbot.
---
## Perguntas Frequentes (FAQ)
<details open>
<summary><strong>Q1: O Clawdbot precisa de um servidor VPS?</strong></summary>
Não é obrigatório. O Clawdbot pode rodar no seu computador pessoal, funcionando perfeitamente enquanto ele estiver ligado. Mas se você quer que ele fique online 24 horas por dia, recomendo usar:
- Um computador que fique sempre ligado em casa (como um Mac mini, por exemplo)
- Um servidor em nuvem (VPS, com custo aproximado de R$ 25-50/mês)
- Um dispositivo NAS local
</details>
<details open>
<summary><strong>Q2: Como consigo a API do Claude sem um cartão de crédito internacional?</strong></summary>
Você pode obter acesso à API do Claude através da plataforma **APIYI (apiyi.com)**. Essa plataforma aceita formas de pagamento facilitadas, oferece uma interface de API idêntica à oficial e muitas vezes com preços mais em conta. Após o cadastro, basta pegar sua API Key e configurar no Clawdbot.
</details>
<details open>
<summary><strong>Q3: O Clawdbot suporta português?</strong></summary>
Sim, totalmente. O Clawdbot em si funciona como um gateway; a "inteligência" vem do modelo subjacente (Claude/GPT). Como esses Modelos de Linguagem Grande possuem excelente suporte ao português, você pode realizar todas as interações com o Clawdbot no nosso idioma sem problemas.
</details>
<details open>
<summary><strong>Q4: Como fica a privacidade das minhas conversas?</strong></summary>
O Clawdbot foi projetado com foco em "Local-first":
- O histórico das conversas é salvo no seu próprio dispositivo (em arquivos Markdown)
- O Gateway roda em `localhost`, não ficando exposto diretamente à internet pública
- Pode ser acessado com segurança via túnel SSH ou Tailscale
- Apenas as chamadas para o modelo de IA precisam de conexão com a internet (requisições de API)
</details>
<details open>
<summary><strong>Q5: Onde posso pedir ajuda se tiver problemas?</strong></summary>
O Clawdbot tem uma comunidade ativa:
- **Servidor no Discord**: Lá você pode conversar diretamente com duas instâncias do Clawdbot e tirar dúvidas
- **GitHub Issues**: `github.com/clawdbot/clawdbot`
- **Documentação Oficial**: `docs.clawd.bot`
Relatos de bugs costumam ser respondidos rapidamente, e às vezes o autor corrige o problema em tempo real durante o chat.
</details>
<details open>
<summary><strong>Q6: Como instalar no Windows?</strong></summary>
Para usuários de Windows, recomendamos fortemente o uso do WSL2:
1. Instale o WSL2 (recomendamos a distribuição Ubuntu)
2. Instale o Node.js 22+ dentro do WSL2
3. Siga os passos de instalação para Linux no Clawdbot
O suporte nativo para Windows ainda não está perfeito e você pode acabar encontrando alguns probleminhas chatos.
</details>
---
## Usos Avançados do Clawdbot
### 1. Colaboração entre Múltiplos Agentes
O Clawdbot permite criar várias sessões (Sessions) que podem se comunicar entre si:
Sessão A (Assistente de Pesquisa): Pesquisa dados de mercado
Sessão B (Assistente de Escrita): Recebe os dados de A e gera um relatório
Sessão C (Assistente de Revisão): Analisa o relatório de B e sugere melhorias
### 2. Workflows Automatizados
Integrando com tarefas agendadas (Cron):
- Todo dia às 8h: Resumir e-mails importantes
- Toda segunda às 9h: Gerar o resumo das atividades da semana anterior
- Todo dia 1º: Contabilizar o uso da API no mês
### 3. Integração com Casa Inteligente
Conecte dispositivos inteligentes via Home Assistant ou MQTT:
Eu: Deixe a luz da sala um pouco mais fraca
Bot: [Chamando API do Home Assistant] Brilho da luz da sala ajustado para 50%
### 4. Auxílio no Desenvolvimento de Código
O Clawdbot consegue:
- Ler arquivos de código e explicá-los
- Executar comandos no shell
- Navegar em repositórios do GitHub
- Gerar código e salvá-lo diretamente em arquivos
---
## Resumo e Próximos Passos
O Clawdbot representa um novo paradigma para assistentes de IA pessoais:
| Valores principais | Descrição |
|----------|------|
| **Em todos os lugares** | Use IA nos seus aplicativos de chat favoritos |
| **Memória eterna** | Memória persistente para realmente te conhecer |
| **Serviço proativo** | Chega de esperar passivamente; receba lembretes e notificações proativas |
| **Controle total** | Código aberto e auto-hospedado; os dados são sempre seus |
| **Expansão ilimitada** | O sistema de Skills torna as capacidades infinitas |
**Próximos passos**:
1. Instale o Clawdbot: `npm install -g clawdbot@latest`
2. Obtenha a API do Claude: Recomendamos o APIYI (apiyi.com) para um acesso rápido
3. Execute o assistente de configuração: `clawdbot onboard --install-daemon`
4. Conecte seu primeiro canal (recomendamos começar pelo Discord)
5. Entre na comunidade do Clawdbot no Discord para trocar experiências
---
## Referências
1. **Site oficial do Clawdbot**: Apresentação do produto e início rápido
- Link: `clawd.bot`
2. **Documentação oficial do Clawdbot**: Guia de configuração completo
- Link: `docs.clawd.bot`
3. **Repositório no GitHub**: Código aberto e Issues
- Link: `github.com/clawdbot/clawdbot`
4. **Análise profunda do MacStories**: Compartilhamento de experiência de uso
- Link: `macstories.net/stories/clawdbot-showed-me-what-the-future-of-personal-ai-assistants-looks-like/`
5. **Site pessoal de Peter Steinberger**: Blog do autor
- Link: `steipete.me`
---
> 📝 **Autor**: Equipe APIYI
> 🔗 **Troca de experiências técnicas**: Visite apiyi.com para mais dicas sobre o uso de APIs de IA
> 📅 **Data de atualização**: Janeiro de 2026
