Guía de implementación de OpenClaw Manager

Introducción

OpenClaw Manager es una herramienta visual de gestión multiplataforma que le ayuda a implementar y gestionar rápidamente gateways de bots de IA OpenClaw.

Implementación sin configuración — Archivo ejecutable único, instala automáticamente todas las dependencias
Interfaz web de gestión — Cree, inicie/detenga, elimine instancias y cambie modelos desde el navegador
Soporte multicanal — Telegram / Feishu / Discord
Soporte multimodelo — Serie GPT-5, serie Claude 4.5/4.6, serie Gemini con failover automático
Modo en segundo plano — Compatible con modo --daemon, sin verse afectado por desconexiones SSH
Interfaz multilingüe — Chino / Inglés / Japonés

Requisitos previos

Antes de empezar, asegúrese de que:

La clave de API de APIMart se ha obtenido Inicie sesión en la Consola de APIMart para obtener su clave de API (comienza con sk-)
El Bot de la plataforma de mensajería se ha creado Prepare las credenciales de su Bot según la plataforma que desee usar (vea la sección de configuración de canal a continuación)

Consejo: si aún no tiene una cuenta de APIMart, regístrese en APIMart y obtenga primero una clave de API.

Paso 1: Descarga

Descargue el ejecutable para su plataforma desde GitHub Releases:

Plataforma	Nombre del archivo
Windows x64	`openclaw-manager-win-x64.exe`
macOS ARM (Apple Silicon)	`openclaw-manager-macos-arm64.zip`
macOS Intel	`openclaw-manager-macos-x64.zip`
Linux x64	`openclaw-manager-linux-x64`
Linux ARM64	`openclaw-manager-linux-arm64`

Paso 2: Ejecución

Windows
Linux
macOS

Implementación en Windows

Requisitos previos

Windows 10/11 (64 bits)
Privilegios de administrador (necesarios para crear tareas programadas de Windows que gestionen Gateway)

Inicio

Haga clic derecho en openclaw-manager-win-x64.exe → Ejecutar como administrador

En el primer inicio se realizará lo siguiente de forma automática:

Verificación e instalación de Node.js v22 (descarga automáticamente el MSI para instalación silenciosa si no se encuentra)
Instalación de OpenClaw CLI (mediante npm install -g openclaw)
Apertura automática del navegador en la interfaz de gestión

Debe ejecutarse como administrador, de lo contrario no se podrán crear tareas programadas de Windows para gestionar los procesos de Gateway.

Implementación en Linux

Requisitos previos

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ (x64 o ARM64)
Privilegios de root (recomendado)

Inicio

Descargue y conceda permisos de ejecución:

chmod +x ./openclaw-manager-linux-x64

Modo en primer plano (para pruebas):

./openclaw-manager-linux-x64

Modo en segundo plano (recomendado para producción):

./openclaw-manager-linux-x64 --daemon

Gestión del daemon

# Iniciar en segundo plano
./openclaw-manager-linux-x64 --daemon
# O forma abreviada
./openclaw-manager-linux-x64 -d

# Comprobar estado
./openclaw-manager-linux-x64 --status

# Detener
./openclaw-manager-linux-x64 --stop
# O forma abreviada
./openclaw-manager-linux-x64 -s

Configuración del firewall

Si necesita acceso remoto, abra los siguientes puertos:

# Interfaz web del Manager
ufw allow 51942/tcp

# Puertos de Gateway (uno por instancia, a partir de 18789)
ufw allow 18789/tcp

Consejo: en Linux, Manager se enlaza automáticamente a 0.0.0.0, permitiendo el acceso remoto. El archivo de log está en ~/openclaw-manager.log.

Implementación en macOS

Requisitos previos

macOS 12+ (Apple Silicon o Intel)

Inicio

Descomprima el archivo zip descargado para obtener OpenClaw Manager.app
Haga doble clic para ejecutar OpenClaw Manager.app
La primera ejecución puede requerir ajustes de seguridad:

Ajustes del sistema → Privacidad y seguridad → Permitir de todos modos

Consejo: en macOS, Manager se enlaza a 127.0.0.1 (solo acceso local). Los comandos del daemon son los mismos que en Linux.

Paso 3: Acceder a la interfaz de gestión

Tras iniciar el programa, acceda a la interfaz web de gestión:

