Despliegue OpenClaw con un solo clic

Contenido actualizado: 2026-06-09

Despliega el gateway AI OpenClaw en Linux o macOS a través de un script de un solo clic, utilizando Crazyrouter como backend predeterminado. El instalador escribirá ~/.openclaw/openclaw.json listo para ejecutarse, registrará el servicio del sistema, y preconfigurará un conjunto de modelos adecuados para tareas de chat, codificación y contexto extenso.

Resumen

OpenClaw es ideal para convertir Crazyrouter en una entrada de IA local bajo tu control:

WebUI / gateway local, escuchando por defecto en 18789
Puede reutilizar directamente los modelos y cuotas de Crazyrouter
Soporta Telegram, y se habilitan plugins para DingTalk, WeCom, QQ Bot, Discord, Slack, Feishu, etc.
Ideal para robots personales permanentes, asistentes internos de equipo, servidores domésticos o escenarios ligeros de autohospedaje

¿Para quién es adecuado?

Quienes quieran conectar Crazyrouter al gateway AI local con un solo comando
Quienes quieran ejecutar su propio Telegram Bot en su servidor
Quienes buscan gestionar entradas de chat, WebUI e IM unificadas
Quienes deseen desplegar un asistente permanente en su máquina de desarrollo o un pequeño servidor doméstico

Acuerdo de uso

Acuerdo recomendado: OpenAI-compatible API

El instalador apunta por defecto el proveedor crazyrouter a https://api.crazyrouter.com/v1
También escribe los proveedores crazyrouter-claude, crazyrouter-minimax para facilitar el cambio a la ruta compatible con Anthropic Messages
OpenClaw expone un gateway local y WebUI; la autenticación depende del gateway.auth.token generado durante la instalación

Si necesitas ajustar manualmente la dirección del proveedor de OpenClaw, primero consulta la Descripción del Endpoint API, y confirma si tu cliente debe ingresar el dominio raíz o /v1.

Requisitos previos

Proyecto	Descripción
Cuenta Crazyrouter	Regístrate primero en crazyrouter.com
Crazyrouter API Key	Se recomienda crear un token especial para OpenClaw; no compartirlo con Cursor ni Claude Code
Sistema operativo	Linux o macOS, x64 / arm64 ambos compatibles
Red	El servidor necesita acceso a internet; si accedes desde otros dispositivos al WebUI, también libera el puerto `18789`
Node.js	El instalador intentará instalar Node.js 22+ automáticamente
Telegram Bot Token	Opcional, solo necesario si usas Telegram

El instalador de OpenClaw vincula el gateway por defecto a la dirección local de la red (bind: lan). Si tu máquina está expuesta directamente a internet, es imprescindible configurar el firewall y proteger cuidadosamente tu token de acceso al gateway.

Inicio rápido en 5 minutos

Crear token dedicado de Crazyrouter

Crea un token sk-... especializado para OpenClaw en el panel trasero de Crazyrouter. Se recomienda permitir solo los modelos que vas a usar en el gateway, como claude-opus-4-8, gpt-5.5, gemini-3.1-pro.

Ejecutar el script de instalación

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-openclaw/main/install.sh | bash

Si deseas omitir la selección de idioma y la entrada de API Key, también puedes hacerlo así:

CRAZYROUTER_API_KEY=sk-xxx INSTALLER_LANG=zh \
  curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-openclaw/main/install.sh | bash

Anotar los 3 valores que se muestran en la salida del instalador

Dirección WebUI: http://<SERVER_IP>:18789
Dirección de inicio de sesión automático: http://<SERVER_IP>:18789?token=<gateway_token>
Archivo de configuración: ~/.openclaw/openclaw.json

Abrir la WebUI para realizar la primera verificación

Accede con el navegador a la dirección de inicio de sesión automático y confirmá que puedes entrar a la consola de OpenClaw. Envía un mensaje de prueba usando el modelo predeterminado claude-opus-4-8, por ejemplo “Solo responde ok”.

