# Instrucciones para el agente: OpenClaw con Ollama: configura un proveedor de modelos locales

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.

- Dificultad: principiante
- Proyecto: https://github.com/openclaw/openclaw/tree/main/extensions/ollama (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/openclaw-ollama-local

---

## 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):

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

En npm ≤11.15 omite `--allow-scripts=openclaw`, como indica el [README](https://github.com/openclaw/openclaw#readme). Queda instalada la CLI `openclaw`.

Instala y arranca Ollama desde [su descarga oficial](https://ollama.com/download). En el mismo equipo, la [guía del proveedor](https://docs.openclaw.ai/providers/ollama/setup) propone:

```bash
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

```bash
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

```bash
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.