Backends de CLI de OpenClaw

Cuando un proveedor de API está caído, limitado por frecuencia o funcionando mal, OpenClaw puede ejecutar una CLI de IA local como respaldo solo de texto. La documentación delimita con cuidado su alcance: las herramientas no se inyectan directamente, aunque un backend puede recibir herramientas del Gateway a través de un puente MCP en loopback, el streaming es JSONL donde la CLI lo admite, se admiten sesiones para que los mensajes de seguimiento sigan siendo coherentes, y las imágenes pasan cuando la CLI acepta rutas. Es una red de seguridad, no una ruta principal, y no es ACP. Aquí tienes el inicio rápido, el cableado del respaldo, la mecánica de un turno, las particularidades de la CLI de Claude, las sesiones, el puente MCP, la compactación y los límites.

Inicio rápido y respaldo

• El plugin de Anthropic incluido registra un backend de CLI de Claude que funciona sin más configuración que tener Claude Code instalado y con la sesión iniciada; una ejecución del agente de un solo mensaje con una referencia de modelo de la CLI de Claude lo demuestra, y el servicio del Gateway debe tener la CLI en su ruta de ejecutables, con un plugin de backend para un ejecutable no estándar.
• Para usarlo solo cuando fallen los modelos principales, añade un modelo de la CLI de Claude a la lista de respaldo; los respaldos configurados siguen siendo elegibles cuando el principal falla por autenticación, límites de frecuencia o tiempos de espera, aunque no estén en la política de modelos permitidos, que solo importa para la selección directa.
• Para enrutar un modelo canónico de Anthropic a través de la CLI, establece el id del motor del agente en ese modelo; las credenciales se quedan en los perfiles de autenticación o en la configuración del plugin, y el comando, los argumentos, el entorno, el análisis, las sesiones, las imágenes y la mecánica del watchdog son código del plugin.
• Un turno selecciona el backend por el prefijo del proveedor, construye el prompt del sistema a partir del mismo prompt de OpenClaw y del contexto del espacio de trabajo, ejecuta la CLI con un id de sesión cuando se admite, analiza JSON o texto, y persiste los ids de sesión por backend para que los mensajes de seguimiento reutilicen la sesión.

Úsalo como red de seguridad para respuestas de texto que “siempre funcionan”, no como ruta principal.

Particularidades de la CLI de Claude

El backend incluido se comunica con el ejecutable de Claude Code instalado mediante su protocolo stdio estructurado, mantiene un subproceso en caliente entre turnos compatibles, inicia uno nuevo cuando cambian el modelo, el prompt del sistema o la política de herramientas, y retoma el trabajo a partir de los ids de sesión almacenados después de un reinicio; Claude Code es dueño de su inicio de sesión y su suscripción, y OpenClaw nunca lee, persiste, renueva ni reenvía los tokens nativos. El contexto de los hooks de construcción del prompt llega a Claude como un adjunto de hook nativo, las notas de sesión guardadas se reproducen dentro de un presupuesto ponderado y acotado, el resolvedor de skills nativo se usa a través de un directorio de plugin temporal cuando una skill tiene una ruta materializada, y las instrucciones de Git de Claude Code se desactivan para que las ediciones del espacio de trabajo no invaliden su historial en caché. Claude Code se inicia en su modo de permisos predeterminado mientras las respuestas de permisos y el hook previo a las herramientas de OpenClaw mantienen las herramientas nativas bajo el control del host, proyectando los nombres de las herramientas nativas y los argumentos de archivo en sus equivalentes de OpenClaw antes de la política de exec y la aprobación; cuando el ajuste ask de exec pide confirmación, las solicitudes de herramientas nativas se retransmiten al canal de la sesión con permitir una vez, permitir siempre para la misma sesión en caliente y denegar, donde un tiempo de espera agotado, una ruta inalcanzable o un turno cerrado equivalen todos a denegar, y permitir siempre nunca se aplica a Bash. Los niveles de razonamiento se asignan a la opción de esfuerzo de Claude Code y, para los modelos de presupuesto fijo, a un valor máximo de tokens de razonamiento, y funcionan tanto el inicio de sesión nativo como un token de suscripción pegado.

Bash nativo, sesiones, el puente

