Guia de Configuração

Locais de Armazenamento

O Clawdbot separa a configuração da instalação:

Essa separação permite atualizações fáceis sem quebrar as configurações pessoais.

Pré-requisitos

• Node.js >= 22
• pnpm (recomendado) ou npm
• Docker (opcional, para configuração em contêiner)

Métodos de Instalação

Instalação Rápida (Recomendada)

curl -fsSL https://clawd.bot/install.sh | bash

Via npm

npm i -g clawdbot
clawdbot setup

Via pnpm

pnpm add -g clawdbot
clawdbot setup

Fluxos de Trabalho

Fluxo de Trabalho Estável (App macOS)

Para a maioria dos usuários, o app macOS oferece a experiência mais fácil:

1. Instalar - Baixar e iniciar Clawdbot.app
2. Integração - Completar o assistente de configuração
3. Permissões - Conceder acesso ao sistema necessário
4. Modo Gateway - Garantir que o Gateway esteja no modo Local
5. Canais - Vincular canais de comunicação (WhatsApp, Telegram, etc.)
6. Verificar - Executar clawdbot health para confirmar a configuração

Fluxo de Trabalho de Desenvolvimento

Para contribuidores e usuários avançados:

# Clonar o repositório
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Instalar dependências
pnpm install

# Iniciar Gateway de desenvolvimento com hot reload
pnpm gateway:watch

Configure o app macOS para o modo de conexão Local. O app se conecta ao Gateway em execução na porta configurada (padrão: ws://127.0.0.1:18789).

Armazenamento de Credenciais

Notas da Plataforma

macOS

O app gerencia o Gateway automaticamente via LaunchAgent.

Linux

Usa serviço de usuário systemd. Habilite lingering para evitar o encerramento do serviço ao fazer logout:

sudo loginctl enable-linger $USER

Windows (WSL2)

Execute o Clawdbot dentro do WSL2 com uma distribuição Linux. A configuração é idêntica ao Linux.

Estratégia de Atualização

Mantenha o conteúdo pessoal nos diretórios ~/.clawdbot/ separado da instalação:

# Atualizar via npm
npm update -g clawdbot

# Ou puxar o código-fonte mais recente
cd clawdbot
git pull
pnpm install

Seu espaço de trabalho e configuração permanecem intactos entre atualizações.

Verificação de Saúde

Verifique sua instalação:

clawdbot health

Saída esperada:

• Status do Gateway: Em execução
• Porta: 18789
• Canais: Conectados
• Agente: Pronto

Solução de Problemas

O Gateway Não Inicia

1. Verifique se a porta 18789 está em uso: lsof -i :18789
2. Revise os logs: cat /tmp/clawdbot/gateway.log
3. Resetar configuração: clawdbot configure --reset

Problemas de Conexão de Canais

1. Reautenticar: clawdbot channels login
2. Verificar credenciais: ls ~/.clawdbot/credentials/
3. Verificar allowlist: Conferir clawdbot.json

Próximos Passos

• Assistente de Integração - Configuração guiada
• Pareamento - Controle de acesso
• Assistente Pessoal - Construa seu assistente