Cómo Instalar ZeroClaw: Guía Rápida Amigable para Principiantes de una Alternativa Ligera a OpenClaw

Por qué ZeroClaw vale la pena instalar

Si alguna vez has instalado una herramienta de IA, visto el binario llegar a tu “PATH”, y aún así no tenías prueba de que pudiera acceder a un modelo, entender su espacio de trabajo o responder de forma segura, ya entiendes el problema que esta guía está resolviendo. Una instalación completada solo prueba que los archivos fueron copiados. No prueba que el runtime del agente sea utilizable.

Aquí es donde ZeroClaw se vuelve interesante. Es un runtime de agente de IA ligero construido alrededor de un único binario Rust, con soporte para proveedores de modelos alojados en lugar de una pila local pesada desde el primer día. En la práctica, eso significa que está más cerca de “un runtime controlado de uso de herramientas” que de “un chatbot en una terminal.” Para lectores curiosos sobre el ángulo de “alternativa OpenClaw”, el atractivo práctico no es hype ni benchmarks. Es la historia de instalación más ligera, el menor peso de dependencias, y el hecho de que probarlo en un VPS Ubuntu se siente manejable en lugar de convertirse en un proyecto de infraestructura completo.

Este artículo se mantiene estrictamente enfocado en un resultado: instalar ZeroClaw, ejecutar “zeroclaw onboard”, verificar una primera sesión CLI segura, e irte con una idea realista de qué intentar después. Ese es el hito correcto para un tutorial VPS amigable para principiantes, porque “funcionando” debería significar una primera respuesta fundamentada que puedas verificar, no un largo tour de características.

📝 Nota: Esta guía prueba el primer uso CLI funcionando. No es una guía de implementación en producción, y no intenta cubrir Docker, gateways públicos, o servicios en segundo plano

Qué es ZeroClaw — en inglés simple

ZeroClaw se entiende mejor como un agente runtime que como “un chatbot de IA”. El modelo es solo una parte del sistema. ZeroClaw es la capa que conecta una cuenta de proveedor, una opción de modelo, un perfil de agente y un espacio de trabajo acotado para que la herramienta pueda hacer más que responder un prompt aislado.

Los cuatro términos a continuación son los que más importan en este tutorial:

La idea del espacio de trabajo importa más de lo que parece. En este artículo, el espacio de trabajo es la sala en la que el agente puede trabajar. Por eso instalar ZeroClaw no es lo mismo que configurar ZeroClaw: el binario puede existir en el disco mientras que el proveedor, modelo, alias y espacio de trabajo aún faltan o están mal conectados.

📝 Nota: Una instalación exitosa es solo la mitad de la historia. El hito significativo es una configuración funcional bajo ~/.zeroclaw que pueda alcanzar un proveedor y operar dentro de un espacio de trabajo visible.

Esta es también la forma más limpia de explicar por qué algunas personas ven ZeroClaw como una alternativa a OpenClaw sin forzar una comparación completa. El valor no es “OpenClaw reescrito en Rust”, y esta guía no lo trata de esa manera. El valor es una postura de auto-alojamiento más ligera, flexibilidad de proveedor y un runtime de binario único que es fácil de probar en un VPS.

Los primeros casos de uso buenos son igualmente fundamentados: resumir una copia de repositorio segura, explicar un archivo de configuración, manejar una tarea auxiliar de solo lectura dentro de un espacio de trabajo de bajo riesgo, o usarlo como un asistente acotado para operadores que desean visibilidad antes de permitir cambios reales.

Antes de instalar: línea base de Ubuntu, requisitos previos y seguridad

Antes de ejecutar el instalador, dedica un minuto a confirmar que el VPS es realmente una buena opción para el camino que usa este artículo. Los requisitos mínimos son directos: acceso SSH a un VPS Ubuntu, curl, una cuenta de proveedor alojado con una clave API, y una máquina o espacio de trabajo de bajo riesgo para la primera sesión.

Ejecuta primero las siguientes comprobaciones. En la ejecución de validación que se muestra en las capturas de pantalla, devolvieron Ubuntu 24.04.4 LTS (Noble Numbat), x86_64, y /usr/bin/curl. Eso es suficiente para confirmar la línea base de la guía sin pretender que cada servidor devolverá una salida idéntica.

cat /etc/os-release