• Con el ajuste ask en on-miss, los comandos Bash nativos se comprueban contra la lista de permitidos de exec del agente usando el propio evaluador de shell de OpenClaw: una llamada se ejecuta sin pedir confirmación solo cuando cada segmento se resuelve en un binario de la lista de permitidos y puede vincularse por completo, las tuberías, las sustituciones, los subshells y las redirecciones se deniegan antes de cualquier confirmación, y esto es una política a nivel de argumentos sobre el comando que ejecutará Claude Code, no una ejecución en un entorno aislado, ya que Claude Code es dueño del directorio de trabajo, la ruta, el entorno y el aislamiento.
• Las sesiones de CLI almacenadas son una continuidad propiedad del proveedor que se verifica contra una transcripción legible antes de retomarla; las sesiones nuevas pueden recuperar el historial de OpenClaw de la base de datos de sesiones cuando la frontera de cuenta coincide con la credencial seleccionada, y una huella privada de la cuenta con una cobertura contigua de la transcripción decide la elegibilidad, así que cambiar de cuenta hace que el historial mixto deje de ser elegible y un cambio en la identidad de autenticación descarta la reutilización de la sesión. Un intento fallido con la CLI de Claude puede pasar por conmutación por error a un modelo que no es de CLI, inicializado con un preámbulo extraído de la transcripción local de Claude Code: su último resumen de compactación más los turnos recientes.
• Un backend que opta por la capa bundle-MCP obtiene un servidor MCP HTTP en loopback que expone las herramientas del Gateway al proceso de la CLI con un token por ejecución, vinculado a la sesión, la cuenta y el canal seleccionados por el Gateway; las políticas de permitir y denegar también restringen los servidores MCP nativos, las ejecuciones restringidas como los trabajos de cron desactivan por completo las herramientas nativas y las personalizaciones de Claude y exponen solo las herramientas de OpenClaw permitidas, y los entornos de ejecución del puente con alcance de sesión se eliminan tras diez minutos de inactividad.

OpenClaw y Claude Code es el mismo emparejamiento visto desde el otro lado, y la conmutación por error de modelos en OpenClaw, el mecanismo que decide cuándo se ejecuta el respaldo.

Tiempos de espera, compactación, límites

Dos límites independientes: el presupuesto de turno del agente, cuarenta y ocho horas por defecto y cero para ilimitado, y el watchdog de ausencia de salida de la CLI, propiedad del backend, activo incluso cuando el presupuesto de turno es ilimitado; el trabajo en segundo plano iniciado dentro de una CLI muere con el subproceso cuando termina el turno, así que el trabajo largo y duradero corresponde a un subagente desacoplado. El backend de la CLI de Claude declara que es dueño de la compactación nativa, así que OpenClaw delega en Claude Code y reenvía el presupuesto de contexto a través de la ventana de autocompactación de Claude Code, mientras que un comando de compactación explícito retoma la sesión vinculada y envía el nativo; el backend de la CLI de Gemini también es dueño de su compactación, sin comando manual. Anthropic es dueño del backend de Claude y Google del de Gemini, cuyos requisitos previos son la CLI en la ruta de ejecutables y un perfil de clave de Google AI Studio; no hay un backend de CLI de Codex incluido, ya que Codex se ejecuta a través del arnés app-server. Las limitaciones: ninguna llamada a herramientas inyectada en el protocolo de la CLI sin el puente, un streaming que varía según el backend y unas salidas estructuradas que dependen del propio JSON de la CLI. Las aprobaciones de exec en OpenClaw cubre la lista de permitidos contra la que se comprueba el Bash nativo, y la guía de Gemini en OpenClaw, el proveedor detrás del segundo backend incluido.

En Diali

En Diali no hay ninguna CLI en el host a la que recurrir: la ruta del modelo es la clave de API guardada en el Vault o los créditos gestionados, y la conmutación por error ocurre entre proveedores y no hacia un binario local. OpenClaw alojado en Diali es el asistente y la guía de modelos y proveedores de OpenClaw cubre los proveedores que puede usar esa ruta.

• Un respaldo, no una ruta principal.
• Subproceso en caliente, inicio de sesión nativo, herramientas solo a través del puente.
• OpenClaw pone el Bash nativo bajo una lista de permitidos, nunca en un entorno aislado.