Ayuda

Resolución de Problemas

Si solo tienes 2 minutos, usa esta página como puerta de entrada de triaje.

Primeros 60 segundos

Ejecuta esta escalera exacta en orden:

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Buena salida en una línea:

  • openclaw status → muestra los canales configurados y sin errores de autenticación obvios.
  • openclaw status --all → el informe completo está presente y es compartible.
  • openclaw gateway probe → el objetivo de la puerta de enlace esperado es alcanzable.
  • openclaw gateway status → Runtime: running y RPC probe: ok.
  • openclaw doctor → sin errores de configuración/servicio bloqueantes.
  • openclaw channels status --probe → los canales reportan connected o ready.
  • openclaw logs --follow → actividad constante, sin errores fatales repetitivos.

Contexto largo de Anthropic 429

Si ves: HTTP 429: rate_limit_error: Extra usage is required for long context requests, ve a /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

La instalación del complemento falla con extensiones openclaw faltantes

Si la instalación falla con package.json missing openclaw.extensions, el paquete del complemento está usando un formato antiguo que OpenClaw ya no acepta. Solución en el paquete del complemento:

  1. Agrega openclaw.extensions a package.json.
  2. Apunta las entradas a los archivos de tiempo de ejecución compilados (generalmente ./dist/index.js).
  3. Vuelve a publicar el complemento y ejecuta openclaw plugins install <npm-spec> nuevamente.

Ejemplo:

{
  "name": "@openclaw/my-plugin",
  "version": "1.2.3",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

Referencia: /tools/plugin#distribution-npm

Árbol de decisión

AyudaPreguntas Frecuentes