uname -m
command -v curl

Para el ejemplo del proveedor alojado, OpenRouter es la opción predeterminada más limpia porque mantiene el VPS amigable para la guía y evita la configuración de modelos locales en el servidor. Si ya usas otro proveedor compatible, está bien, pero ten la clave API lista antes de que zeroclaw onboard comience a hacer preguntas. El objetivo aquí es el primer éxito, no la búsqueda de proveedores, así que un camino alojado limpio es mejor que intentar evaluar cada proveedor en la misma sesión.

ZeroClaw admite rutas de instalación precompiladas y de origen. Piensa en la ruta precompilada como un electrodoméstico listo para usar y en la ruta de origen como un kit de construcción propia. Ambas son legítimas, pero sirven a diferentes lectores. Para este inicio rápido, lo importante es entender la diferencia ahora y hacer la recomendación real en el paso de instalación.

⚠️ Advertencia: Usa esta lista de verificación de primera ejecución antes de continuar:

• mantente en un espacio de trabajo de bajo riesgo
• mantén el comportamiento supervisado predeterminado
• evita la exposición pública y los datos de producción
• haz que la primera tarea sea de solo lectura a propósito

Instalar ZeroClaw con el script oficial

Con la verificación previa completada, usa el instalador oficial como la ruta principal. Esta es la ruta más corta soportada para un inicio rápido de Ubuntu VPS:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

En esta ruta de instalación, el script se ejecuta de forma no interactiva y toma automáticamente la ruta de lanzamiento precompilada. En la ejecución de validación para esta guía, detectó el objetivo Linux, descargó el tarball de lanzamiento de GitHub correspondiente, verificó la suma de comprobación, instaló los activos del panel web en ~/.local/share/zeroclaw/web/dist, y colocó el binario zeroclaw en ~/.cargo/bin. Debido a que las capturas de pantalla se tomaron desde la cuenta raíz, las rutas concretas mostradas son /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw, y /root/.bashrc; en una cuenta de usuario normal, espera el mismo diseño en tu propio directorio de inicio.

Esa ruta rápida no es un atajo ni una instalación menos oficial. Es la ruta de inicio rápido normal para la audiencia para la que se escribió esta guía: descargar el lanzamiento correspondiente, verificarlo, y colocar el binario en ~/.cargo/bin/zeroclaw. Si intencionalmente deseas una compilación desde el código fuente, usa la ruta de clonación del repositorio a continuación en lugar de esperar que este flujo del instalador se detenga y ofrezca una opción de compilación separada.

💡 Consejo: En Linux, el problema más común después de la instalación es PATH, no la instalación en sí. Sigue la sugerencia del instalador para agregar export PATH=”$HOME/.cargo/bin:$PATH” a tu perfil de shell y recárgalo con source ~/.bashrc (o reabre el shell). Si solo necesitas una solución temporal para la sesión actual, usa la exportación de una línea que se muestra a continuación.

Después de que el binario esté en su lugar, el script termina con un mensaje de confirmación no interactivo en lugar de lanzar la configuración automáticamente. En la ejecución de validación para esta guía, ese mensaje de cierre apuntaba a zeroclaw quickstart, pero el binario instalado “v0.7.5” expuso onboard como el subcomando de configuración real en zeroclaw –help. También señala que zeroclaw daemon es la ruta para el daemon siempre activo más panel web mientras que zeroclaw agent es la ruta de chat CLI de una sola vez.

Para este artículo, continúa con zeroclaw onboard a continuación. Eso mantiene el tutorial alineado con la promesa real del artículo: primera sesión de agente funcional en la terminal, no emparejamiento de panel o tiempo de ejecución siempre activo.

Si eres consciente de la seguridad y prefieres inspeccionar el instalador antes de ejecutarlo, usa este enfoque alternativo:

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

Antes de que pienses en proveedores o indicaciones, verifica que el binario sea invocable en el shell:

zeroclaw --version

Si eso funciona, la instalación en sí tuvo éxito. Si el shell dice command not found, aplica la solución temporal de PATH a continuación y prueba de nuevo:

export PATH="$HOME/.cargo/bin:$PATH"

Separar este paso de la configuración es importante. Un zeroclaw –version funcional te dice que el problema del instalador se resolvió antes de que comiences a depurar la configuración del proveedor.