Completá el emparejamiento con Telegram según sea necesario

El instalador preguntará si deseas configurar Telegram ahora mismo. Si eliges hacerlo, tras ingresar el Bot Token, envía cualquier mensaje a tu bot para completar el primer emparejamiento de owner.

Configuración recomendada de modelos

El modelo principal predeterminado del instalador es claude-opus-4-8. Si deseas cambiar el modelo por defecto diario, edita ~/.openclaw/openclaw.json y modifica agents.defaults.model.primary.

Escenario	Modelo recomendado	Razón
Chat cotidiano por defecto	`claude-opus-4-8`	Modelo principal por defecto, adecuado como modelo para chat y control principal de alta calidad
Codificación / Agent	`gpt-5.5`	Modelo principal compatible OpenAI más reciente, óptimo para codificación y base principal para Agent
Alternativo de alta relación costo-calidad	`claude-opus-4-8`	Equilibrio entre calidad, estabilidad y costes
Gemini de respaldo	`gemini-3.1-pro`	Adecuado como segunda vía de verificación de compatibilidad
Razonamiento profundo	`claude-opus-4-8`	Adecuado para escenarios que requieran cadenas de razonamiento más sólidas

Ejemplo: cambiar el modelo predeterminado a gpt-5.5

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter/gpt-5.5"
      }
    }
  }
}

Si prefieres usar explícitamente el proveedor compatible Claude, puedes escribir:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter-claude/claude-opus-4-8"
      }
    }
  }
}

Buenas prácticas para la configuración de token

Configuración	Recomendación	Descripción
Token exclusivo	Obligatorio	No compartas el token entre OpenClaw y otros IDE / CLI
Lista blanca de modelos	Recomendada	Mantén sólo los modelos que OpenClaw utilizará, minimiza usos erróneos
Restricción IP	Recomendada para servidores con IP fija	Si tu máquina tiene IP fija de salida, restringe el token a ese servidor
Límite de cuota	Recomendada	Configura presupuesto mensual o diario para escenarios de bot
Aislamiento de ambientes	Recomendada	Usa tokens separados para bots de producción y de pruebas
Gestión de filtraciones	Cambia inmediatamente	Si `openclaw.json`, logs o enlaces compartidos han expuesto el token, resetea tanto el token de Crazyrouter como el del gateway

En OpenClaw hay al menos dos tipos de credenciales: una es la API Key sk-... de Crazyrouter, que se usa para invocar modelos; la otra es el token de acceso local de OpenClaw, necesario para acceder al WebUI. No mezcles ambas.

Lista de verificación de éxito inicial

El navegador puede abrir http://<SERVER_IP>:18789?token=<gateway_token>
El WebUI de OpenClaw se abre correctamente, sin pedir login en bucle
El modelo predeterminado retorna el primer mensaje correctamente
Al modificar el modelo y reiniciar el servicio responde normalmente
journalctl --user -u openclaw -f o tail -f ~/.openclaw/openclaw.log muestran solicitudes exitosas
Si Telegram está habilitado, el bot responde al mensaje
Se ha guardado el backup ~/.openclaw/openclaw.json

Archivos clave y parámetros de configuración

Ubicación de archivos

Ruta	Uso
`~/.openclaw/openclaw.json`	Archivo de configuración principal
`~/.openclaw/start-gateway.sh`	Script de inicio, el servicio de sistema lo ejecuta
`~/.openclaw/crash-guard.cjs`	Parches de estabilidad escritos por el instalador
`~/.openclaw/credentials/.telegram-owner-paired`	Archivo marcador tras el primer emparejamiento de owner de Telegram
`~/.config/systemd/user/openclaw.service`	Servicio systemd a nivel de usuario en Linux
`~/Library/LaunchAgents/com.crazyrouter.openclaw.plist`	Servicio launchd en macOS
`~/.openclaw/openclaw.log`	Log habitual de macOS
`~/.openclaw/openclaw.err`	Log de errores de macOS

