> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de implementación de OpenClaw Manager

> Una herramienta visual para la implementación y gestión con un clic de gateways de bots de IA OpenClaw, con soporte para las plataformas Telegram, Feishu y Discord, impulsada por GPT-5, Claude, Gemini y más modelos de IA mediante la API de APIMart.

## 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:

1. **La clave de API de APIMart se ha obtenido**
   Inicie sesión en la [Consola de APIMart](https://apimart.ai/keys) para obtener su clave de API (comienza con `sk-`)

2. **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)

<Note>
  **Consejo:** si aún no tiene una cuenta de APIMart, regístrese en [APIMart](https://apimart.ai) y obtenga primero una clave de API.
</Note>

## Paso 1: Descarga

Descargue el ejecutable para su plataforma desde [GitHub Releases](https://github.com/zhihong-apimart/OpenClaw-Manager-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

<Tabs>
  <Tab title="Windows">
    ### 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

    <Warning>
      **Debe ejecutarse como administrador**, de lo contrario no se podrán crear tareas programadas de Windows para gestionar los procesos de Gateway.
    </Warning>
  </Tab>

  <Tab title="Linux">
    ### Implementación en Linux

    #### Requisitos previos

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

    #### Inicio

    1. Descargue y conceda permisos de ejecución:

    ```bash theme={null}
    chmod +x ./openclaw-manager-linux-x64
    ```

    2. **Modo en primer plano** (para pruebas):

    ```bash theme={null}
    ./openclaw-manager-linux-x64
    ```

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

    ```bash theme={null}
    ./openclaw-manager-linux-x64 --daemon
    ```

    #### Gestión del daemon

    ```bash theme={null}
    # 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:

    ```bash theme={null}
    # Interfaz web del Manager
    ufw allow 51942/tcp

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

    <Note>
      **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`.
    </Note>
  </Tab>

  <Tab title="macOS">
    ### Implementación en macOS

    #### Requisitos previos

    * macOS 12+ (Apple Silicon o Intel)

    #### Inicio

    1. Descomprima el archivo zip descargado para obtener `OpenClaw Manager.app`

    2. Haga doble clic para ejecutar `OpenClaw Manager.app`

    3. La primera ejecución puede requerir ajustes de seguridad:

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

    <Note>
      **Consejo:** en macOS, Manager se enlaza a `127.0.0.1` (solo acceso local). Los comandos del daemon son los mismos que en Linux.
    </Note>
  </Tab>
</Tabs>

## 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
```

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

## 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          |

<Tip>
  **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`
</Tip>

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:

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" href="/es/integrations/platform/openclaw-manager-telegram">
    Cree un bot de Telegram mediante BotFather
  </Card>

  <Card title="Feishu" icon="message" href="/es/integrations/platform/openclaw-manager-feishu">
    Cree un bot corporativo de Feishu
  </Card>

  <Card title="Discord" icon="discord" href="/es/integrations/platform/openclaw-manager-discord">
    Cree un bot de servidor de Discord
  </Card>
</CardGroup>

## 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:

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

<Note>
  **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.
</Note>

## 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:**

1. Confirme que la suscripción de eventos incluye `im.message.receive_v1`
2. Confirme que el método de suscripción es "**Long Connection**"
3. 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](https://apimart.ai/overview) 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:

* 📚 [Documentación de APIMart](https://docs.apimart.ai)
* 📚 [GitHub de OpenClaw Manager](https://github.com/zhihong-apimart/OpenClaw-Manager)
* 💬 [Comunidad de Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Soporte técnico: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Comience con APIMart" icon="rocket" href="https://apimart.ai">
  ¡Regístrese en APIMart ahora, obtenga su clave de API e implemente su bot de IA!
</Card>