OpenClaw: instalación, modelos, seguridad y costos

OpenClaw es un asistente de IA autoalojado que conecta un modelo de lenguaje, herramientas e interfaces de conversación. Para utilizarlo, debe instalar su Gateway, configurar el acceso al modelo y conceder los permisos necesarios para sus tareas. El software no elimina los costos de los servicios externos ni la responsabilidad de controlar las acciones que se ejecutan.

Comprender los componentes antes de instalar

El Gateway es el componente central de la instalación. Recibe los mensajes y los conecta con las sesiones, los modelos y las funciones configuradas. El modelo genera las respuestas y elige acciones; las herramientas realizan las operaciones autorizadas.

Esta separación ayuda a diagnosticar los errores. Que el panel de control sea accesible no demuestra que el proveedor del modelo acepte sus credenciales. Una respuesta correcta en el navegador tampoco demuestra que la aplicación de mensajería autorice al remitente adecuado. Además, un modelo puede describir una operación sin disponer de la herramienta necesaria para ejecutarla.

OpenClaw pertenece a la familia de asistentes personales que presentamos en nuestro directorio de agentes de IA. Su utilidad depende, sobre todo, de si necesita conectar conversaciones con acciones. Si solo quiere redactar un texto de vez en cuando, mantener un servicio y administrar sus permisos puede suponer un trabajo innecesario.

Defina primero una tarea cuyo resultado pueda comprobar: resumir una carpeta con documentos ficticios, preparar un borrador o generar una lista de archivos. Deje fuera del primer ensayo los pagos, las eliminaciones y los envíos reales. Así podrá evaluar por separado la calidad de la respuesta y el funcionamiento de las conexiones.

Esta guía aborda el uso y el mantenimiento a largo plazo. El artículo Instalar OpenClaw paso a paso la complementa con un procedimiento centrado en la instalación según el sistema operativo.

Requisitos previos y elección del equipo

La documentación oficial de primeros pasos, consultada el 24 de octubre de 2026, indica Node.js 24.16 o posterior dentro de esa rama, o 26.1 o posterior, y recomienda Node.js 26. También exige un acceso compatible al modelo; el asistente de configuración puede detectar algunos accesos ya disponibles en el equipo.

Antes de empezar, prepare:

un equipo en el que pueda instalar software;
una cuenta del sistema dedicada si el agente va a trabajar de forma habitual;
una carpeta de trabajo que contenga únicamente los datos necesarios;
acceso al modelo y un medio para supervisar su consumo;
una copia de seguridad de los documentos que autorizará al agente a modificar.

Criterio	Computadora personal	Servidor dedicado
Disponibilidad	Depende de la suspensión y del apagado	Puede permanecer accesible de forma continua
Acceso a los documentos	Los documentos ya están disponibles, pero hay que limitar el acceso	Es necesario organizar la transferencia o sincronización
Mantenimiento	Se suma al mantenimiento del equipo	Hay que gestionar el sistema, el acceso remoto y las copias de seguridad
Aislamiento	Requiere limitar las carpetas accesibles	Resulta más fácil de organizar en un equipo separado

Un servidor no es automáticamente más seguro. Un servicio expuesto sin controles puede entrañar más riesgos que una instalación local con acceso limitado. Elija según la disponibilidad que necesite, su capacidad para administrar el sistema y los datos implicados. Si va a utilizar una API remota, no dimensione el equipo como si fuera a ejecutar un modelo local.

1. Instalar y abrir una primera conversación

Los siguientes comandos corresponden al procedimiento de inicio oficial citado anteriormente. En macOS o Linux, la instalación propuesta es:

curl -fsSL https://openclaw.ai/install.sh | bash

En Windows, el procedimiento documentado para PowerShell es:

iwr -useb https://openclaw.ai/install.ps1 | iex

Estos comandos descargan y ejecutan un script. Compruebe el dominio y revise el script si así lo exige su política informática. No conceda privilegios de administrador al agente solo porque una dependencia los haya necesitado durante la instalación.

El instalador inicia la configuración guiada. Empiece por la opción sencilla si los accesos detectados corresponden a la cuenta que desea utilizar; elija la configuración personalizada para revisar las opciones. Por ahora, deje las conexiones adicionales para más adelante.

Si el Gateway se está ejecutando en primer plano, deténgalo con el atajo indicado en la terminal antes de instalar su servicio:

openclaw gateway install

Después, compruebe el servicio y abra la interfaz:

openclaw gateway status
openclaw dashboard

Envíe una solicitud sin efectos externos, como reformular un texto. Si recibe una respuesta, habrá confirmado la primera conexión entre la interfaz y el modelo. Todavía no pruebe una aplicación de mensajería y una skill al mismo tiempo: si algo falla, no sabrá qué componente debe corregir.

Conserve la información útil de la instalación, pero elimine las claves, los tokens y los enlaces de acceso antes de compartir una captura de pantalla o un informe.

2. Configurar la carpeta, las instrucciones y los accesos

La referencia de configuración indica que el archivo habitual es ~/.openclaw/openclaw.json, en formato JSON5. El esquema es estricto: las claves desconocidas o los valores no válidos pueden impedir el inicio. Para empezar, dé preferencia al asistente o a los formularios de la interfaz frente a ejemplos copiados de conversaciones antiguas.

Para volver a los ajustes:

openclaw configure

La carpeta de trabajo debe tener un alcance definido. Evite dar acceso a todo su directorio personal para procesar unos pocos documentos. Coloque los archivos de prueba en un espacio separado y compruebe los permisos de la cuenta que ejecuta el servicio.

Sus instrucciones deben especificar el resultado esperado, las fuentes autorizadas, los archivos que se pueden modificar y las operaciones que requieren aprobación. Por ejemplo: preparar borradores, conservar los originales y pedir confirmación antes de transmitir información. Estas indicaciones orientan al modelo; las restricciones técnicas deben impedir las operaciones prohibidas.

Distinga también entre las instrucciones permanentes y los datos de cada tarea. Un documento recibido puede contener una frase imperativa sin que eso constituya una autorización. El agente debe tratar su contenido como una fuente que analizar, no como un cambio en las reglas que usted ha establecido.

Antes de cada cambio significativo, guarde una copia de la configuración y anote su objetivo. Modifique un conjunto coherente de ajustes, compruebe que el sistema inicia y repita su tarea de referencia. Esta disciplina facilita volver a un estado conocido.

3. Elegir el modelo y comprobar la autenticación

La elección combina un proveedor y un modelo, un acceso autorizado y unas capacidades adecuadas. La documentación de modelos distingue, entre otros elementos, el modelo principal, los modelos de respaldo y los perfiles de autenticación. También aclara que el mecanismo de ejecución y la forma de facturación son cuestiones distintas.

Empiece por revisar qué reconoce su instalación:

openclaw models status
openclaw models list

Utilice los identificadores que figuran en el catálogo y en la documentación del proveedor. Que un nombre comercial se parezca a otro no garantiza la compatibilidad ni los derechos de acceso.

Criterio	Modelo mediante API remota	Modelo ejecutado localmente
Gasto principal	Consumo y servicios asociados	Hardware, energía y administración
Circulación de los datos	El contenido se transmite al proveedor	Debe comprobarse en toda la cadena de herramientas
Capacidad disponible	Depende del catálogo y de las cuotas	Depende del hardware y del modelo
Diagnóstico	Credenciales, límites y disponibilidad	Carga, memoria y servidor de inferencia

Una plataforma como OpenRouter añade un intermediario que debe tener en cuenta al analizar el recorrido de los datos y los costos. Un software como Ollama cubre otra necesidad: servir modelos desde un equipo que usted administra. En ambos casos, compruebe el procedimiento de integración admitido oficialmente antes de configurar el endpoint.

Evalúe el modelo con sus propias tareas: respeto de los límites, elección de herramientas, gestión de errores y calidad del resultado. Una tarifa baja por respuesta no compensa los intentos repetidos ni las numerosas correcciones manuales. Revise también los modelos de respaldo: pueden cambiar tanto el proveedor que recibe los datos como el costo efectivo.

4. Añadir skills sin ampliar los permisos por defecto

Una skill describe cómo y cuándo utilizar determinadas capacidades. Según la documentación oficial de skills, consiste en una carpeta con un archivo SKILL.md que contiene metadatos YAML e instrucciones Markdown. Su carga puede depender de la configuración, del entorno y de los programas disponibles.

No confunda estos tres elementos:

la skill explica un método;
la herramienta realiza una operación;
los permisos determinan a qué puede acceder esa operación.

Por tanto, una skill puede aparecer como disponible sin que sea posible utilizarla, o proponer un procedimiento incompatible con sus restricciones. A la inversa, unas instrucciones breves pueden recurrir a un programa con capacidades muy amplias.