Parámetros de configuración más habituales

Ruta JSON	Función	Modificación común
`models.providers.crazyrouter.apiKey`	key compatible OpenAI de Crazyrouter	Cambiar API Key
`models.providers.crazyrouter.baseUrl`	Base compatible OpenAI	Normalmente se mantiene en `https://api.crazyrouter.com/v1`
`agents.defaults.model.primary`	Modelo principal por defecto	Cambiar a `gpt-5.5`, `claude-opus-4-8`, etc.
`gateway.port`	Puerto de WebUI / gateway	Cambiar al puerto propio
`gateway.auth.token`	Token de login de WebUI	Cambia inmediatamente si se filtra
`gateway.bind`	Rango de escucha	Por defecto es `lan`
`channels.telegram.botToken`	Token de Telegram Bot	Rellenar si usas Telegram
`plugins.entries.*.enabled`	Activación de plugins IM	Desactiva los innecesarios
`env.vars.OPENAI_API_KEY`	API Key para capacidades internas	Normalmente igual que el key principal

Integración IM

Este es el canal con mayor soporte por el instalador. Se recomienda empezar por Telegram:

Busca @BotFather en Telegram
Envía /newbot para crear el bot y obtener el Bot Token
El instalador solicitará Set up Telegram Bot now?, elige Y
Pega el Bot Token; el instalador lo escribirá en ~/.openclaw/openclaw.json
Tras reiniciar el gateway automáticamente, envía cualquier mensaje al bot
El primer usuario en enviar un mensaje será emparejado como owner
Si el emparejamiento automático falla, ejecuta:

openclaw pairing list
openclaw pairing approve <code>

Al configurar Telegram manualmente, consulta la estructura escrita por el instalador:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdef...",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "streaming": "off"
    }
  },
  "plugins": {
    "entries": {
      "telegram": { "enabled": true }
    }
  }
}

Otras plataformas IM

El instalador activa por defecto las siguientes entradas de plugin:

dingtalk
openclaw-wecom
qqbot
discord
slack
feishu

Pero normalmente tendrás que añadir el credential de la plataforma y la configuración correspondiente channels.<name>. La forma recomendada es:

Crea primero un bot o app en la plataforma correspondiente
Escribe el credential de la plataforma en ~/.openclaw/openclaw.json
Asegúrate de que plugins.entries.<name>.enabled corresponda con true
Reinicia el servicio OpenClaw
Verifica en logs si el canal se cargó correctamente

Plataforma	Estado del instalador	Qué debes hacer
Telegram	Configuración interactiva soportada	Rellenar Bot Token y emparejar owner
DingTalk	Plugin instalado y activado	Añadir credential del bot y configuración de canal
WeCom	Plugin instalado y activado	Añadir credential de la app empresarial y canal
QQ Bot	Plugin instalado y activado	Añadir credential del bot y canal
Discord / Slack / Feishu	Entrada de plugin habilitada	Añade credential de canal según los requisitos de cada bot

Si vas a integrar OpenClaw en IM de equipo, se recomienda crear un token Crazyrouter exclusivo para el bot del equipo y establecer una lista blanca de modelos y cuotas más restrictivas.

Gestión de servicios y logs

Linux (systemd)
macOS (launchd)

systemctl --user status openclaw
systemctl --user start openclaw
systemctl --user restart openclaw
systemctl --user stop openclaw
journalctl --user -u openclaw -f

Descripción: El instalador intentará ejecutar loginctl enable-linger $(whoami), de modo que el servicio a nivel de usuario seguirá corriendo incluso si sales de SSH.

launchctl list | grep openclaw
launchctl start com.crazyrouter.openclaw
launchctl stop com.crazyrouter.openclaw
launchctl stop com.crazyrouter.openclaw && launchctl start com.crazyrouter.openclaw
tail -f ~/.openclaw/openclaw.log
cat ~/.openclaw/openclaw.err

Descripción: En macOS, normalmente usa openclaw.log para revisar el log de ejecución; openclaw.err es mejor para analizar fallos de arranque.

