OpenClaw & Moltbook FAQ

Después de la instalación, verifica esto: 1. Ejecuta `openclaw health` o `openclaw status` (CLI) o verifica el estado de salud en Desktop 2. Busca marcas verdes en todos los servicios 3. Verifica que el gateway sea accesible (predeterminado: http://127.0.0.1:18789) 4. Revisa los logs por mensajes de error Si todas las verificaciones pasan, estás listo para configurar canales.

Top 5 problemas de inicio: 1. Puerto ya en uso (otra app usando 18789) 2. Claves API faltantes o inválidas 3. Permisos insuficientes (intenta ejecutar como admin) 4. Firewall bloqueando conexiones 5. Dependencias desactualizadas (Node.js v22+ requerido) Revisa los logs primero - usualmente señalan el problema exacto.

Soluciones: 1. Encuentra y detén el proceso en conflicto: • Mac/Linux: `lsof -i :18789` luego `kill [PID]` • Windows (WSL): `lsof -i :18789` luego `kill [PID]` 2. O cambia el puerto de OpenClaw: • Usa `openclaw gateway --port 18790` al iniciar • O especifica `--gateway-port 18790` durante onboard

Prueba estos pasos en orden: 1. Revisa logs: `openclaw logs --follow` para ver mensajes de error 2. Reconfigura: ejecuta `openclaw configure` para restablecer 3. Reinstala: `npm install -g openclaw@latest` 4. Revisa las notas de versión por cambios importantes 5. Si sigue fallando, reporta con logs en GitHub Issues

OpenClaw usa principalmente `~/.openclaw/openclaw.json` para configuración. Problemas comunes: 1. Servicio no reiniciado después de cambios de config 2. Ruta de archivo de configuración incorrecta 3. Errores de sintaxis JSON (comas, comillas faltantes) 4. Variables de entorno deben pasarse vía parámetros de onboard Verifica config: ejecuta `openclaw status` para ver configuración activa.

Piensa en ello como un restaurante: • Modelo = El chef (IA que genera respuestas) • Canal = La entrada (WhatsApp, Telegram, etc.) • Gateway = El anfitrión (recibe y enruta solicitudes) • Skills = Habilidades especiales (búsqueda web, ejecución de código, etc.) Necesitas al menos un modelo y un canal. Gateway se ejecuta automáticamente. Skills son mejoras opcionales.

La forma más fácil es ejecutar el asistente de configuración interactivo: ``` $ openclaw onboard ``` El asistente te guiará a través de: • Seleccionar un proveedor de modelo IA (Anthropic/OpenAI etc.) • Ingresar tu clave API • Instalar e iniciar el servicio gateway Después de configurar, conecta un canal con `openclaw channels login telegram`. El gateway predeterminado se vincula a 127.0.0.1:18789 (solo acceso local - seguro).

En Desktop: Configuración → Skills → Alternar on/off En CLI: • Listar skills disponibles: `openclaw skills list` • Instalar un skill: `openclaw skills install [skill-name]` • Habilitar un skill: `openclaw skills enable [skill-name]` Consejos de seguridad: • Deshabilita skills que no necesitas • Revisa permisos del skill antes de habilitar • Prueba nuevos skills en un entorno seguro primero • Algunos skills pueden ejecutar código - habilita con precaución

Cambiar modelos: 1. Ejecuta `openclaw onboard` de nuevo para reconfigurar con nuevo proveedor 2. O edita la configuración agents.defaults.model en `~/.openclaw/openclaw.json` 3. Reinicia el servicio: `openclaw gateway status` para verificar Si el nuevo modelo falla: • Ejecuta `openclaw models status` para verificar conexión del modelo • Verifica validez de clave API en el sitio del proveedor • Verifica ortografía del nombre del modelo (ej. `anthropic/claude-opus-4-5`) • Verifica límites de tasa o cuota en tu cuenta

Lista de seguridad: ✓ Mantén gateway en localhost (127.0.0.1) por defecto ✓ Nunca expongas el puerto directamente a internet público ✓ Si necesitas acceso remoto, usa: • VPN o túnel SSH • Proxy reverso con autenticación • Cloudflare Tunnel ✓ Habilita autenticación si está disponible ✓ Usa HTTPS en producción

Prueba estas soluciones: 1. Asegúrate de que teléfono y computadora estén en la misma red 2. Actualiza el código QR (expiran rápidamente) 3. Actualiza WhatsApp a la última versión en el teléfono 4. Limpia caché del navegador si usas interfaz web 5. Intenta escanear en un ambiente bien iluminado 6. Desactiva VPN temporalmente Si sigue fallando, prueba el método de código de enlace del teléfono.

Los problemas de sesión usualmente son causados por: 1. Teléfono desconectado o en modo suspensión 2. WhatsApp cerró sesión en el teléfono 3. Usando WhatsApp Web en otro dispositivo 4. Inestabilidad de red Soluciones: • Mantén el teléfono conectado a WiFi estable • Desactiva optimización de batería para WhatsApp • No abras WhatsApp Web en otro lugar • Verifica actualizaciones de la app WhatsApp

El comportamiento en grupos usualmente es intencional: • Verifica si las respuestas en grupo están habilitadas en config • El bot puede requerir @mención para responder en grupos • La config predeterminada puede deshabilitar mensajes de grupo por seguridad Para habilitar: • Habilita respuestas de grupo en configuración de Desktop • O gestiona permisos de grupo vía `openclaw pairing` • Prueba con un grupo pequeño primero para asegurar que funciona

Los bots de Telegram tienen Modo Privacidad habilitado por defecto: 1. Abre @BotFather 2. Envía /mybots 3. Selecciona tu bot 4. Bot Settings → Group Privacy → Turn OFF Alternativamente, haz al bot administrador del grupo - los admins pueden ver todos los mensajes sin importar el modo privacidad.

Pasos simples: 1. Abre Telegram, busca @BotFather 2. Envía /newbot 3. Elige un nombre (nombre visible) 4. Elige un username (debe terminar en 'bot') 5. Copia el token API proporcionado 6. Añade el token a tu config de OpenClaw Opcional: Usa /setcommands para añadir sugerencias de comandos.

Usualmente es un problema de intents: 1. Ve a Discord Developer Portal 2. Selecciona tu aplicación → Bot 3. Habilita estos Privileged Intents: • MESSAGE CONTENT INTENT • SERVER MEMBERS INTENT (si es necesario) 4. Guarda y reinicia tu bot También verifica: el bot tiene permiso de Leer Mensajes en el canal.

Intents requeridos: • Guilds - info básica del servidor • Guild Messages - recibir mensajes • Message Content - leer texto de mensajes (PRIVILEGIADO) Opcional: • Guild Members - info de usuarios (PRIVILEGIADO) • Direct Messages - soporte de DM Nota: Intents privilegiados requieren verificación para bots en 100+ servidores.

Scopes mínimos de Bot Token: • chat:write - enviar mensajes • app_mentions:read - responder a @menciones • channels:history - leer mensajes del canal • im:history - leer mensajes DM Event Subscriptions: • message.channels • message.im • app_mention Empieza mínimo, añade más solo cuando sea necesario.

401 significa que la autenticación falló. Verifica: 1. La clave API es correcta (sin espacios extra) 2. La clave no ha expirado o sido revocada 3. La clave tiene permisos/scopes requeridos 4. No estás alcanzando límites de tasa 5. La cuenta tiene suficientes créditos/cuota Prueba tu clave directamente con la API del proveedor primero.

Diagnostica paso a paso: 1. Prueba el modelo directamente (curl/Postman) - si es lento, es el modelo 2. Verifica tu velocidad de internet y latencia 3. Prueba un modelo diferente (GPT-3.5 es más rápido que GPT-4) 4. Verifica la página de estado del proveedor por interrupciones Soluciones: • Aumenta configuración de timeout • Usa streaming para respuestas largas • Prueba un proveedor de modelo diferente

Busca estos patrones en logs: • 'FATAL' o 'PANIC' - errores críticos • 'OOM' - sin memoria • 'ECONNREFUSED' - no puede conectar a dependencia • Stack traces - errores de código Soluciones comunes: • Aumenta asignación de memoria • Corrige errores de configuración • Actualiza a la última versión • Verifica disponibilidad de servicios externos

Solución de problemas de config: 1. ¿Reiniciaste el gateway? (Requerido para la mayoría de cambios) 2. ¿La sintaxis JSON es correcta? (Verifica comas, comillas) 3. ¿Es el archivo de config correcto? (Debe ser `~/.openclaw/openclaw.json`) 4. ¿El gateway está ejecutándose? (`openclaw gateway status`) Verifica config: • `openclaw status` - verifica estado general • `openclaw models status` - verifica conexiones de modelo • `openclaw health` - verificación de salud

Ubicaciones de logs: • Desktop: Ver → Logs (o Configuración → Abrir Carpeta de Logs) • CLI: `~/.openclaw/logs/` o stdout • Docker: `docker logs [contenedor]` Palabras clave de error importantes: • ERROR, FATAL, PANIC - problemas críticos • timeout, ETIMEDOUT - problemas de conexión • 401, 403, 429 - problemas de auth/límite de tasa • ENOENT - archivo/ruta faltante

Incluye en tu reporte: 1. Versión de OpenClaw (`openclaw --version`) 2. Sistema operativo y versión 3. Pasos para reproducir 4. Comportamiento esperado vs actual 5. Logs relevantes (¡elimina info sensible!) 6. Fragmento de config (¡elimina claves API!) Envía a: página de GitHub Issues Para problemas de seguridad: envía email al contacto de seguridad directamente

Riesgos de exposición pública: • Cualquiera puede enviar solicitudes a tu IA • Las claves API podrían ser extraídas • Potencial de abuso (spam, contenido ilegal) • Explosión de costos por uso no autorizado • Responsabilidad legal por acciones del bot Opciones de acceso remoto seguro: • VPN (recomendado) • Túnel SSH • Cloudflare Tunnel • Proxy reverso con auth

Lista de seguridad: 1. ¿Es de fuente oficial/verificada? 2. Revisa el código fuente si está disponible 3. Lee reseñas/issues de otros usuarios 4. Entiende qué permisos solicita 5. Prueba en ambiente aislado primero Señales de alerta: • Solicita permisos innecesarios • Código ofuscado/minificado • Sin código fuente disponible • Sin feedback de la comunidad

Actúa inmediatamente: 1. REVOCA la clave en el sitio del proveedor AHORA 2. Genera una nueva clave 3. Actualiza todas tus configs con la nueva clave 4. Verifica historial de uso por llamadas no autorizadas 5. Revisa cómo se filtró (¿historial de git? ¿repo público?) Prevención: • Nunca hagas commit de claves a git • Usa archivos .env (en gitignore) • Usa gestión de secretos en producción

Valores seguros por defecto: • Gateway vinculado solo a localhost (127.0.0.1) • Skills deshabilitados por defecto • Mensajes de grupo deshabilitados inicialmente • Límite de tasa habilitado • Logging habilitado (para auditoría) • Permisos mínimos para bots de canal Recuerda: empieza restrictivo, afloja solo cuando sea necesario.