
ZeaburOpenClaw 🦞 (anteriormente Clawdbot, Moltbot) es un asistente personal de IA que se ejecuta localmente y se conecta a múltiples plataformas de mensajería a través de una arquitectura Gateway basada en WebSocket.
⚠️ Esta plantilla usa ghcr.io/openclaw/openclaw:2026.3.7. OpenClaw 🦞 está en desarrollo rápido, por lo que puede haber errores no descubiertos. Cambiar de versión tampoco garantiza estabilidad.
⚠️ Si encuentra algún problema, no dude en consultar los GitHub issues para buscar soluciones o reportar nuevos problemas. Para problemas relacionados con la plataforma Zeabur, contacte al soporte de Zeabur.
⚠️ El software y paquetes específicos de macOS (como Homebrew) no son compatibles en este entorno de contenedor. Por favor busque soluciones alternativas.
⚠️ Esta plantilla requiere un Servidor Dedicado en Zeabur. No se puede ejecutar en clústeres compartidos.
⚠️ Esta plantilla está preconfigurada y lista para usar - no es necesario ejecutar openclaw onboard. Si desea reconfigurar, abra Comando en el panel de Zeabur y ejecute:
openclaw onboard --gateway-bind lan
Consulte Wizard Reference para todos los flags disponibles.
glm-4.7-flash): Si ingresó la API Key durante el despliegue, vaya directamente al paso 3. También puede agregar ZEABUR_AI_HUB_API_KEY después en la pestaña Variables del panel de Zeabur (reinicie el servicio después de agregar).anthropic/claude-opus-4-6. Vaya a Web UI Settings o agregue la clave API mediante variables de entorno. Más info: https://docs.openclaw.ai/providers/anthropicPara configuración de modelos de AI, consulte la documentación oficial.
Esta plantilla incluye modelos de failover que cambian automáticamente cuando el modelo principal no está disponible. Cadena predeterminada: glm-4.7-flash → grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini.
Puede gestionar modelos desde Web UI Chat o Comando en el panel de Zeabur.
Desde Web UI Chat — escriba slash commands directamente en el chat:
/model zeabur-ai/glm-4.7-flash — cambiar modelo principal/model — ver modelo actual/models — listar proveedores de modelos/models <provider> — listar modelos de un proveedor (ej. /models zeabur-ai)Desde Comando (panel de Zeabur) — mismos comandos en la terminal:
openclaw models set zeabur-ai/glm-4.7-flash
openclaw models status
openclaw models list --all
openclaw models fallbacks list
openclaw models fallbacks add zeabur-ai/gpt-5-mini
openclaw models fallbacks remove zeabur-ai/gpt-5-mini
openclaw models fallbacks clear
O editar el archivo de configuración directamente (~/.openclaw/config.json5):
"agents": {
"defaults": {
"model": {
"primary": "zeabur-ai/glm-4.7-flash",
"fallbacks": ["zeabur-ai/grok-4-fast-non-reasoning", "zeabur-ai/minimax-m2.5"]
}
}
}
Después de editar el archivo, reinicie el servicio.
Además de Zeabur AI Hub, puede agregar proveedores externos como Anthropic, OpenAI, Google, etc.
Método 1: Variables de entorno — agregue API keys en la pestaña Variables del panel de Zeabur:
ANTHROPIC_API_KEY — modelos ClaudeOPENAI_API_KEY — modelos GPTGOOGLE_API_KEY — modelos GeminiDespués de agregar, reinicie el servicio y cambie el modelo:
/model anthropic/claude-opus-4-6openclaw models set anthropic/claude-opus-4-6Método 2: Auth token — abra Comando en el panel de Zeabur:
# Pegar una API key de un proveedor
openclaw models auth paste-token --provider anthropic
# O usar el asistente de autenticación interactivo
openclaw models auth add
Método 3: Archivo de configuración — edite ~/.openclaw/config.json5:
"models": {
"providers": {
"anthropic": { "apiKey": "sk-ant-..." },
"openai": { "apiKey": "sk-..." }
}
}
Para todos los proveedores soportados, consulte la documentación oficial.
Obtener el token de BotFather:
/newbot para crear un nuevo bot123456789:ABCdefGHIjklMNOpqrsTUVwxyz)Agregar el token a Zeabur:
TELEGRAM_BOT_TOKEN con su token de bot"plugins": { "entries": { "telegram": { "enabled": true } } }. Para deshabilitar, establezca enabled en false.Vincular su cuenta de Telegram:
/start a su bot en TelegramJN4MSY23)openclaw pairing approve telegram <código>openclaw pairing approve telegram <código>Approved telegram sender <user-id>.Paso 1: Configurar canal de WhatsApp Agregue la siguiente configuración a través de OpenClaw Web UI (Settings → Config) o péguela en el chat:
"channels": {
"whatsapp": {
"selfChatMode": true,
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
}
}
Reemplace +15551234567 con su número de teléfono de WhatsApp (con código de país). Reinicie el servicio después de guardar.
Paso 2: Vincular WhatsApp
openclaw channels loginCrear un canal de LINE Messaging API:
Agregar credenciales a Zeabur:
LINE_CHANNEL_ACCESS_TOKEN con su Channel access tokenLINE_CHANNEL_SECRET con su Channel secret"plugins": { "entries": { "line": { "enabled": true } } }Configurar el Webhook:
https://<your-domain>/line/webhookhttps://<your-domain>/line/webhookVincular su cuenta de LINE:
JN4MSY23)openclaw pairing approve line <código>openclaw pairing approve line <código>Approved line sender <user-id>.Para otras plataformas de mensajería (Discord, Slack, etc.), consulte la documentación de Canales.
Verifique su configuración:
zeabur-ai/glm-4.7-flashanthropic/claude-opus-4-6 (requiere clave API)Cambiar modelo para la conversación actual (mediante comandos de chat):
/models - Ver modelos disponibles/model <model-id> - Cambiar modelo solo para esta conversación (no afecta otras conversaciones)Cambiar modelo predeterminado para todas las conversaciones nuevas (vía Web UI Settings):
gemini-2.5-flash-lite, gpt-5-nano). Si un modelo deja de estar disponible, use /new para iniciar una nueva conversación con el modelo predeterminado.Agregar proveedores de AI (vía Web UI Settings o variables de entorno):
Modificar modelos de Zeabur AI Hub (vía panel de Zeabur):
/opt/openclaw/providers/zeabur-ai-hub.json5, luego reiniciar el servicio (los cambios se sincronizan al iniciar)/home/node/.openclaw/openclaw.json vía pestaña Archivos o Web UI Settings. Agregue lo siguiente al array models.providers.zeabur-ai.models:{ "id": "gpt-5.2", "name": "GPT-5.2", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.75, "output": 14, "cacheRead": 0.18, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.25, "output": 10, "cacheRead": 0.13, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.05, "output": 0.4, "cacheRead": 0.01, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "glm-4.7", "name": "GLM-4.7", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.4, "output": 1.9, "cacheRead": 0.08, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.06, "output": 0.4, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2.25, "cacheRead": 0.07, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }
La Web UI es una herramienta de gestión para configuración, monitoreo y chat — las plataformas de mensajería (Telegram, WhatsApp, Discord, etc.) funcionan independientemente sin ella. Si solo usa plataformas que no requieren webhooks entrantes (Telegram, WhatsApp, Discord, Signal, iMessage), puede eliminar el enlace de dominio en el panel de Zeabur (pestaña Networking) para evitar exponer el gateway a internet público. Todas las tareas de gestión también se pueden realizar mediante CLI en la terminal Comando de Zeabur (openclaw config set, openclaw models set, etc.). Para acceder a la Web UI de forma privada sin un dominio público, consulte Acceso por Red Privada con Tailscale. También puede configurar OPENCLAW_GATEWAY_BIND como loopback en la pestaña Variables (reinicie el servicio después) para restringir el gateway solo a conexiones locales.
Plataformas que requieren un dominio público (webhook entrante): LINE, Slack, Google Chat.
Todos los datos se almacenan en /home/node:
/home/node/.openclaw - Configuración, sesiones, dispositivos y credenciales/home/node/.openclaw/workspace - Espacio de trabajo y archivos de memoria💡 Consejo: Recomendamos crear una copia de seguridad después de completar la configuración inicial o realizar cambios importantes.
Copia de Seguridad:
backup → Descargue desde Archivos en /home/node (ej. backup-1430.tar.gz)
cd /home/node && tar -czvf backup.tar.gz .openclawRestauración:
/home/node en Archivosrestore <nombre-archivo> --strip 2 (ej. restore data-2026-02-27.zip --strip 2)restore <nombre-archivo> (ej. restore backup-1430.tar.gz)cd /home/node && tar -xzvf <nombre-archivo>/home/node en Archivos para liberar espacio en disco⚠️ La restauración sobrescribirá la configuración y los datos existentes en el nuevo servicio. Recuerde también restaurar las variables de entorno relacionadas (ej. TELEGRAM_BOT_TOKEN). La copia de seguridad/restauración de canales solo se ha probado con Telegram y WhatsApp.
Comando de inicio predeterminado:
/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
Cuando el gateway se detiene, aparece una página de ayuda en la URL del servicio con detalles del error y pasos para solucionarlo:
/home/node/.openclaw/openclaw.json) y corrija el problemaSi su despliegue no tiene la página de ayuda, siga estos pasos:
sleep 3600, luego haga clic en Reiniciar — esto mantiene el contenedor en ejecución para poder editar archivos/home/node/.openclaw/openclaw.json) y corrija el problema/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh y haga clic en Reiniciar💡 Para activar la página de ayuda, redespliegue desde esta plantilla.
ghcr.io/openclaw/openclaw, Etiqueta: cambie de la versión actual (ej. 2026.2.26) a la nueva versión (ej. 2026.3.7)⚠️ Evite usar
latestcomo etiqueta — descarga la versión más reciente en cada reinicio, lo que puede introducir cambios incompatibles o errores inesperados. Fije una versión específica para mayor estabilidad.
💡 El script de inicio migra automáticamente su configuración en cada arranque — los ajustes faltantes (como
trustedProxies,dangerouslyDisableDeviceAuth) se agregan automáticamente. Sus configuraciones existentes se conservan.
Esto significa que la Web UI aún no ha sido emparejada con un Gateway Token. Solución:
Puede encontrar el Gateway Token en la pestaña Instrucciones del Dashboard de Zeabur o en Variables de entorno (OPENCLAW_GATEWAY_TOKEN).
Esto significa que su dispositivo (navegador/aplicación) aún no ha sido emparejado con el Gateway. Para emparejar:
openclaw devices list — ver solicitudes de emparejamiento pendientes y encontrar el requestIdopenclaw devices approve <requestId> — aprobar el dispositivoEste error ocurre al actualizar a la imagen 2026.2.23 o posterior sin actualizar la configuración. Solución: edite /home/node/.openclaw/openclaw.json y agregue "dangerouslyAllowHostHeaderOriginFallback": true bajo gateway.controlUi:
{
"gateway": {
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true
}
}
}
Luego reinicie el servicio. Los nuevos despliegues desde esta plantilla ya incluyen esta configuración.
⚠️ Esta función solo está disponible para despliegues nuevos. Los despliegues existentes no incluyen los scripts de inicio de Tailscale — por favor redespliegue la plantilla para usar esta función.
En lugar de un dominio público, puede usar Tailscale para que OpenClaw sea accesible solo dentro de su red privada (tailnet), sin exponerlo a internet público.
Requisitos previos:
Paso 1: Configurar variables de entorno En la pestaña Variables de Entorno del dashboard de Zeabur, agregue:
TS_AUTHKEY (requerido): Su Tailscale Auth Key (tskey-auth-xxx). Créela en Tailscale Admin Console → Keys. Sin esta variable, la configuración de Tailscale se omite por completo.TS_HOSTNAME (opcional): El nombre de la máquina en su tailnet, que determina su URL de acceso (https://<TS_HOSTNAME>.<tailnet>.ts.net). Por defecto es openclaw si no se configura.Paso 2: Cambiar comando de inicio Vaya a Configuración → Comando, cambie a:
/opt/openclaw/startup.sh && /opt/openclaw/start_gateway_tailscale.sh
Reinicie el servicio.
Paso 3: Instalar Tailscale en su dispositivo Instale Tailscale en el dispositivo desde el que quiere acceder a OpenClaw (macOS, Windows, iOS, Android, Linux), e inicie sesión con la misma cuenta de Tailscale usada para crear la Auth Key.
Paso 4: Primer inicio de sesión en Web UI Una vez iniciado, abra en su navegador (debe estar en la misma tailnet):
https://<TS_HOSTNAME>.<su-tailnet>.ts.net
Puede encontrar su nombre DNS de tailnet en Consola de Administración de Tailscale → DNS, o verificar la URL completa en los Logs del servicio en el dashboard de Zeabur.
Inicie sesión usando cualquiera de estos métodos:
https://<TS_HOSTNAME>.<su-tailnet>.ts.net?token=<GATEWAY_TOKEN>Puede encontrar el Gateway Token en la pestaña Instrucciones o Variables de Entorno del dashboard de Zeabur (OPENCLAW_GATEWAY_TOKEN).
Paso 5: Conectar OpenClaw app (Opcional, ejemplo macOS)
wss://<TS_HOSTNAME>.<su-tailnet>.ts.netPara configuración de iOS y Android, consulte la documentación oficial.
Volver al modo de dominio público:
Cambie el comando de inicio a /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh y reinicie.
Esta plantilla preconfigura los siguientes ajustes para el entorno de nube de Zeabur:
gateway.trustedProxies: Configurado como ["10.0.0.0/8", "172.16.0.0/12"] para que el gateway identifique correctamente las IPs de los clientes detrás del proxy inverso de Zeabur. Sin esto, la Web UI puede mostrar errores de "device identity required".dangerouslyDisableDeviceAuth: Deshabilita el emparejamiento de dispositivos de la Web UI (el emparejamiento está diseñado para redes locales; los despliegues en la nube usan autenticación por Gateway Token)./usr/local/bin: Los comandos openclaw, backup y restore tienen enlaces simbólicos en /usr/local/bin para funcionar en la terminal de Comando de Zeabur.OPENCLAW_DISABLE_BONJOUR=1: Deshabilita mDNS/Bonjour porque los nombres de host de los contenedores de Zeabur pueden exceder el límite de 63 bytes de las etiquetas DNS. mDNS solo se usa para descubrimiento de red local y no es necesario en entornos de nube.OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true: Soluciona problemas de conexión con Telegram en entornos de contenedores (necesario para versiones de imagen 2026.2.17 en adelante).2026/3/8
2026.3.7 — interfaz de plugin context engine, bindings persistentes de canal ACP, enrutamiento de agentes por tema en Telegram, build Docker multi-stage, soporte SecretRef de gateway, 30+ nuevas funciones y 40+ correcciones en 5 versiones (2026.3.3–2026.3.7)gateway.auth.mode ahora requerido cuando gateway.auth.token y gateway.auth.password están configurados — la plantilla predefine mode: "token" (despliegues existentes migran automáticamente al iniciar)gemini-3.1-pro-preview, gemini-3.1-flash-lite-preview, gemini-3.1-flash-image-preview, kimi-2.5gateway.auth.mode: "token" explícito (defensivo para futuros cambios de autenticación de gateway)--port redundante del script de inicio de gateway (puerto resuelto automáticamente vía env/config/default)2026/3/4
2026.3.2 — herramienta PDF, embeddings Ollama, streaming de Telegram por defecto a partial, endpoints de salud del contenedor (/healthz), transporte WebSocket de OpenAI, 200+ correcciones y 20+ mejoras de seguridad en 3 versiones (2026.3.1, 2026.3.2)api.registerHttpHandler(...) deben migrar a api.registerHttpRoute(...), canal Zalouser requiere re-login (openclaw channels login --channel zalouser)2026/3/2
claude-opus-4-6, minimax-m2.5, step-3.5-flashllama-3.3-70b → llama-3.1-8b, qwen-3-32 → qwen-3-235bZEABUR_AI_HUB_API_KEY y reiniciar ahora surte efecto (eliminado envsubst, resolución de ${VAR} en runtime)/opt en cada inicio — actualizaciones de modelo y ediciones en Configs se aplican tras reiniciarOPENCLAW_GATEWAY_BIND=loopback2026/2/27
dangerouslyDisableDeviceAuth — usar autenticación por Gateway Token en lugar de emparejamiento de dispositivo para despliegues en la nubezeabur-ai/glm-4.7-flash con cadena de respaldo (grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini)2026.2.26 — corrección de herencia de allowlist DM de Telegram, corrección de permisos de temp dir en contenedores, corrección de CLI gateway --force en Docker no-root, normalización de ID de modelo Gemini, y endurecimiento de seguridad adicional2026/2/26
2026.2.25 — 100+ correcciones de seguridad entre 2026.2.23→2026.2.25, nuevos proveedores (Kilo Gateway, Mistral, Volcano Engine), configuración de heartbeat directPolicy, endurecimiento de autenticación WebSocket del gateway, aislamiento de enrutamiento entre canales, fiabilidad de Discord voz DAVE, corrección de cuelgue de webhook de Telegram, y numerosas mejoras de estabilidad2026/2/24
2026.2.23 — incluye 30+ correcciones de seguridad, nuevos proveedores (Kilo Gateway, Mistral, Volcano Engine), configuración unificada de streaming de canales, frases de parada multilingües, filtrado de reasoning/thinking en todos los canales, y numerosas mejoras de estabilidaddangerouslyAllowHostHeaderOriginFallback a la configuración de Control UI — requerido para despliegues no-loopback desde 2026.2.232026/2/22
rescue.sh) — reemplazado por la página de ayuda2026/2/20
2026.2.19 — agregar variable OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true para solucionar problemas de conexión con Telegram (requerido para versiones de imagen 2026.2.17 en adelante)2026/2/16
latest para seguir las correcciones de seguridad rápidas2026/2/15
start_gateway_tailscale.sh para acceso HTTPS privado vía tailnet sin exponer a internet público2026.2.142026/2/10
/v1/chat/completions, modelo predeterminado a gemini-2.5-flash-imagegpt-oss-120b, llama-3.3-70b, qwen-3-32: agregar configuración de compatibilidad supportsStore: falsegpt-oss-120b (establecido en true).zip (servicio de backup de Zeabur)TELEGRAM_BOT_TOKEN, DISCORD_BOT_TOKEN, SLACK_BOT_TOKEN, SLACK_APP_TOKEN, LINE_CHANNEL_ACCESS_TOKEN, LINE_CHANNEL_SECRET) al archivo de configuración al iniciar2026/2/7
2026/2/4
backup y restore2026/2/2
Zeabur