Recomendaciones de rendimiento y coste

Comienza con claude-opus-4-8 por defecto; una vez confirmes que el flujo funciona puedes asignar modelos
Para FAQs cotidianas o notificaciones de bot frecuentes, vuelve a claude-opus-4-8 o gemini-3.1-pro por coste
Los flujos de codificación pueden cambiar a gpt-5.5
Divide los tokens para Telegram, IM de equipo y WebUI en escenarios de equipo, para mayor control de costes y aislamiento de riesgos
Mantén sólo los plugins y modelos necesarios, reduciendo costes por usos involuntarios

Guía de actualización

La forma más fiable de actualizar es ejecutar el instalador nuevamente, ya que actualiza el paquete OpenClaw, parches y scripts del servicio juntos:

Respaldar la configuración actual

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

Ejecutar nuevamente el script de instalación

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-openclaw/main/install.sh | bash

Verificar si se necesita restaurar la configuración personalizada

Si has añadido manualmente canales fuera de Telegram o cambiado el modelo por defecto, compara nuevamente openclaw.json para asegurarte que tus personalizaciones siguen presentes.

Reiniciar y verificar

Reabre el WebUI y comprueba que los modelos, logs y canales IM integrados funcionen normalmente.

Si tienes claro que solo quieres actualizar el paquete npm de OpenClaw, primero ejecuta npm install -g openclaw@latest y luego reinicia el servicio; pero así no se aplican los parches ni actualizaciones de scripts del instalador.

Guía de desinstalación

Linux
macOS

systemctl --user disable --now openclaw
rm -f ~/.config/systemd/user/openclaw.service
systemctl --user daemon-reload
rm -rf ~/.openclaw
npm uninstall -g openclaw

launchctl stop com.crazyrouter.openclaw
launchctl unload ~/Library/LaunchAgents/com.crazyrouter.openclaw.plist
rm -f ~/Library/LaunchAgents/com.crazyrouter.openclaw.plist
rm -rf ~/.openclaw
npm uninstall -g openclaw

Si instalaste Node.js sólo para OpenClaw, puedes desinstalarlo manualmente cuando te asegures de que no hay otras dependencias.

Errores comunes y soluciones

Fenómeno	Causa común	Solución
WebUI no abre	Servicio no iniciado, puerto ocupado, firewall sin liberar	Revisa el estado del servicio, luego el puerto `18789` y el firewall
La página abre pero pide login continuamente	`gateway.auth.token` incorrecto, o estás accediendo a la dirección equivocada	Lee nuevamente el link `?token=...` del instalador, revisa `openclaw.json` si necesitas
401 no autorizado	La key Crazyrouter en `models.providers.*.apiKey` es inválida o ha expirado	Actualiza la API Key y reinicia el servicio
403 / modelo no permitido	El modelo solicitado no está en la lista blanca del token Crazyrouter	Permite el modelo adecuado en la configuración del token
429 / cuota agotada	Exceso de token o límite de velocidad activado	Aumenta la cuota, cambia a modelos más baratos o divide los tokens
Al cambiar modelo sigue invocando el anterior	Servicio sin reiniciar, o ruta del provider incorrecta	Revisa `agents.defaults.model.primary` y luego reinicia
Telegram Bot no responde	`botToken` sin escribir, emparejamiento de owner sin completar, o servicio sin reiniciar	Revisa `channels.telegram`, reinicia el servicio, vuelve a enviar mensaje para emparejar
Tras instalar en Linux el servicio no se inicia	Fallo del servicio systemd de usuario	Ejecuta `journalctl --user -u openclaw -f` para ver errores
Tras instalar en macOS el servicio no se inicia	Fallo de launchd	Revisa `~/.openclaw/openclaw.err`

FAQ

¿Qué dirección debo usar como backend Crazyrouter?

