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

# Instalación Automática de OpenClaw

> Instala y gestiona instancias de OpenClaw con OpenClaw Manager

## Descripción General

OpenClaw Manager es una herramienta de gestión visual que te ayuda a instalar, configurar y gestionar instancias de OpenClaw rápidamente. No es necesario editar configuraciones manualmente — solo 3 pasos para desplegar.

Se admiten dos canales de mensajería:

|                             | Telegram                                                         | Feishu (Lark)                                                    |
| --------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
| Conexión                    | Bot API (long polling)                                           | Conexión persistente WebSocket                                   |
| Credenciales necesarias     | Bot Token + tu User ID                                           | App ID + App Secret                                              |
| Configuración de plataforma | Solo crear un Bot                                                | Crear una app + habilitar suscripción WebSocket                  |
| Autenticación de usuario    | Vinculado por User ID — solo usuarios autorizados pueden chatear | Cualquier usuario que pueda enviar mensajes al Bot puede chatear |
| Ideal para                  | Uso personal, usuarios internacionales                           | Colaboración en equipo, usuarios en China                        |

## Verificación del Entorno del Sistema

Antes de la instalación, se recomienda ejecutar la herramienta de verificación del entorno para asegurarse de que su sistema cumple con los requisitos de OpenClaw.

### Descargar Herramienta de Verificación