Ejecuta zeroclaw onboard y verifica qué creó

Este es el punto donde “instalado” necesita convertirse en “configurado”. En la ruta de instalación no interactiva utilizada anteriormente, el script omite explícitamente la solicitud de configuración. Si el mensaje del instalador menciona zeroclaw quickstart pero el binario no lo reconoce, confía en zeroclaw –help e inicia el asistente de primera ejecución con:

zeroclaw onboard

El asistente se abre en la pantalla del espacio de trabajo. En la ejecución capturada, la ruta del espacio de trabajo predeterminado era /root/.zeroclaw/workspace. A menos que tengas una razón sólida para moverlo, acepta el valor predeterminado. En una cuenta que no sea root, el mismo diseño vivirá en tu propio directorio de inicio.

Para este tutorial de CLI para principiantes, deja deshabilitados los perfiles de múltiples espacios de trabajo. Activarlos crea directorios separados de memoria, secretos y auditoría por compromiso, lo que puede ser útil más adelante, pero añade sobrecarga mental adicional para una primera prueba de humo.

En la pantalla del proveedor, elige OpenRouter. La lista es mucho más grande de lo que necesita una guía para principiantes, lo que es exactamente por qué ayuda elegir una ruta alojada limpia y mantenerla para la primera ejecución.

Pega tu clave API de OpenRouter cuando se te solicite. La entrada está oculta, y la solicitud nota explícitamente que ZeroClaw almacena el secreto a través del llavero del SO cuando es posible en lugar de pedirte que lo codifiques en config.toml.

La lista de modelos de OpenRouter es larga. En la ejecución capturada, se seleccionó deepseek/deepseek-v4-pro. Puedes elegir otro modelo actual de OpenRouter si lo prefieres, pero el resto de este tutorial sigue esa selección exacta.

Cuando el asistente pregunta sobre configuración avanzada, déjala desactivada para esta guía. Activarla es para anulaciones dirigidas como temperatura, tiempo de espera, URL base o protocolo de conexión.

En la pantalla de Canales, selecciona Listo sin añadir Discord, Telegram, Slack u otra superficie externa. Eso mantiene la primera validación solo en CLI. Puedes añadir canales más tarde una vez que funcione la ruta del agente local.

Para memoria, elige SQLite con Búsqueda Vectorial (recomendado). Es el valor predeterminado más fuerte aquí porque mantiene todo local mientras aún te proporciona soporte de búsqueda híbrida e incrustaciones.

Deja auto-guardar configurado en Sí para que tus propios mensajes se registren como historial de conversación. Si más adelante deseas un control manual más estricto, puedes desactivar esto y guardar memoria solo explícitamente.

Deja el control de hardware deshabilitado. Esta configuración de VPS no necesita GPIO, placas conectadas por USB o sondas de depuración.

Para el proveedor de túnel público, mantenlo en ninguno. Eso coincide con la postura de seguridad de este artículo: sin exposición pública durante la primera prueba de humo.

Cuando el paso de Personalidad dice que ya está configurado, deja ¿Reconfigurar? en No. La personalidad predeterminada es suficiente para la validación de primera ejecución.

Lo que importa aquí no es memorizar cada panel del asistente. Lo que importa es la ruta que las capturas de pantalla prueban: espacio de trabajo único, proveedor OpenRouter, entrada de clave API oculta, una selección de modelo concreta, sin anulaciones avanzadas, sin canales adicionales, memoria SQLite local, auto-guardar activado, hardware desactivado, sin túnel público y sin reescritura de personalidad. Eso es más que suficiente para producir una configuración CLI utilizable en ~/.zeroclaw.

Después de que se complete la incorporación, confirma que el directorio de configuración principal y el espacio de trabajo existen:

Si la ejecución de incorporación se completa limpiamente, deberías volver al shell con un mensaje de configuración cargada como el siguiente:

ls ~/.zeroclaw
ls ~/.zeroclaw/workspace

En la ejecución capturada, ~/.zeroclaw contenía config.toml y workspace/, y el espacio de trabajo en sí mostraba IDENTITY.md y SOUL.md.

