Guia de configuração do Clawdbot
Este guia abrangente de configuração do Clawdbot irá orientá-lo através de tudo o que você precisa para colocar seu assistente de IA pessoal em funcionamento. Seja no macOS, Windows ou Linux, este tutorial cobre instalação, configuração e conexão da sua primeira plataforma de chat.
Pré-requisitos
Antes de iniciar a configuração do Clawdbot, certifique-se de ter:
- Node.js 22+ - Baixe de nodejs.org
- Uma chave API de provedor de IA - Anthropic Claude (recomendado) ou OpenAI
- Um sistema operacional suportado:
- macOS 13 (Ventura) ou posterior
- Windows 10/11 com WSL2
- Linux (Ubuntu, Debian, Fedora, Arch)
Passo 1: Instalar o Clawdbot
Instalação rápida (todas as plataformas)
A maneira mais rápida de instalar o Clawdbot é usando o instalador de uma linha:
curl -fsSL https://clawd.bot/install.sh | bashEste script automaticamente:
- Detecta seu sistema operacional
- Instala as dependências necessárias
- Configura o Clawdbot globalmente
Instalação via NPM
Se você prefere npm:
npm i -g clawdbotVerificar instalação
Verifique se o Clawdbot está instalado corretamente:
clawdbot --versionPasso 2: Executar a integração
Inicie o assistente de configuração interativo:
clawdbot onboard --install-daemonO processo de integração irá guiá-lo através de:
- Seleção de provedor de IA - Escolha Claude, OpenAI ou modelos locais
- Configuração de chave API - Insira suas credenciais API
- Instalação de daemon - Configure o serviço em segundo plano
- Configuração inicial - Preferências básicas
Passo 3: Configurar seu provedor de IA
Usando Anthropic Claude (recomendado)
- Obtenha uma chave API de console.anthropic.com
- Durante a integração, selecione "Anthropic Claude"
- Insira sua chave API quando solicitado
Para melhores resultados, a equipe do Clawdbot recomenda:
- Assinatura Anthropic Pro/Max para limites de taxa mais altos
- Modelo Opus 4.5 para melhor desempenho
Usando OpenAI
- Obtenha uma chave API de platform.openai.com
- Selecione "OpenAI" durante a integração
- Insira sua chave API
Usando modelos locais
Para privacidade completa e uso offline:
- Instale um provedor de modelo local (Ollama, LM Studio, etc.)
- Selecione "Modelo local" durante a integração
- Configure o endpoint local
Passo 4: Conectar plataformas de chat
O poder do Clawdbot vem da integração de chat. Veja como conectar plataformas populares:
Configuração do WhatsApp
- Execute
clawdbot connect whatsapp - Escaneie o código QR com seu telefone
- O WhatsApp Web se conectará ao Clawdbot
Configuração do Telegram
- Crie um bot via @BotFather
- Obtenha seu token de bot
- Execute
clawdbot connect telegram --token YOUR_TOKEN
Configuração do Discord
- Crie um aplicativo Discord em discord.com/developers
- Crie um bot e obtenha o token
- Execute
clawdbot connect discord --token YOUR_TOKEN
Configuração do Slack
- Crie um app Slack em api.slack.com
- Configure OAuth e obtenha os tokens
- Execute
clawdbot connect slack --token YOUR_TOKEN
Passo 5: Testar sua configuração
Envie uma mensagem de teste para verificar se tudo funciona:
Via terminal
clawdbot chat "Olá, o que você pode fazer?"Via app de chat
Envie uma mensagem para sua plataforma de chat conectada. O Clawdbot deve responder em segundos.
Passo 6: Configurar habilidades (opcional)
Estenda o Clawdbot com habilidades da comunidade:
# Navegar habilidades disponíveis
clawdbot skills list
# Instalar uma habilidade
clawdbot skills install <skill-name>Habilidades populares incluem:
- Home Assistant - Controle de casa inteligente
- GitHub - Gerenciamento de repositórios
- Calendar - Gerenciamento de agenda
- Spotify - Controle de música
Solução de problemas
Problemas comuns
"Comando não encontrado" após instalação
- Reinicie seu terminal
- Verifique se npm global bin está no seu PATH
Erros de conexão API
- Verifique se sua chave API está correta
- Verifique sua conexão com a internet
- Certifique-se de ter créditos API
Plataforma de chat não conecta
- Verifique se os tokens estão corretos
- Verifique requisitos específicos da plataforma
- Revise os logs:
clawdbot logs
Obtendo ajuda
- Discord: discord.gg/clawd
- GitHub Issues: github.com/clawdbot/clawdbot/issues
- Documentação: docs.clawd.bot
Próximos passos
Agora que sua configuração do Clawdbot está completa:
- Explore capacidades - Pergunte ao Clawdbot o que ele pode fazer
- Configure automações - Crie jobs cron para tarefas recorrentes
- Instale habilidades - Estenda a funcionalidade com plugins
- Junte-se à comunidade - Compartilhe suas configurações no Discord
Conclusão
Parabéns! Você completou o guia de configuração do Clawdbot. Seu assistente de IA pessoal agora está pronto para ajudar com navegação, gerenciamento de arquivos, automação e mais - tudo através dos seus aplicativos de chat favoritos.
Recursos:

