OpenClaw con Ollama

Ollama es la vía más sencilla que ofrece la documentación hacia un modelo local, y su página empieza con una advertencia en lugar de una bienvenida: OpenClaw habla con la API nativa de Ollama, y apuntarlo a la URL compatible con OpenAI rompe las llamadas a herramientas. Se admiten tres modos: nube más local a través de un host con la sesión iniciada, solo nube contra el propio servicio de Ollama, y solo local. Aquí tienes lo que descubre el onboarding y lo que se niega a suponer, las reglas de autenticación según el tipo de host, la lista de resolución de problemas y la regla sobre los modelos pequeños que no desaparece porque el modelo sea gratuito.

No uses la URL /v1 compatible con OpenAI (http://host:11434/v1). Rompe las llamadas a herramientas y los modelos pueden emitir el JSON en bruto de las llamadas a herramientas como texto plano.

Configuración

• Onboarding: selecciona Ollama y elige un modo. En una configuración guiada nueva, OpenClaw comprueba el host predeterminado o configurado, y el descubrimiento automático solo tiene en cuenta los modelos ya cargados en memoria, con compatibilidad con herramientas y al menos 16K de contexto confirmados; un modelo instalado pero inactivo no es candidato, la ruta necesita una completación real antes de guardarse, y el descubrimiento nunca descarga ni carga nada.
• Solo nube pide la clave de API y sugiere valores predeterminados alojados; nube más local y solo local piden una URL base e inspeccionan los modelos instalados, y si no se encuentra ningún modelo compatible con herramientas, la configuración puede pedir permiso para descargar uno recomendado. Un modelo anunciado como solo de embeddings no puede convertirse en el modelo de chat predeterminado.
• Manual: instala Ollama, descarga un modelo, inicia sesión en el mismo host para el acceso híbrido a la nube, define una credencial (cualquier valor para un host local o de LAN y la clave real para el servicio de Ollama) y después define la referencia del modelo como ollama, barra, el nombre del modelo.

Reglas de autenticación

Los hosts loopback, de red privada, .local y con un nombre de host simple no necesitan un bearer token real; OpenClaw usa un marcador local para ellos. Los hosts remotos públicos y el servicio de Ollama necesitan una credencial real, y la documentación prefiere el id de proveedor en la nube dedicado para el uso alojado directo, de modo que el enrutamiento en la nube se mantenga separado de un proveedor local. Una clave de entorno sin más se trata como la convención de la nube y no se envía a los hosts locales por defecto, y la autenticación bearer para los embeddings de memoria está limitada al host para el que se declaró.

Resolución de problemas

• Bucle de fallos en WSL2: el instalador oficial de Linux crea un servicio con restart always; en una configuración con CUDA puede cargar un modelo durante el arranque, fijar memoria del host, hacer que Windows termine la VM y reiniciarse sin fin. Desactiva el servicio, desactiva la recuperación automática de memoria en la configuración de WSL o ejecuta Ollama a mano con un keep-alive corto.
• No detectado: confirma que se está ejecutando y que está dentro del alcance de modelos del agente; el descubrimiento ambiental en localhost necesita la variable de la clave o un perfil de autenticación, y una lista manual de modelos no vacía omite por completo el descubrimiento.
• Sin modelos: descarga uno o defínelo explícitamente. Conexión rechazada: comprueba el proceso y reinicia. JSON de herramientas impreso como texto: la URL compatible con OpenAI, el error del principio de la página.

Modelos gratuitos para OpenClaw sitúa Ollama junto a LM Studio, llama.cpp y los demás backends, y instalar OpenClaw en Windows es donde empieza la configuración de WSL2.

La regla que sigue vigente

La FAQ de modelos lo dice de un tirón junto con el inicio rápido de Ollama: los modelos más pequeños y muy cuantizados son más vulnerables a la inyección de prompts; usa modelos grandes para cualquier bot con acceso a herramientas y, si aun así usas modelos pequeños, activa el entorno aislado y listas estrictas de herramientas permitidas. OpenClaw y la inyección de prompts explica el ataque, y el entorno aislado de OpenClaw explica la contención.

En Diali

En Diali no hay ningún Ollama que instalar: los modelos están en el catálogo gestionado y se pagan con los créditos incluidos. OpenClaw alojado en Diali es el asistente, y modelos y proveedores de OpenClaw enumera lo que cubre el catálogo.

• La API nativa, nunca la URL compatible con OpenAI.
• El descubrimiento solo ve los modelos cargados; la configuración no descarga nada sin preguntar.
• Los hosts locales necesitan un marcador; los remotos, una clave; los modelos pequeños, un entorno aislado.