lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

flujo de trabajo principiante assistantsopenclawagentesherramientasdesarrollo

OpenClaw con Ollama: configura un proveedor de modelos locales

Conecta OpenClaw con un servidor Ollama y selecciona una ruta de inferencia local comprobable.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara runtime, CLI y modelo

Comprueba Node.js >=24.22.1 <25 || >=26.12.1 y npm. Es el intervalo del manifiesto de OpenClaw 2026.10.7, también publicado en npm; el README general menciona un mínimo menor. Para mantener coherencia, esta receta fija esa versión. Con npm ≥11.16 (también npm 12):

npm install -g openclaw@2026.10.7 --allow-scripts=openclaw

En npm ≤11.15 omite --allow-scripts=openclaw, como indica el README. Queda instalada la CLI openclaw.

Instala y arranca Ollama desde su descarga oficial. En el mismo equipo, la guía del proveedor propone:

ollama pull gemma4

El modelo debe soportar herramientas y al menos 16K de contexto. La descarga necesita memoria y disco suficientes para el modelo.

Paso 2: completa el asistente local

openclaw onboard

Elige Ollama y Local only, con la dirección nativa local http://localhost:11434, sin añadir /v1. El descubrimiento automático considera modelos ya cargados en memoria, con herramientas y contexto confirmados; no carga por sí solo cualquier modelo instalado en disco. Si no encuentra uno, el asistente puede pedir permiso para descargar el recomendado. Para un modelo instalado pero inactivo, la ruta explícita de Model Setup en escritorio es Choose connection → Local only. Completa la llamada real de prueba antes de guardar.

Comprobación

openclaw models list --provider ollama

Confirma el modelo y la dirección seleccionados. En la sesión del asistente pide listar los archivos de una carpeta de prueba y comprueba que se ejecuta una herramienta y que el resultado coincide con esa carpeta. Que aparezca el modelo en la lista no prueba uso de herramientas.

Si algo falla

Comprueba que Ollama sigue activo y que el modelo tiene las capacidades requeridas. /v1 es la ruta compatible con OpenAI, pero esta integración requiere la API nativa. Sigue la guía de descubrimiento antes de cambiar la dirección de la API.

ver en .md ¿Prefieres el recurso entero?

Qué es

El proveedor Ollama es un plugin incluido en OpenClaw con carpeta propia. Se ocupa del descubrimiento y configuración de modelos servidos por Ollama, con modos locales y opciones de nube diferenciadas.

Para qué te sirve

  • Cuando quieres probar herramientas de agentes con un modelo en tu equipo.
  • Cuando necesitas separar una ruta local de otra que use modelos alojados.

Cómo funciona

OpenClaw utiliza la API nativa de Ollama, no la ruta compatible con OpenAI. El asistente distingue Local only, Cloud + Local y Ollama Cloud. El descubrimiento y la selección dependen de los modelos y capacidades disponibles.

Antes de empezar

Necesitas OpenClaw y un servidor Ollama accesible con un modelo adecuado para herramientas. Revisa memoria y contexto del modelo y los requisitos de hardware. Las opciones de nube requieren revisar acceso y coste por separado.

Límites y alternativas

Elegir un servidor local no garantiza que todos los modelos servidos por él sean locales: comprueba el modo y la referencia elegida. Las herramientas del agente también pueden enviar datos a servicios externos. Esta ficha documenta el proveedor, no toda la pasarela.

Recursos