Eso ya es suficiente para probar que ZeroClaw ahora tiene una sala de operaciones, no solo un binario instalado. Es también por qué la analogía del espacio de trabajo es útil: estás verificando que la sala existe, que el agente tiene contexto dentro de ella, y que la configuración fue más allá de “el instalador terminó”. Archivos como IDENTITY.md y SOUL.md no son decorativos. Son parte del contexto que ZeroClaw usa para entender cómo debe comportarse dentro de ese espacio de trabajo.

Antes del primer mensaje en vivo, ejecuta una verificación de salud compacta:

zeroclaw status

zeroclaw doctor

Para esta primera prueba de humo solo en CLI, no entres en pánico si zeroclaw doctor no está perfectamente limpio. En la ejecución capturada, las comprobaciones importantes pasaron: el archivo de configuración fue encontrado, el proveedor openrouter era válido, la clave API fue configurada, el modelo predeterminado fue establecido, y el espacio de trabajo existía y era escribible.

Las advertencias y errores restantes no son críticos para un chat de terminal: “no hay canales configurados” es esperado porque el tutorial intencionalmente omitió Discord, Telegram y otros canales externos; AGENTS.md no encontrado (opcional) es explícitamente no bloqueante; daemon_state.json no encontrado solo significa que el daemon siempre activo aún no se está ejecutando; y la queja de listado de modelos en vivo de OpenRouter es mejor leída como una limitación de sonda que como prueba de que la configuración del proveedor falló, especialmente porque la salida aún reporta openrouter: 344 modelos.

grep -E 'default_provider|default_model|[agents.|[risk_profiles.' ~/.zeroclaw/config.toml

La señal de éxito aquí es operacional, no cosmética. zeroclaw status es la fuente más clara de verdad para el resumen del tiempo de ejecución activo, zeroclaw doctor te dice si algo importante está roto, y la salida de grep es mejor tratada como un vistazo aproximado a las entradas de configuración relacionadas con proveedor/modelo en lugar de una validación perfecta de una línea. Espera que la redacción y las coincidencias exactas varíen según la versión. No estás buscando una pared perfecta de texto verde. Estás buscando la ausencia de bloqueadores de primera ejecución y la presencia de datos de configuración reales.

📝 Nota: config.toml puede no mostrar tu clave API en texto plano. Eso puede ser normal. En la ejecución de incorporación capturada, la solicitud de clave API explícitamente dijo que el secreto se almacenaría a través del llavero del SO cuando fuera posible, así que “sin clave visible en el archivo TOML” no es lo mismo que “la configuración falló”.

Inicia el primer chat CLI seguro

Con la configuración y el espacio de trabajo en su lugar, lanza el agente en modo interactivo:

zeroclaw agent

En la ejecución capturada, ZeroClaw cargó la configuración, inicializó la memoria respaldada por SQLite, imprimió el banner del modo interactivo y pasó al prompt >. El objetivo no es iniciar una demostración llamativa. El objetivo es demostrar conectividad de extremo a extremo, configuración válida y conciencia del espacio de trabajo fundamentada en un paso de bajo riesgo. Una prueba de solo lectura te proporciona una señal mucho más útil en esta etapa que un prompt “mira lo que puede hacer” con capacidad de escritura.

Para el primer prompt, usa esta verificación de solo lectura exacta:

tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything.

Debido a que el tiempo de ejecución está en modo supervisado, la primera respuesta útil puede requerir una aprobación de herramienta. En la ejecución capturada, ZeroClaw pidió ejecutar un comando shell de solo lectura: “pwd && echo “—-” && ls -la”

Ese es exactamente el tipo de comando que deseas para esta prueba de humo: imprime la ruta del espacio de trabajo y enumera el contenido de nivel superior sin cambiar nada. Apruébalo con Y para un sí único. También podrías denegarlo con N, pero entonces el agente perdería la forma más fácil de responder la pregunta desde el estado real del sistema de archivos en lugar de adivinar.

📝 Nota: También puedes ver una advertencia de seguimiento de costos para el modelo OpenRouter seleccionado antes del prompt de aprobación. En la ejecución capturada, ZeroClaw advirtió que no se definió una entrada de precios para openrouter/deepseek/deepseek-v4-pro. Eso no bloquea el chat en sí. Solo significa que el uso de tokens puede registrarse con costo cero hasta que definas explícitamente el precio del modelo.

