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 aterrizar en tu “PATH”, y aún así no tenías prueba de que pudiera alcanzar 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 terminada 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 IA ligero construido alrededor de un único binario Rust, con soporte para proveedores de modelos alojados en lugar de un stack local pesado 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 a OpenClaw”, el atractivo práctico no es hype ni benchmarks. Es la historia de instalación más ligera, 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 irse con una idea realista de qué intentar después. Ese es el hito correcto para un tutorial de 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 runtime de agente 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:

Esa idea de espacio de trabajo importa más de lo que suena. 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 disco mientras 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 funcionando 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 así. 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 buenos primeros casos de uso son igualmente fundamentados: resumir una copia de repo 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 quieren 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 un buen ajuste 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 mostrada 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 de proveedor alojado, OpenRouter es el default más limpio porque mantiene el VPS de la guía amigable 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 soporta rutas de instalación tanto precompiladas como de fuente. Piensa en la ruta precompilada como un electrodoméstico listo para usar y en la ruta de fuente 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 por defecto
• evita la exposición pública y los datos de producción
• haz que la primera tarea sea de solo lectura a propósito

Instala ZeroClaw con el script oficial

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

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 la ruta de versión precompilada automáticamente. En la ejecución de validación para esta guía, detectó el objetivo de Linux, descargó el tarball de versión de GitHub coincidente, verificó la suma de verificación, instaló los activos del panel web bajo ~/.local/share/zeroclaw/web/dist, y colocó el binario zeroclaw en ~/.cargo/bin. Debido a que las capturas de pantalla se capturaron 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 regular, espera el mismo diseño bajo 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: descarga la versión coincidente, verifica, y coloca el binario en ~/.cargo/bin/zeroclaw. Si intencionalmente quieres una compilación de fuente, usa la ruta de clonación de repo a continuación en lugar de esperar que este flujo de 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 correcció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 funcionando en la terminal, no emparejamiento de panel o runtime 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 pensar en proveedores o prompts, 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 corrección temporal de PATH a continuación y prueba de nuevo:

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

Separar este paso de la configuración importa. Un zeroclaw –version funcionando te dice que el problema del instalador está resuelto 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 explícitamente omite el prompt 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 fuerte para moverlo, acepta el predeterminado. En una cuenta que no sea raíz, el mismo diseño vivirá bajo tu propio directorio de inicio.

Para este tutorial de CLI para principiantes, deja deshabilitados los perfiles de espacio de trabajo múltiple. Activarlos crea memoria separada, secretos y directorios de auditoría por compromiso, lo que puede ser útil más tarde, pero agrega sobrecarga mental extra para una primera prueba de humo.

En la pantalla del proveedor, elige OpenRouter. La lista es mucho más grande de lo que una guía para principiantes necesita, que es exactamente por qué ayuda elegir un camino alojado limpio y adherirse a él para la primera ejecución.

Pega tu clave API de OpenRouter cuando se solicite. La entrada está oculta, y el prompt explícitamente nota 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 prefieres, pero el resto de este tutorial sigue esa selección exacta.

Cuando el asistente pregunta sobre configuración avanzada, déjalas desactivadas para esta guía. Activarlas es para anulaciones dirigidas como temperatura, tiempo de espera, URL base o protocolo de cable.

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

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

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

Deja el control de hardware deshabilitado. Esta configuración de VPS no necesita GPIO, placas tethered 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 el camino que las capturas de pantalla prueban: espacio de trabajo único, proveedor OpenRouter, entrada de clave API oculta, una opción de modelo concreto, sin anulaciones avanzadas, sin canales extra, memoria SQLite local, auto-save 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 bajo ~/.zeroclaw.

Después de que la incorporación termina, 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 como el que se muestra a continuación:

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

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

Eso ya es suficiente para probar que ZeroClaw ahora tiene una sala de operaciones, no solo un binario instalado. Eso también es 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 se movió 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 prompt 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 channels configured” es esperado porque el tutorial intencionalmente omitió Discord, Telegram y otros canales externos; AGENTS.md not found (optional) es explícitamente no bloqueante; daemon_state.json not found solo significa que el daemon siempre activo aún no se está ejecutando; y la queja de listado de modelos en vivo de OpenRouter se lee mejor 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 models.

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 runtime activo, zeroclaw doctor te dice si algo importante está roto, y la salida grep se trata mejor como un vistazo aproximado a las entradas de configuración relacionadas con proveedor/modelo que como 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, el prompt 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ó memoria respaldada por SQLite, imprimió el banner del modo interactivo, y cayó al prompt >. El objetivo no es iniciar una demostración llamativa. El objetivo es probar 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 da mucha más señal útil en esta etapa que un prompt capaz de escritura “mira lo que puede hacer”.

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

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 runtime 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 de shell de solo lectura: “pwd && echo “—-” && ls -la”

Ese es exactamente el tipo de comando que quieres 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 del sistema de archivos real 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 alcanzar el 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 disco. En otras palabras, esto prueba que el agente se está quedando dentro de la sala que le fue dada.

Una buena primera respuesta debe cumplir cuatro condiciones:

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

Si quieres una forma diferente de invocar el agente, puedes enviar el mismo prompt como un comando de una sola vez en lugar de quedarte en la sesión interactiva. Trata esto como opcional, no como el tutorial principal. La ruta interactiva sigue siendo la mejor experiencia de primera vez porque hace que el runtime 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 después de que ZeroClaw funcione

El movimiento correcto siguiente no es activar cada característica que puedas encontrar. 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 de repo segura o directorio de notas primero, mantén las tareas de solo lectura donde sea posible, y expande 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 usa 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 espacio de trabajo real de primera vez, usa una copia de repo segura, un directorio de notas de preparación, o una pequeña carpeta de documentos internos en lugar de cualquier cosa que enfrente la producción.

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

• apunta ZeroClaw a una copia de repo segura 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

Ese es el punto donde este artículo debería detenerse y el siguiente tema debería comenzar. Gestión de servicios, implementación de Docker, gateways públicos, canales de mensajería y 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 completo. La forma correcta de continuar es hacia afuera, no hacia los lados: usa la configuración oficial, servicio, proveedor y documentos de 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 se verificó, el instalador se ejecutó, “zeroclaw onboard” se completó, la configuración y el espacio de trabajo fueron creados, las comprobaciones de salud se veían sensatas, y la primera respuesta de solo lectura volvió fundamentada en contexto de espacio de trabajo real.

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 difíciles o integraciones de canales cuando realmente los necesites. Para un primer inicio rápido de VPS Ubuntu, la confianza controlada es la victoria. No necesitas dejar este artículo con una pila de automatización completa. Necesitas irte sabiendo que el runtime funciona, el límite de seguridad está intacto, y el siguiente paso es tu elección en lugar de una adivinanza.