Descargue la herramienta de verificación para su plataforma desde [GitHub Releases](https://github.com/suuuuuu-1/openclaw-env-checker/releases):

| Plataforma            | Nombre del archivo             |
| --------------------- | ------------------------------ |
| Windows               | `openclaw-checker-win-x64.exe` |
| macOS (Intel)         | `openclaw-checker-macos-x64`   |
| macOS (Apple Silicon) | `openclaw-checker-macos-arm64` |
| Linux                 | `openclaw-checker-linux-x64`   |

### Elementos de Verificación

La herramienta verifica automáticamente lo siguiente:

* ✅ Versión de Node.js (requiere >= 22.12.0)
* ✅ npm disponible
* ✅ Git disponible
* ✅ Conectividad de red (github.com, npmjs.org, evolink.ai)

<img src="https://mintcdn.com/muyutechnology/nIFIx0gxdF53THw8/images/OpenClaw-Checker/check-success.png?fit=max&auto=format&n=nIFIx0gxdF53THw8&q=85&s=46f1fdbec3263845e35158b104fa5091" alt="Ejemplo de verificación exitosa" width="1778" height="1742" data-path="images/OpenClaw-Checker/check-success.png" />

Si la verificación falla, la herramienta proporcionará sugerencias de corrección específicas.

## Requisitos Previos

### 1. Instalar Node.js

OpenClaw Manager requiere Node.js 22 o superior.

<Tabs>
  <Tab title="Windows">
    Visita el [sitio oficial de Node.js](https://nodejs.org/es/download), descarga el instalador de Windows (archivo .msi) y ejecútalo haciendo doble clic.

    Después de la instalación, abre PowerShell para verificar:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      Se recomienda ejecutar PowerShell como administrador para evitar problemas de permisos durante la instalación posterior.
    </Note>
  </Tab>

  <Tab title="macOS">
    **Método 1: Usar el instalador**

    Visita el [sitio oficial de Node.js](https://nodejs.org/es/download), descarga el instalador de macOS (archivo .pkg) y ejecútalo haciendo doble clic.

    **Método 2: Usar Homebrew**

    ```bash theme={null}
    brew install node
    ```

    Después de la instalación, abre la terminal para verificar:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      Si encuentras problemas de permisos durante la instalación posterior, es posible que necesites agregar `sudo` antes del comando.
    </Note>
  </Tab>
</Tabs>

### 2. Instalar Git

OpenClaw depende de Git para la gestión de versiones y la instalación de plugins.

<Tabs>
  <Tab title="Windows">
    Visita el [sitio oficial de Git](https://git-scm.com/downloads), descarga el instalador de Windows, ejecútalo haciendo doble clic y completa la instalación con las opciones predeterminadas.

    Después de la instalación, abre PowerShell para verificar:

    ```bash theme={null}
    git --version
    ```
  </Tab>

  <Tab title="macOS">
    **Método 1: Usar Homebrew (recomendado)**

    ```bash theme={null}
    brew install git
    ```

    **Método 2: Usar Xcode Command Line Tools**

    ```bash theme={null}
    xcode-select --install
    ```

    Después de la instalación, abre la terminal para verificar:

    ```bash theme={null}
    git --version
    ```
  </Tab>
</Tabs>

### 3. Obtener la Clave API de EvoLink

* Inicia sesión en la [Consola de EvoLink](https://evolink.ai/dashboard)
* Encuentra API Keys en la consola, haz clic en el botón "Crear nueva clave" y luego copia la clave generada
* La clave API generalmente comienza con `sk-`, guárdala de forma segura

### 4. Obtener Credenciales del Canal

<Accordion title="Guía de configuración de credenciales de Telegram / Feishu">
  <Tabs>
    <Tab title="Telegram">
      1. Busca [@BotFather](https://t.me/BotFather) en Telegram, haz clic en **START BOT**

               <img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_023944_999.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=8675eaaf4ede6e09eb9256830d780e48" alt="Iniciar BotFather" width="652" height="638" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_023944_999.png" />

      2. Envía `/newbot`, sigue las instrucciones para establecer un nombre y obtener tu **Bot Token** (formato: `123456789:ABCdef...`)

               <img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/85be2352-3788-4d21-815e-6a46b2754ca7.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=6b15bf8fa069553fed472e3177d66c34" alt="Crear Bot" width="1798" height="1794" data-path="images/OpenClaw-Telegram/85be2352-3788-4d21-815e-6a46b2754ca7.png" />

      3. Obtén tu **Telegram User ID**: envía `/start` a [@userinfobot](https://t.me/userinfobot) y anota el ID numérico
    </Tab>

    <Tab title="Feishu">
      1. Ve a [Feishu Open Platform](https://open.feishu.cn/app) y crea una aplicación empresarial personalizada

               <img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/create-app.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=68f3383cc4e84f804832d50b0a619b26" alt="Crear app" width="1650" height="611" data-path="images/OpenClaw-Feishu/create-app.avif" />

      2. Obtén el **App ID** y el **App Secret** desde la página "Credentials & Basic Info"

               <img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/get-credentials.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=8b1539f0f9fd1f382304c00aaafd4471" alt="Obtener credenciales" width="1650" height="728" data-path="images/OpenClaw-Feishu/get-credentials.avif" />

      3. En "Permissions & Scopes", haz clic en **Batch Import** y pega el siguiente JSON para importar todos los permisos necesarios:

      ```json theme={null}
      {
        "scopes": {
          "tenant": [
            "aily:file:read",
            "aily:file:write",
            "application:application.app_message_stats.overview:readonly",
            "application:application:self_manage",
            "application:bot.menu:write",
            "cardkit:card:write",
            "contact:contact.base:readonly",
            "contact:user.employee_id:readonly",
            "corehr:file:download",
            "docs:document.content:read",
            "event:ip_list",
            "im:chat",
            "im:chat.access_event.bot_p2p_chat:read",
            "im:chat.members:bot_access",
            "im:message",
            "im:message.group_at_msg:readonly",
            "im:message.group_msg",
            "im:message.p2p_msg:readonly",
            "im:message:readonly",
            "im:message:send_as_bot",
            "im:resource",
            "sheets:spreadsheet",
            "wiki:wiki:readonly"
          ],
          "user": [
            "aily:file:read",
            "aily:file:write",
            "im:chat.access_event.bot_p2p_chat:read"
          ]
        }
      }
      ```

      <img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/configure-permissions.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=b586b4d4778a5af577cbc188cd0f196a" alt="Configurar permisos" width="1650" height="755" data-path="images/OpenClaw-Feishu/configure-permissions.avif" />

      4. En "App Capabilities > Bot", habilita la capacidad de bot y establece el nombre del bot

               <img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Feishu/enable-bot.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=4acd5043b50c2a799eff3516390e6e39" alt="Habilitar bot" width="2888" height="1386" data-path="images/OpenClaw-Feishu/enable-bot.png" />

      <Warning>
        La configuración básica de la app de Feishu está completa. Los pasos restantes — suscripción de eventos y publicación de versión — deben realizarse después de que el gateway esté desplegado y en ejecución, de lo contrario la configuración de conexión larga no se guardará. Completa primero el Paso 1 y el Paso 2 a continuación, luego regresa a Feishu Open Platform para continuar.
      </Warning>
    </Tab>
  </Tabs>
</Accordion>

## Paso 1: Descargar y Ejecutar

Descarga el ejecutable para tu plataforma desde [Releases](https://github.com/Pharmacist9527/openclaw-manager/releases):

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/github-releases.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=9fbc4a72fa1477c55b3b30ff4f5b4e61" alt="Página de Releases en GitHub" width="2460" height="1290" data-path="images/OpenClaw-Auto/github-releases.png" />

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/github-repo.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=eb49f5e9812dc35fba7f32e5185cce26" alt="Descargar ejecutable" width="2490" height="1297" data-path="images/OpenClaw-Auto/github-repo.png" />

| Plataforma            | Archivo                        |
| --------------------- | ------------------------------ |
| Windows               | `openclaw-manager-win-x64.exe` |
| macOS (Intel)         | `openclaw-manager-macos-x64`   |
| macOS (Apple Silicon) | `openclaw-manager-macos-arm64` |
| Linux                 | `openclaw-manager-linux-x64`   |

<Warning>
  Asegúrate de tener instalado [Node.js 22+](https://nodejs.org/es/download).
</Warning>

Los usuarios de Windows deben hacer clic derecho y ejecutar como administrador. Los usuarios de macOS / Linux deben ejecutar con `sudo` en la terminal:

```bash theme={null}
chmod +x ./openclaw-manager && sudo ./openclaw-manager
```

El script verificará e instalará OpenClaw si es necesario, luego iniciará la interfaz web de gestión local y abrirá tu navegador.

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/home-new-instance.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=6486cfdf2515363805686500744edd8b" alt="Crear nueva instancia" width="2392" height="1180" data-path="images/OpenClaw-Auto/home-new-instance.png" />

## Paso 2: Crear una Instancia

### 2.1 — Información Básica

| Campo               | Descripción                                                            |
| ------------------- | ---------------------------------------------------------------------- |
| Nombre de Instancia | Nombre para tu instancia (ej. `mybot`), debe ser único en esta máquina |
| Modelo              | Elige un modelo: Haiku 4.5 / Sonnet 4.5 / Opus 4.5 / Opus 4.6          |
| Canal               | Elige un canal: Telegram o Feishu                                      |

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/wizard-step1-basic-info.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=8f447ce14f51fb0627c813b9f4d073ec" alt="Información básica" width="2549" height="1242" data-path="images/OpenClaw-Auto/wizard-step1-basic-info.png" />

### 2.2 — Credenciales y Despliegue

Todos los canales requieren una **Clave API de EvoLink**.

<Tabs>
  <Tab title="Telegram">
    Ingresa el **Bot Token** de @BotFather, luego haz clic en **Deploy**.

    El script realizará automáticamente:

    1. Crear el archivo de configuración de OpenClaw
    2. Escribir la configuración del modelo y la clave API
    3. Configurar y habilitar el plugin de Telegram
    4. Instalar e iniciar el servicio de gateway

           <img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/wizard-step2-telegram-credentials.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=5c99b55b92ad3aa458133ac155c85e17" alt="Credenciales de Telegram" width="2549" height="1242" data-path="images/OpenClaw-Auto/wizard-step2-telegram-credentials.png" />
  </Tab>

  <Tab title="Feishu">
    Ingresa el **App ID** y el **App Secret** de Feishu Open Platform, luego haz clic en **Deploy**.

    El script realizará automáticamente:

    1. Crear el archivo de configuración de OpenClaw
    2. Escribir la configuración del modelo y la clave API
    3. Configurar el plugin de Feishu (escribir App ID / App Secret) y habilitarlo
    4. Instalar e iniciar el servicio de gateway

           <img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/wizard-step2-credentials.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=5d3fcb5c76c0aa9b3da645d3e6966c51" alt="Credenciales de Feishu" width="2549" height="1242" data-path="images/OpenClaw-Auto/wizard-step2-credentials.png" />
  </Tab>
</Tabs>

Espera a que la barra de progreso se complete, luego avanzarás al siguiente paso automáticamente.

### 2.3 — Conectar

<Tabs>
  <Tab title="Telegram">
    Ingresa tu **Telegram User ID** (el ID numérico de @userinfobot), luego haz clic en **Connect**.

    El script escribe este ID en la configuración de `allowedUsers` — solo este usuario podrá chatear con el Bot. Una vez conectado, serás redirigido a la página principal.

    <img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/wizard-step3-telegram-connect.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=71d596d8d4f0cf68708c0baf301636e5" alt="Conectar Telegram" width="2549" height="1242" data-path="images/OpenClaw-Auto/wizard-step3-telegram-connect.png" />
  </Tab>

  <Tab title="Feishu">
    El despliegue está completo. Ahora regresa a Feishu Open Platform para configurar la suscripción de eventos.

    <Warning>
      Antes de configurar la suscripción de eventos, asegúrate de que lo siguiente esté hecho:

      * La configuración del canal de Feishu está completa (ver despliegue del Paso 2)
      * El gateway está en ejecución (verifica con `openclaw gateway status`)
    </Warning>

    En la página de **Event Subscription**:

    1. Selecciona **Use long connection to receive events** (modo WebSocket)
    2. Agrega el evento: `im.message.receive_v1` (recibir mensajes)

    <Warning>
      Si el gateway no está iniciado o el canal no ha sido agregado, la configuración de conexión larga no se guardará.
    </Warning>

    <img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/event-subscription.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=9cbb8f9f6d35b90981908f1bcd70b8ad" alt="Suscripción de eventos" width="1650" height="851" data-path="images/OpenClaw-Feishu/event-subscription.avif" />

    3. En "Version Management & Release", crea una versión y envíala para revisión

    <Note>
      Las apps de Feishu requieren aprobación del administrador antes de poder usarse. Las apps empresariales personalizadas generalmente se aprueban automáticamente.
    </Note>

    Haz clic en **Done** — el script reiniciará el gateway para establecer la conexión WebSocket de Feishu. Después de ser redirigido a la página principal, puedes comenzar a enviar mensajes al Bot en Feishu.

    <img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/wizard-step3-feishu-connect.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=1e51d0bdfb70b1e821e970f4f3df2333" alt="Conectar Feishu" width="2549" height="1242" data-path="images/OpenClaw-Auto/wizard-step3-feishu-connect.png" />
  </Tab>
</Tabs>

## Gestionar Instancias

Después del despliegue, la página principal muestra todas las instancias:

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Auto/home-instance-running.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=12a02a962c377d7e6f4c6c730090df89" alt="Gestión de instancias" width="2549" height="1242" data-path="images/OpenClaw-Auto/home-instance-running.png" />

| Estado   | Descripción          |
| -------- | -------------------- |
| 🟢 Verde | Gateway en ejecución |
| 🔴 Rojo  | Gateway detenido     |

Cada tarjeta de instancia muestra el modelo y el canal en uso. Acciones disponibles:

* **Iniciar / Detener**: Iniciar o detener el servicio de gateway
* **Eliminar**: Eliminar la instancia (detiene el gateway y limpia todos los archivos de configuración)

Haz clic en **+ New Instance** para crear múltiples instancias, cada una ejecutándose de forma independiente en un puerto diferente.