Empiece por las funciones que ya están disponibles. Si añade una skill externa, examine su procedencia, sus instrucciones, sus scripts y sus dependencias. Busque descargas de ejecutables, acceso a secretos, transmisiones por la red y cambios de permisos.

También importa su ámbito de aplicación. La documentación da prioridad a las skills de la carpeta de trabajo frente a otras fuentes, incluidas las skills integradas. Por ello, una copia local puede modificar el comportamiento esperado. Compruebe si hay nombres duplicados y lleve un registro de los cambios.

Pruebe cada incorporación con datos ficticios y dentro de un alcance limitado. Un análisis automatizado o una firma no demuestra que el procedimiento sea adecuado para su uso. Si quiere preparar una capacidad reutilizable, la guía de skills para agentes explica la separación entre instrucciones, recursos y verificación.

5. Conectar una aplicación de mensajería y controlar los remitentes

Una aplicación de mensajería añade una vía de acceso remoto a su agente. Conéctela solo después de haber comprobado el modelo y las herramientas desde la interfaz local. De lo contrario, un error del canal puede ocultar un fallo de autenticación o una configuración no válida.

La documentación de canales presenta Telegram como la opción inicial más sencilla, mediante un token de bot. WhatsApp utiliza una vinculación por QR y conserva más información de estado en el disco. Slack y Discord también figuran entre los canales documentados; sus permisos y comportamientos deben revisarse por separado.

Para Telegram, siga este orden:

Cree el bot según el procedimiento oficial del canal.
Guarde su token mediante el proceso de configuración previsto.
Compruebe qué identidad está autorizada para conversar con el agente.
Envíe una solicitud sin acciones externas en una conversación privada.
Después, pruebe las restricciones antes de añadir un grupo.

Nunca publique el token en una conversación de soporte. Si lo divulga, revóquelo en el servicio correspondiente.

En los grupos, distinga entre el permiso para ver un mensaje, el permiso para provocar una respuesta y la autorización para ejecutar una acción. Exigir una mención al bot puede reducir las interrupciones, pero no sustituye una lista de usuarios autorizados.

Por último, compruebe a qué destinatarios pueden dirigirse las herramientas de mensajería. Leer una conversación y enviar un mensaje son permisos distintos. Antes de utilizar el agente en un entorno profesional, verifique expresamente que un usuario no pueda hacer que se transmitan datos a otro espacio sin su consentimiento.

Seguridad: limitar las consecuencias de un error

La documentación de seguridad de OpenClaw describe un límite de confianza compartido por el Gateway. Para usuarios que no confían entre sí, recomienda instalaciones y credenciales separadas, preferiblemente con cuentas del sistema o equipos distintos. También advierte que los ajustes de red difieren entre las instalaciones convencionales y los contenedores.

Ejecute la auditoría documentada:

openclaw security audit

Lea los resultados y compruebe las consecuencias de las correcciones propuestas. Una auditoría de configuración no garantiza que una tarea de negocio sea razonable ni que un documento externo sea fiable.

El riesgo de inyección de prompts aparece cuando un contenido consultado intenta desviar el comportamiento del agente. Reduzca las posibles consecuencias: limite el acceso a las carpetas, utilice cuentas dedicadas, desactive las herramientas innecesarias y exija aprobación antes de enviar, eliminar o asumir un compromiso financiero.

Un entorno aislado solo protege aquello que realmente separa. Examine las carpetas montadas, la red, los secretos disponibles y los perfiles de navegador accesibles. Un navegador con sesiones abiertas puede dar acceso a servicios sensibles aunque no se haya proporcionado explícitamente una clave de API al agente.

Aplique el principio de mínimo privilegio a las herramientas y a las cuentas externas. Las instrucciones escritas deben complementar esas restricciones, no sustituirlas.

La guía para proteger un agente de IA ofrece un marco más amplio para gestionar secretos, aprobaciones y registros de actividad. Revise ese marco cada vez que añada un canal o una herramienta.

Costos: medir la tarea completa

Que el software no tenga una cuota de suscripción no significa que utilizarlo no genere gastos. El sitio oficial de OpenClaw, consultado el 24 de octubre de 2026, presenta el proyecto sin suscripción ni servicio alojado. Aun así, su instalación puede consumir API de pago y necesitar alojamiento.

