Execute o assistente de IA Clawdbot em servidores Linux com suporte completo ao Gateway, gerenciamento de serviço systemd e implantação em VPS.

Visão Geral do Clawdbot no Linux

O Gateway do Clawdbot tem suporte completo no Linux. Node é o ambiente de execução recomendado. Bun não é recomendado para o Gateway devido a bugs com WhatsApp/Telegram.

Aplicativos complementares nativos para Linux estão planejados. Contribuições são bem-vindas.

Caminho Rápido para Iniciantes (VPS)

# Instalar Node 22+
npm i -g clawdbot@latest
clawdbot onboard --install-daemon

Do seu laptop:

ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

Abra http://127.0.0.1:18789/ e cole seu token.

Instalação

Veja os guias principais de instalação:

Fluxos opcionais:

Docker
Nix

Instalação do Serviço Gateway (CLI)

Use um destes métodos:

# Opção 1: Durante a integração
clawdbot onboard --install-daemon

# Opção 2: Instalação direta
clawdbot gateway install

# Opção 3: Configuração interativa
clawdbot configure
# Selecione "Gateway service" quando solicitado

Reparar/migrar:

clawdbot doctor

Controle do Sistema (unidade de usuário systemd)

O Clawdbot instala um serviço de usuário systemd por padrão. Use um serviço do sistema para servidores compartilhados ou sempre ativos.

Configuração Mínima

Crie ~/.config/systemd/user/clawdbot-gateway.service:

[Unit]
Description=Clawdbot Gateway
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/clawdbot gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Habilite-o:

systemctl --user enable --now clawdbot-gateway.service

Gerenciamento do Serviço

# Verificar status
systemctl --user status clawdbot-gateway

# Ver logs
journalctl --user -u clawdbot-gateway -f

# Reiniciar
systemctl --user restart clawdbot-gateway

# Parar
systemctl --user stop clawdbot-gateway

Habilitar Lingering

Para manter o serviço em execução após o logout:

sudo loginctl enable-linger $USER

Implantação em VPS

Para implantação em VPS, veja os guias detalhados:

Túnel SSH para acesso remoto
Tailscale para rede segura
Docker para implantação em contêineres

Configuração Básica do VPS

Instale o Clawdbot no seu VPS
Configure o Gateway
Configure túnel SSH ou Tailscale
Acesse a UI de Controle remotamente

Verificações de Saúde

clawdbot status
clawdbot health
clawdbot doctor

Próximos Passos

Clawdbot macOS - Configuração macOS
Clawdbot Windows - Configuração Windows WSL2
Clawdbot Gateway - Configuração do Gateway

Configuração do Clawdbot no Linux