http://127.0.0.1:51942

Acceso remoto en Linux: reemplace 127.0.0.1 con la IP de su servidor, p. ej. http://your-server-ip:51942

Paso 4: Crear una instancia

En la interfaz web de gestión, haga clic en + New Instance para comenzar:

4.1 Establecer el nombre de la instancia

Introduzca un nombre para la instancia (solo letras, números, guiones bajos y guiones, 1-64 caracteres).

4.2 Seleccionar el modelo de IA

Elija el modelo de IA que desea usar e introduzca su clave de API de APIMart (comienza con sk-). Modelos compatibles:

ID del modelo	Nombre	Características
`gpt-5`	GPT-5	El más reciente y potente
`gpt-5.1`	GPT-5.1	Versión mejorada
`gpt-5.2-codex`	GPT-5.2 Codex	Especializado en código
`gpt-5.2-pro`	GPT-5.2 Pro	Versión profesional
`claude-opus-4-6-20260320`	Claude Opus 4.6	Razonamiento más fuerte
`claude-sonnet-4-6-20260320`	Claude Sonnet 4.6	Elección equilibrada
`claude-opus-4-5-20251101`	Claude Opus 4.5	Razonamiento avanzado
`claude-sonnet-4-5-20250929`	Claude Sonnet 4.5	Excelente para código
`claude-haiku-4-5-20251001`	Claude Haiku 4.5	Respuesta rápida
`gemini-2.5-flash`	Gemini 2.5 Flash	Multimodal rápido
`gemini-3-pro-preview`	Gemini 3 Pro Preview	Alto rendimiento

Recomendaciones de modelos:

💰 Buena relación calidad-precio: claude-haiku-4-5-20251001, gemini-2.5-flash
🚀 Alto rendimiento: gpt-5, claude-opus-4-6-20260320, gemini-3-pro-preview
⚡ Respuesta rápida: gemini-2.5-flash, claude-haiku-4-5-20251001

También puede seleccionar el modo failover para añadir varios modelos de respaldo. Cuando el modelo principal no esté disponible, el sistema cambiará automáticamente a los modelos de respaldo.

4.3 Configurar el canal de mensajería

Seleccione su plataforma de mensajería y siga el tutorial correspondiente:

Cree un bot de Telegram mediante BotFather

Feishu

Cree un bot corporativo de Feishu

Discord

Cree un bot de servidor de Discord

Paso 5: Vinculación con código de emparejamiento

Después de crear e iniciar la instancia, complete la vinculación del usuario mediante el código de emparejamiento:

El usuario envía cualquier mensaje al bot en la plataforma de mensajería
El bot responde con un código de emparejamiento de 8 dígitos (p. ej. DFE62DTD)
El administrador hace clic en el botón “Pairing Code” de la instancia correspondiente en la interfaz web
Introduzca el código de emparejamiento y haga clic en “Approve”
El usuario ya puede usar el bot normalmente

Consejo: los códigos de emparejamiento se almacenan en la memoria de Gateway y expiran tras un reinicio. Si un código expira, basta con pedir al usuario que envíe un nuevo mensaje para obtener un código nuevo.

Gestionar instancias

En la interfaz de gestión, puede realizar las siguientes operaciones:

Acción	Descripción
Iniciar	Inicia el proceso de Gateway; el bot empieza a recibir mensajes
Detener	Detiene el proceso de Gateway
Cambiar modelo	Cambia el modelo de IA en tiempo real sin reiniciar Gateway
Código de emparejamiento	Aprueba los códigos de emparejamiento de nuevos usuarios para autorizar el uso del bot
Eliminar	Detiene y elimina la instancia con todos los datos (irreversible)

Puertos y datos

Puertos

Propósito	Puerto	Dirección de bind
Interfaz web del Manager	`51942`	Windows/macOS: `127.0.0.1`, Linux: `0.0.0.0`
Instancia de Gateway	A partir de `18789`	Cada instancia obtiene un puerto único

Directorios de datos

Contenido	Ruta
Configuración de instancia	`~/.openclaw-<instance-name>/openclaw.json`
Logs de Gateway	`~/.openclaw-<instance-name>/logs/gateway.log`
Logs del Manager	`~/openclaw-manager.log` (modo daemon)
PID del Manager	`~/.openclaw-manager.pid`