Divida el presupuesto por conceptos: modelo principal, posibles modelos de respaldo, búsqueda o procesamiento de contenido multimedia, equipo, almacenamiento y tiempo de mantenimiento. Una llamada a una herramienta puede generar su propio cargo, al margen de los tokens del modelo.

Para estimar el consumo del modelo, sume las entradas y salidas de todas las llamadas. El historial, las instrucciones y los resultados de las herramientas pueden enviarse de nuevo a medida que avanza la tarea. Por eso, una respuesta final breve puede haber requerido mucho trabajo intermedio.

La calculadora de precios de LLM ayuda a elaborar una estimación; después, compárela con los registros de consumo del proveedor. Revise por separado las categorías con tarifas específicas, como la caché o el procesamiento de contenido multimedia, cuando correspondan.

Establezca un límite de gasto en el proveedor si ofrece esa opción. Una alerta avisa, pero no necesariamente detiene el consumo. Mida también el costo por tarea aceptada, incluidos los nuevos intentos y las correcciones humanas.

Para reducir la factura, empiece por limitar los documentos transmitidos, las herramientas disponibles y las tareas recurrentes innecesarias. Después, cambie de modelo y repita las mismas pruebas para comprobar que el ahorro no perjudique el resultado esperado.

Problemas frecuentes

El panel de control se abre, pero no llega ninguna respuesta. Compruebe el estado del modelo y sus credenciales. Distinga entre un acceso denegado, una cuota agotada y un modelo no disponible antes de modificar el Gateway.

El servicio no inicia después de un cambio. La validación estricta puede rechazar una clave antigua o un valor incorrecto. Consulte el diagnóstico:

openclaw doctor

Compare el error con su última modificación. Evite acumular más cambios antes de recuperar un estado funcional.

Una skill está presente, pero no funciona. Compruebe su ámbito de aplicación, sus dependencias y las restricciones del entorno. No intente resolver una dependencia ausente concediendo acceso a todo.

El bot no responde en la aplicación de mensajería. Confirme primero que la conversación local funciona. Después, revise la identidad del remitente, la vinculación, los permisos del canal y las reglas del grupo.

El consumo continúa fuera de los intercambios previstos. Busque tareas recurrentes y llamadas adicionales en los registros de consumo y de actividad disponibles. Suspenda las automatizaciones implicadas mientras realiza el diagnóstico.

Una conexión sensible parece comprometida. Desactive los accesos afectados, revoque las credenciales expuestas y conserve los registros útiles sin publicarlos. Restaurar un archivo de configuración no revoca un token robado.

Lista de comprobación antes del uso habitual

Una instalación lista para el uso habitual debe completar una tarea representativa y rechazar una solicitud que quede fuera de su alcance. Conserve estas pruebas para repetirlas después de una actualización o de un cambio de modelo.

Páginas relacionadas

Preguntas frecuentes

¿Hay que dejar la computadora encendida para usar OpenClaw?

El equipo que ejecuta el Gateway debe permanecer disponible para procesar los mensajes. Instalar un servicio permite trabajar sin mantener una terminal abierta, pero no mantiene operativo un equipo apagado o en suspensión. Si necesita disponibilidad continua, elija un equipo adecuado y prevea su mantenimiento.

¿Se puede usar OpenClaw sin conectar una aplicación de mensajería?

Sí, el panel de control permite empezar con una conversación en el navegador. Es una forma útil de comprobar por separado el modelo y las herramientas antes de añadir un canal externo.

¿OpenClaw funciona con una suscripción a un asistente de IA?

Depende del proveedor, del mecanismo de autenticación y del procedimiento admitido oficialmente. Una suscripción a una interfaz de chat no incluye automáticamente créditos de API. Compruebe qué cuenta se utiliza y cuáles son sus condiciones antes de poner en marcha tareas recurrentes.

¿Puede funcionar una skill sin instalar software adicional?

Algunas skills solo contienen instrucciones; otras requieren un programa instalado, una clave o un servicio accesible. Por tanto, tener el archivo no garantiza que funcionen. Debe comprobar sus dependencias y el entorno en el que se ejecutarán.

¿Se puede compartir una instalación entre varios clientes?

No considere que una instalación compartida ofrece una separación de seguridad entre clientes que no confían entre sí. La documentación recomienda separar los Gateway y las credenciales cuando los límites de confianza sean distintos. Esa separación también debe abarcar las cuentas del sistema y los datos accesibles.

OpenClaw, guía de referencia: instalación, configuración, modelos, skills, mensajería, seguridad y costos