Configuración de Clawdbot en Linux

Ejecuta el asistente de IA Clawdbot en servidores Linux con soporte completo de Gateway, gestión de servicios systemd y despliegue en VPS.

Descripción General de Clawdbot en Linux

El Gateway de Clawdbot tiene soporte completo en Linux. Node es el entorno de ejecución recomendado. Bun no se recomienda para el Gateway debido a errores con WhatsApp/Telegram.

Las aplicaciones complementarias nativas para Linux están planificadas. Las contribuciones son bienvenidas.

Ruta Rápida para Principiantes (VPS)

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

Desde tu portátil:

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

Abre http://127.0.0.1:18789/ y pega tu token.

Instalación

Consulta las guías principales de instalación:

Flujos opcionales:

Instalación del Servicio Gateway (CLI)

Usa uno de estos métodos:

# Opción 1: Durante la incorporación
clawdbot onboard --install-daemon

# Opción 2: Instalación directa
clawdbot gateway install

# Opción 3: Configuración interactiva
clawdbot configure
# Selecciona "Gateway service" cuando se te solicite

Reparar/migrar:

clawdbot doctor

Control del Sistema (unidad de usuario systemd)

Clawdbot instala un servicio de usuario systemd por defecto. Usa un servicio de sistema para servidores compartidos o siempre activos.

Configuración Mínima

Crea ~/.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

Habilítalo:

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

Gestión del Servicio

# Verificar estado
systemctl --user status clawdbot-gateway

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

# Reiniciar
systemctl --user restart clawdbot-gateway

# Detener
systemctl --user stop clawdbot-gateway

Habilitar Lingering

Para mantener el servicio ejecutándose después de cerrar sesión:

sudo loginctl enable-linger $USER

Despliegue en VPS

Para despliegue en VPS, consulta las guías detalladas:

  • Túnel SSH para acceso remoto
  • Tailscale para redes seguras
  • Docker para despliegue en contenedores

Configuración Básica de VPS

  1. Instala Clawdbot en tu VPS
  2. Configura el Gateway
  3. Configura túnel SSH o Tailscale
  4. Accede a la UI de Control remotamente

Verificaciones de Salud

clawdbot status
clawdbot health
clawdbot doctor

Próximos Pasos