Cómo empezar con OpenClaw y agentes locales en Ubuntu

Paso 1: Entiende qué aporta OpenClaw

Un modelo responde; un runtime conecta modelo, sesiones, herramientas y entorno. OpenClaw añade Gateway, interfaz y configuración persistente. Empieza con un agente y una carpeta de pruebas.

Agente local puede significar runtime local con modelo remoto. Una configuración totalmente local necesita inferencia y servicios locales. Empezaremos en Linux con navegador, sin canales externos.

Paso 2: Comprueba el runtime e instala

Comprueba node --version. La guía oficial consultada el 9 de octubre de 2026 pide Node.js 24.16+ o 26.1+ y recomienda Node 26. Revisa los requisitos cuando sigas el artículo.

Descarga, revisa y ejecuta el instalador. Actualmente inicia onboarding. Elige Custom setup para seleccionar proveedor local deliberadamente; vuelve después con openclaw configure. Consulta la guía inicial oficial.

Abre el ejemplo completo para copiar — example-01.txt

# Open full code above.

Paso 3: Conecta el proveedor local Ollama

Comprueba una respuesta directa de Ollama con la guía anterior. En OpenClaw selecciona Ollama y Local only. En la misma máquina usa http://127.0.0.1:11434 sin /v1: la integración utiliza el API nativo.

Selecciona un modelo descargado que figure con las capacidades necesarias. Una respuesta de un modelo 3B no demuestra capacidad para herramientas. Prueba conversación breve y después una herramienta inocua. JSON de herramientas impreso como texto no significa ejecución.

Consulta proveedor Ollama y configuración. Mantén Gateway y servidor en loopback. Local only no debe cambiar silenciosamente a nube.

Paso 4: Ejecuta Gateway y abre el panel

Si onboarding dejó Gateway en primer plano, páralo con Ctrl+C antes de instalar el servicio. Ejecuta los comandos y abre el panel. El puerto habitual es 18789, pero comprueba tu configuración.

Envía una pregunta sencilla. Revisa agente, modelo, respuesta y herramientas. Un servicio activo prueba disponibilidad; una respuesta real prueba esa ruta para esa solicitud.

Abre el ejemplo completo para copiar — example-02.txt

openclaw gateway install
openclaw gateway status
openclaw dashboard

Paso 5: Dale un espacio claro a un agente

Ejecuta openclaw agents add lab-helper para el asistente de alta y lista los agentes. Asigna carpeta propia y revisa archivos generados. AGENTS.md puede recoger reglas y SOUL.md tono y función.

Primer encargo: resumir solo las notas de esa carpeta, sin enviar mensajes, instalar ni modificar archivos, citando la fuente. Configura herramientas y sandbox de solo lectura; el texto no es un límite de acceso.

Guarda resultados en el espacio y secretos en el almacén compatible. Separa sesiones y configuración por agente. Consulta CLI de agentes y rutas multiagente.

Abre el ejemplo completo para copiar — example-03.txt

# Open full code above.

Paso 6: Verifica una tarea antes de ampliar autonomía

Pon una nota pública de prueba y pide resumen con nombre de archivo. Verifica la lectura real y compara el contenido. Pregunta luego por un dato ausente y comprueba que una escritura esté bloqueada por tu política.

Después añade una acción acotada, como crear un borrador en scratch, con salida esperada, duración máxima y revisión. Contexto persistente, búsqueda de memoria y entrenamiento son mecanismos distintos; verifica recuperación antes de afirmar que recuerda.

Diagnostica desde gateway status y comandos actuales. Fallo de proveedor, denegación de herramienta y ruta de canal ausente son problemas diferentes. No abras Gateway sin autenticación para arreglar acceso local.

Compara la frase japonesa. LangGraph añade rutas, reintentos y aprobaciones explícitas.

Continúa la serie

• Alternativa DIY a Violoop: automatización con GL-RM10 y Codex
• Ollama en Ubuntu: modelo pequeño y conocimiento de contexto
• Primeros pasos con Codex en Ubuntu para trabajo Linux y automatización
• LangGraph para flujos prácticos: estado, aprobación y recuperación