Assistente de Integração (CLI)
Use o assistente CLI para configurar o Clawdbot com configuração guiada para Gateway, canais, habilidades e padrões do espaço de trabalho.
Visão Geral
O assistente de integração é o método de configuração recomendado para o Clawdbot em macOS, Linux ou Windows (via WSL2). Ele fornece um fluxo de configuração guiado para conexões de Gateway locais ou remotas, canais, habilidades e padrões do espaço de trabalho.
Comandos Principais
| Comando | Descrição |
|---|---|
clawdbot onboard | Assistente de configuração principal |
clawdbot dashboard | Abre a UI de Controle para chat no navegador |
clawdbot configure | Reconfigurar instalação existente |
clawdbot configure --section web | Configurar busca web (Brave Search API) |
Modos de Configuração
Início Rápido (Recomendado)
Configuração padrão para a maioria dos usuários:
- Gateway local em loopback
- Porta 18789 com autenticação por token
- DMs do Telegram/WhatsApp usam modo allowlist
Modo Avançado
Controle total sobre todas as etapas de configuração para usuários avançados.
Fluxo de Configuração
1. Detecção de Configuração Existente
O assistente detecta ~/.clawdbot/clawdbot.json e oferece:
- Manter - Usar configuração existente
- Modificar - Atualizar configurações específicas
- Resetar - Começar do zero
2. Modelo e Autenticação
Escolha seu provedor de IA:
| Provedor | Descrição |
|---|---|
| Anthropic API Key | Recomendado para melhor desempenho |
| Anthropic OAuth | Para assinantes Claude Pro/Max |
| OpenAI API Key | GPT-4 e outros modelos |
| OpenAI Codex | Assinatura focada em código |
| Vercel AI Gateway | Opção de proxy |
| Modelos Locais | Operação offline |
3. Configuração do Espaço de Trabalho
Espaço de trabalho padrão: ~/.clawdbot/workspace
Arquivos de bootstrap criados:
AGENTS.md- Configuração do agenteSOUL.md- Configurações de personalidadeTOOLS.md- Ferramentas disponíveisIDENTITY.md- Informações de identidade
4. Configuração do Gateway
Configure as definições do seu Gateway:
- Porta: Padrão 18789
- Endereço de Bind: Loopback ou rede
- Modo de Autenticação: Baseado em token (recomendado)
- Tailscale: Exposição remota opcional
5. Configuração de Canais
Integrações opcionais:
- Telegram
- Discord
- Slack
- Signal
- iMessage
- Google Chat
- Mattermost
6. Instalação do Daemon
- macOS: LaunchAgent
- Linux/WSL2: unidade de usuário systemd
7. Verificação de Saúde
Valida a inicialização do Gateway e conectividade.
8. Instalação de Habilidades
Pacotes de habilidades opcionais via npm/pnpm.
Modo Remoto
Conectar a um Gateway existente rodando em outro lugar:
clawdbot onboard --remoteNenhuma instalação é realizada no host remoto - apenas configura a conexão do cliente local.
Modo Não Interativo
Para automação e scripts:
clawdbot onboard --non-interactive \
--auth-choice anthropic \
--anthropic-api-key $ANTHROPIC_API_KEYMúltiplos Agentes
Criar instâncias de agentes isoladas:
clawdbot agents add work
clawdbot agents add personal
clawdbot agents listCada agente tem seu próprio espaço de trabalho e configuração.
Próximos Passos
- Guia de Configuração - Instruções detalhadas de configuração
- Pareamento - Configurar controle de acesso
- Canais - Configurar integrações de mensagens
Vitrine da Comunidade
Projetos reais construídos pela comunidade Clawdbot, desde fluxos de automação até controle de hardware.
Ferramentas do Clawdbot
O Clawdbot expõe ferramentas de agente poderosas para automação de navegador, canvas, nós, tarefas agendadas e mais. Aprenda a configurar e usar as ferramentas do Clawdbot.