Preguntas frecuentes

Q1: ¿El Manager no inicia?

Soluciones:

Plataforma	Comprobación
Windows	Confirme que se ejecuta como administrador
Linux	Confirme que el puerto 51942 no está en uso (`lsof -i :51942`)
macOS	Confirme que se permitieron los ajustes de seguridad o que se eliminó el quarantine
Todas	Revise los logs en `~/openclaw-manager.log`

Q2: ¿Comando openclaw no encontrado?

Soluciones:

El programa detecta e instala automáticamente openclaw CLI al iniciarse
Si la versión es demasiado antigua (< 0.1.0), se actualizará automáticamente
Instalación manual: npm install -g openclaw@latest

Q3: ¿La instancia aparece como “stopped” después de iniciarse?

Soluciones:

Gateway tarda unos segundos en enlazarse al puerto; el estado puede aparecer inconsistente brevemente
Actualice la página para comprobar el estado más reciente
Revise los logs de Gateway: ~/.openclaw-<instance-name>/logs/gateway.log

Q4: ¿El bot de Feishu no responde?

Soluciones:

Confirme que la suscripción de eventos incluye im.message.receive_v1
Confirme que el método de suscripción es “Long Connection”
Confirme que se creó y publicó una nueva versión (necesario tras cada cambio de permiso/evento)

Q5: ¿Falló la aprobación del código de emparejamiento?

Soluciones:

Confirme que Gateway está en ejecución
Los códigos de emparejamiento se almacenan en la memoria de Gateway y expiran tras un reinicio
Pida al usuario que envíe un nuevo mensaje para obtener un nuevo código de emparejamiento

Q6: ¿Cómo ver el uso y los costes de la API?

Inicie sesión en la Consola de APIMart para ver:

📊 Estadísticas de llamadas a la API
💰 Detalles de costes
📈 Gráficos de tendencias de uso

Soporte y ayuda

Si encuentra algún problema:

Comience con APIMart

¡Regístrese en APIMart ahora, obtenga su clave de API e implemente su bot de IA!

​Introducción

​Requisitos previos

​Paso 1: Descarga

​Paso 2: Ejecución

​Implementación en Windows

​Requisitos previos

​Inicio

​Implementación en Linux

​Requisitos previos

​Inicio

​Gestión del daemon

​Configuración del firewall

​Implementación en macOS

​Requisitos previos

​Inicio

​Paso 3: Acceder a la interfaz de gestión

​Paso 4: Crear una instancia

​4.1 Establecer el nombre de la instancia

​4.2 Seleccionar el modelo de IA

​4.3 Configurar el canal de mensajería

Telegram

Feishu

Discord

​Paso 5: Vinculación con código de emparejamiento

​Gestionar instancias

​Puertos y datos

​Puertos

​Directorios de datos

​Preguntas frecuentes

​Q1: ¿El Manager no inicia?

​Q2: ¿Comando openclaw no encontrado?

​Q3: ¿La instancia aparece como “stopped” después de iniciarse?

​Q4: ¿El bot de Feishu no responde?

​Q5: ¿Falló la aprobación del código de emparejamiento?

​Q6: ¿Cómo ver el uso y los costes de la API?

​Soporte y ayuda

Comience con APIMart

Introducción

Requisitos previos

Paso 1: Descarga

Paso 2: Ejecución

Implementación en Windows

Requisitos previos

Inicio

Implementación en Linux

Requisitos previos

Inicio

Gestión del daemon

Configuración del firewall

Implementación en macOS

Requisitos previos

Inicio

Paso 3: Acceder a la interfaz de gestión

Paso 4: Crear una instancia

4.1 Establecer el nombre de la instancia

4.2 Seleccionar el modelo de IA

4.3 Configurar el canal de mensajería

Paso 5: Vinculación con código de emparejamiento

Gestionar instancias

Puertos y datos

Puertos

Directorios de datos

Preguntas frecuentes

Q1: ¿El Manager no inicia?

Q2: ¿Comando openclaw no encontrado?

Q3: ¿La instancia aparece como “stopped” después de iniciarse?

Q4: ¿El bot de Feishu no responde?

Q5: ¿Falló la aprobación del código de emparejamiento?

Q6: ¿Cómo ver el uso y los costes de la API?

Soporte y ayuda