Este prompt es fuerte porque prueba tres cosas a la vez. Primero, ZeroClaw tiene que llegar al proveedor y obtener una respuesta. Segundo, el agente tiene que entender el espacio de trabajo configurado. Tercero, la respuesta tiene que ser lo suficientemente específica para que puedas compararla con lo que realmente está en el disco. En otras palabras, esto demuestra que el agente se está manteniendo dentro de la sala que le fue asignada.

Una buena primera respuesta debe cumplir cuatro condiciones:

• sin errores de autenticación o proveedor
• sin “configuración no encontrada” o fallos de modelo faltante
• la ruta correcta del espacio de trabajo aparece en la respuesta
• se nombran archivos reales de nivel superior, sin afirmar que algo fue cambiado

Si deseas una forma diferente de invocar el agente, puedes enviar el mismo prompt como un comando único en lugar de permanecer en la sesión interactiva. Trata esto como opcional, no como el recorrido principal. La ruta interactiva sigue siendo la mejor experiencia inicial porque hace que el tiempo de ejecución se sienta observable en lugar de mágico.

zeroclaw agent -m "tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything."

Qué hacer a continuación una vez que ZeroClaw funciona

El siguiente movimiento correcto no es activar todas las funciones que encuentres. Es agregar una capa controlada a la vez, para que siempre sepas qué cambio introdujo nuevo riesgo o nueva fricción.

💡 Consejo: Una vez que el primer chat seguro funciona, mantén la misma disciplina para la siguiente fase. Muévete a una copia segura del repositorio o directorio de notas primero, mantén las tareas de solo lectura donde sea posible, y expande los privilegios solo después de que el flujo de trabajo base se sienta predecible.

Las buenas tareas de seguimiento son aburridas a propósito: resumir un README, explicar un archivo de configuración, o enumerar ideas de limpieza sin cambiar nada. Ese tipo de trabajo es de alta señal porque utiliza el mismo runtime que acabas de validar, pero no te obliga a acceso de escritura antes de confiar en la herramienta. Si quieres un mejor primer espacio de trabajo real, usa una copia segura del repositorio, un directorio de notas de staging, o una pequeña carpeta de documentos internos en lugar de cualquier cosa orientada a producción.

Los buenos pasos siguientes, en orden, se ven así:

• apunta ZeroClaw a una copia segura del repositorio o directorio de notas
• intenta una tarea auxiliar de solo lectura
• compara proveedores solo después de que el flujo de trabajo base se sienta estable
• mira servicios, canales, o Docker más tarde como proyectos separados

Si quieres comparar proveedores más tarde, hazlo después de que el flujo de trabajo base sea estable. Si quieres el siguiente paso de infraestructura después del éxito de CLI, estos son los comandos que vale la pena conocer:

zeroclaw service install
zeroclaw service start
zeroclaw service status

Este es el punto donde este artículo debería detenerse y el siguiente tema debería comenzar. La gestión de servicios, la implementación de Docker, las puertas de enlace públicas, los canales de mensajería, y el endurecimiento de seguridad más profundo merecen sus propios tutoriales.

Si esta primera prueba de humo fue útil, un VPS Ubuntu de AlexHost es un lugar natural para continuar experimentando con un runtime de agente ligero sin convertir el primer día en un proyecto de plataforma completa. La forma correcta de continuar es hacia afuera, no hacia los lados: utiliza la documentación oficial de configuración, servicio, proveedor y seguridad cuando estés listo para la siguiente capa.

Conclusión: de curioso a operacional

El resultado importante no es que ZeroClaw se haya instalado. El resultado importante es que respondió de forma segura desde una primera sesión verificada en el VPS. Eso significa que la línea base de Ubuntu pasó la verificación, el instalador se ejecutó, “zeroclaw onboard” se completó, la configuración y el espacio de trabajo se crearon, los controles de salud se veían correctos, y la primera respuesta de solo lectura volvió fundamentada en el contexto real del espacio de trabajo.

Ese es un punto de parada significativo. Mantén tus primeros experimentos pequeños, supervisados y observables, luego expande una capa a la vez hacia servicios, límites de seguridad más estrictos, o integraciones de canales cuando realmente los necesites. Para un inicio rápido de Ubuntu VPS, la confianza controlada es la victoria. No necesitas salir de este artículo con una pila de automatización completa. Necesitas salir sabiendo que el runtime funciona, el límite de seguridad está intacto, y el siguiente paso es tu elección en lugar de una suposición.