Por defecto mantén el valor escrito por el instalador: proveedor compatible OpenAI es https://api.crazyrouter.com/v1; para proveedores compatibles con Claude / MiniMax usa https://api.crazyrouter.com.

¿Qué modelo predeterminado debo mantener?

La mayoría de usuarios deberían mantener claude-opus-4-8. Si usas principalmente OpenClaw como asistente de código, entonces cámbiate a gpt-5.5.

¿Por qué no aparece el modelo que quiero usar en la lista?

Normalmente porque el token Crazyrouter no permite ese modelo, o cambiaron incorrectamente el prefijo del proveedor.

¿Por qué funciona Telegram en chat privado pero no en grupos?

Por defecto la política de grupo de Telegram está en allowlist. Ajusta la configuración del canal de Telegram según tus necesidades.

¿Cuál es la manera más segura de exponer OpenClaw?

Mínimo haz tres cosas: limita el origen de las conexiones, protege gateway.auth.token, y usa un token Crazyrouter exclusivo para OpenClaw. Si expones directamente a internet, agrega un proxy inverso y controles adicionales de acceso.

Ver repositorio del script de instalación

Consulta el script de instalación, envía Issue, o revisa manualmente la lógica de instalación de un clic.

Primeros pasos

Funciones

Precios oficiales de los modelos

Despliegue OpenClaw con un solo clic

Resumen

¿Para quién es adecuado?

Acuerdo de uso

Requisitos previos

Inicio rápido en 5 minutos

Configuración recomendada de modelos

Buenas prácticas para la configuración de token

Lista de verificación de éxito inicial

Archivos clave y parámetros de configuración

Ubicación de archivos

Parámetros de configuración más habituales

Integración IM

Telegram

Otras plataformas IM

Gestión de servicios y logs

Recomendaciones de rendimiento y coste

Guía de actualización

Guía de desinstalación

Errores comunes y soluciones

FAQ

¿Qué dirección debo usar como backend Crazyrouter?

¿Qué modelo predeterminado debo mantener?

¿Por qué no aparece el modelo que quiero usar en la lista?

¿Por qué funciona Telegram en chat privado pero no en grupos?

¿Cuál es la manera más segura de exponer OpenClaw?

Ver repositorio del script de instalación

​Resumen

​¿Para quién es adecuado?

​Acuerdo de uso

​Requisitos previos

​Inicio rápido en 5 minutos

​Configuración recomendada de modelos

​Buenas prácticas para la configuración de token

​Lista de verificación de éxito inicial

​Archivos clave y parámetros de configuración

​Ubicación de archivos

​Parámetros de configuración más habituales

​Integración IM

​Telegram

​Otras plataformas IM

​Gestión de servicios y logs

​Recomendaciones de rendimiento y coste

​Guía de actualización

​Guía de desinstalación

​Errores comunes y soluciones

​FAQ

​¿Qué dirección debo usar como backend Crazyrouter?

​¿Qué modelo predeterminado debo mantener?

​¿Por qué no aparece el modelo que quiero usar en la lista?

​¿Por qué funciona Telegram en chat privado pero no en grupos?

​¿Cuál es la manera más segura de exponer OpenClaw?

Ver repositorio del script de instalación

Resumen

¿Para quién es adecuado?

Acuerdo de uso

Requisitos previos

Inicio rápido en 5 minutos

Configuración recomendada de modelos

Buenas prácticas para la configuración de token

Lista de verificación de éxito inicial

Archivos clave y parámetros de configuración

Ubicación de archivos

Parámetros de configuración más habituales

Integración IM

Telegram

Otras plataformas IM

Gestión de servicios y logs

Recomendaciones de rendimiento y coste

Guía de actualización

Guía de desinstalación

Errores comunes y soluciones

FAQ

¿Qué dirección debo usar como backend Crazyrouter?

¿Qué modelo predeterminado debo mantener?

¿Por qué no aparece el modelo que quiero usar en la lista?

¿Por qué funciona Telegram en chat privado pero no en grupos?

¿Cuál es la manera más segura de exponer OpenClaw?