Ayuda

Preguntas Frecuentes

Respuestas rápidas más solución de problemas profunda para configuraciones del mundo real (desarrollo local, VPS, multi-agente, OAuth/claves API, conmutación por error de modelos). Para diagnósticos en tiempo de ejecución, consulta Solución de Problemas. Para la referencia completa de configuración, consulta Configuración.

Tabla de contenidos

Primeros 60 segundos si algo está roto

  1. Estado rápido (primera verificación)

    Copiar

    openclaw status

    Resumen local rápido: SO + actualización, accesibilidad del gateway/servicio, agentes/sesiones, configuración del proveedor + problemas de tiempo de ejecución (cuando el gateway es accesible).

  2. Informe para pegar (seguro para compartir)

    Copiar

    openclaw status --all

    Diagnóstico de solo lectura con cola de registros (tokens redactados).

  3. Estado del daemon + puerto

    Copiar

    openclaw gateway status

    Muestra el tiempo de ejecución del supervisor vs la accesibilidad RPC, la URL objetivo de la sonda y qué configuración probablemente usó el servicio.

  4. Sondas profundas

    Copiar

    openclaw status --deep

    Ejecuta comprobaciones de salud del gateway + sondas de proveedores (requiere un gateway accesible). Ver Salud.

  5. Seguir el último registro

    Copiar

    openclaw logs --follow

    Si RPC está caído, recurre a:

    Copiar

    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

    Los registros de archivos están separados de los registros del servicio; ver Registro y Solución de Problemas.

  6. Ejecutar el doctor (reparaciones)

    Copiar

    openclaw doctor

    Repara/migra configuración/estado + ejecuta comprobaciones de salud. Ver Doctor.

  7. Instantánea del Gateway

    Copiar

    openclaw health --json
openclaw health --verbose   # muestra la URL objetivo + ruta de configuración en errores

    Pide al gateway en ejecución una instantánea completa (solo WS). Ver Salud.

Inicio rápido y configuración inicial

Estoy atascado, ¿cuál es la forma más rápida de desatascarme

Usa un agente de IA local que pueda ver tu máquina. Eso es mucho más efectivo que preguntar en Discord, porque la mayoría de los casos de "Estoy atascado" son problemas de configuración o entorno local que los ayudantes remotos no pueden inspeccionar.

Estas herramientas pueden leer el repositorio, ejecutar comandos, inspeccionar registros y ayudar a arreglar la configuración a nivel de máquina (PATH, servicios, permisos, archivos de autenticación). Dale la copia completa del código fuente a través de la instalación hackeable (git):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Esto instala OpenClaw desde una copia de git, para que el agente pueda leer el código + la documentación y razonar sobre la versión exacta que estás ejecutando. Siempre puedes volver a la versión estable más tarde volviendo a ejecutar el instalador sin --install-method git. Consejo: pídele al agente que planifique y supervise la reparación (paso a paso), luego ejecuta solo los comandos necesarios. Eso mantiene los cambios pequeños y más fáciles de auditar. Si descubres un error real o una solución, por favor abre un issue en GitHub o envía un PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls Comienza con estos comandos (comparte las salidas cuando pidas ayuda):

openclaw status
openclaw models status
openclaw doctor

Qué hacen:

  • openclaw status: instantánea rápida de la salud del gateway/agente + configuración básica.
  • openclaw models status: verifica la autenticación del proveedor + disponibilidad de modelos.
  • openclaw doctor: valida y repara problemas comunes de configuración/estado.

Otras comprobaciones útiles de la CLI: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose. Bucle de depuración