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

# OpenClaw + Telegram

> Conectar OpenClaw a EvoLink.AI

## Descripción general

OpenClaw es un Gateway de agentes de IA de código abierto que actúa como puente entre aplicaciones de chat y agentes de IA. A través de un proceso centralizado de Gateway, conecta plataformas de chat como Telegram, WhatsApp y Discord con agentes de programación de IA, permitiendo interacciones directas de programación con IA dentro de las ventanas de chat.

Al configurar **EvoLink API** como proveedor de modelos personalizado en OpenClaw y conectar un **Telegram Bot**, puedes usar los modelos Claude de EvoLink (como **Claude 4.6 Opus**, **Claude 4.5 Sonnet**, **Claude 4.5 Haiku**) para conversaciones de programación asistida por IA directamente en Telegram.

**Esta guía cubre:**

* Instalación y configuración de OpenClaw Gateway
* Creación de un Telegram Bot y conexión con OpenClaw
* Configuración de EvoLink API como proveedor de modelos personalizado
* Verificación de la conexión y primeros pasos

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

Antes de configurar, asegúrate de tener:

### 1. Instalar Node.js

OpenClaw se instala a través de npm y 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 ejecuta el programa de instalación.

    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.
    </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 ejecuta el programa de instalación.

    **Método 2: Usar Homebrew**

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

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

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

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

### 2. Obtener la clave API de EvoLink

* Inicia sesión en el [Panel de EvoLink](https://evolink.ai/dashboard)
* Busca API Keys en el panel, haz clic en el botón 'Create New Key' y luego copia la clave generada
* La clave API generalmente comienza con `sk-`

### 3. Preparar una cuenta de Telegram

La necesitarás para crear un Bot y probar la integración.

## Paso 1: Instalar OpenClaw

Ejecuta el siguiente comando en tu terminal:

```bash theme={null}
npm install -g openclaw@latest
```

## Paso 2: Configuración inicial

Ejecuta el comando de configuración inicial. OpenClaw te guiará a través de la configuración inicial e instalará el servicio daemon en segundo plano:

```bash theme={null}
openclaw onboard --install-daemon
```

### 1. Confirmar instalación

El sistema mostrará un aviso de riesgos. Confirma para continuar:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=fce0ba49fe04129dc943e6f63353595e" alt="Confirm Installation" width="1488" height="1420" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png" />

### 2. Seleccionar modo de instalación

Cuando se te pida elegir un modo de instalación, selecciona **Quickstart**:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=24fbf84b590649d1fc1d515d2ee50609" alt="Select Quickstart" width="1738" height="1540" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png" />

### 3. Seleccionar proveedor

Cuando se te pida elegir un proveedor de modelos, selecciona **Skip**. Configuraremos manualmente EvoLink como proveedor personalizado más adelante:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=a4f74b3bb72312ba426ea37179232576" alt="Skip Provider Selection" width="1398" height="1272" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png" />

### 4. Seleccionar modelos

Cuando se te pida elegir qué modelos habilitar, selecciona **All**:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=701f58ca7164b7830cef3bfb713d911b" alt="Select All Models" width="1380" height="1528" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png" />

### 5. Seleccionar modelo predeterminado

Cuando se te pida elegir un modelo predeterminado, selecciona **Keep current**:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=5ded0a9c44fd991865dbe84195862563" alt="Keep Current Model" width="1334" height="1792" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png" />

## Paso 3: Crear Telegram Bot

El flujo de configuración inicial te pedirá seleccionar un canal de chat. Selecciona **Telegram (Bot API)**.

### 1. Visitar BotFather

Abre Telegram y visita [@BotFather](https://t.me/BotFather), luego haz clic en **START BOT** para comenzar:

<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="Start BotFather" width="652" height="638" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_023944_999.png" />

### 2. Crear Bot

Escribe `/start` en el chat. BotFather responderá con una lista de comandos disponibles:

<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="Type /start" width="1798" height="1794" data-path="images/OpenClaw-Telegram/85be2352-3788-4d21-815e-6a46b2754ca7.png" />

Escribe `/newbot`. Sigue las instrucciones para establecer un **nombre de usuario del Bot** único que debe terminar en `bot` (por ejemplo, `my_evolink_bot`).

Una vez creado, BotFather devolverá un mensaje que contiene un **Token** en este formato:

```
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
```

Copia y guarda este Token.

### 3. Introducir Token

Vuelve al flujo de configuración inicial en la terminal, pega el Token del Bot en el campo y confirma:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_015805_685.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=235c62263e926bd698f3497f059da6cd" alt="Enter Token" width="1556" height="1758" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_015805_685.png" />

### 4. Reiniciar Gateway

Después de introducir el Token, reinicia el Gateway para aplicar la configuración:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/510f6a5a-8d41-41f7-9277-35486140cb78.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=8e73a3402f695359d1a3008f7d884854" alt="Restart Gateway" width="1382" height="1304" data-path="images/OpenClaw-Telegram/510f6a5a-8d41-41f7-9277-35486140cb78.png" />

## Paso 4: Configurar EvoLink API

### 1. Localizar archivo de configuración

Localiza el archivo de configuración `openclaw.json` en el directorio de instalación de OpenClaw y ábrelo para editarlo:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ed6bc6af-f91c-4739-9e87-8710510d978b.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=34387862e93b16404ffbe19ea0ec5ea2" alt="Locate Config File" width="582" height="438" data-path="images/OpenClaw-Telegram/ed6bc6af-f91c-4739-9e87-8710510d978b.png" />

### 2. Configurar proveedor de modelos

En `openclaw.json`, busca el campo `models` y añade EvoLink como proveedor de modelos personalizado:

```json theme={null}
"models": {
  "providers": {
    "evolink-anthropic": {
      "api": "anthropic-messages",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "claude-fable-5", "name": "Claude Fable 5" },
        { "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
        { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
        { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
        { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
        { "id": "claude-sonnet-5", "name": "Claude Sonnet 5" },
        { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
        { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
        { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
      ]
    },
    "evolink-google": {
      "api": "google-generative-ai",
      "baseUrl": "https://direct.evolink.ai/v1beta",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
        { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
      ]
    },
    "evolink-openai": {
      "api": "openai-completions",
      "baseUrl": "https://direct.evolink.ai/v1",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gpt-5.4", "name": "GPT-5.4" },
        { "id": "gpt-5.2", "name": "GPT-5.2" },
        { "id": "gpt-5.1", "name": "GPT-5.1" },
        { "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
        { "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
        { "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
        { "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
        { "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
        { "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
        { "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
        { "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
      ]
    }
  }
}
```

<Warning>
  Reemplaza `"your-evolink-api-key"` con la clave API real de tu [Panel de EvoLink](https://evolink.ai/dashboard).
</Warning>

<img src="https://mintcdn.com/muyutechnology/UXWm3z0MosVoxl9R/images/OpenClaw-Telegram/b362e8be-3a83-47ea-b84c-5fcfb5658e7f.png?fit=max&auto=format&n=UXWm3z0MosVoxl9R&q=85&s=fff12fc55f7b8c56ff4d21189d305ffb" alt="Configure Model" width="823" height="571" data-path="images/OpenClaw-Telegram/b362e8be-3a83-47ea-b84c-5fcfb5658e7f.png" />

### 3. Configurar modelo predeterminado

En el campo `agents`, establece `model.primary` con el modelo de EvoLink que acabas de añadir:

```json theme={null}
"model": {
  "primary": "evolink-anthropic/claude-opus-4-6"
}
```

<img src="https://mintcdn.com/muyutechnology/vltN_QIDGKI6Yi2Q/images/OpenClaw-Telegram/78216831-b8da-43c3-b507-f13bba880504.png?fit=max&auto=format&n=vltN_QIDGKI6Yi2Q&q=85&s=588ceb46be9278f00bc95432fcce503d" alt="Configure Default Model" width="1010" height="582" data-path="images/OpenClaw-Telegram/78216831-b8da-43c3-b507-f13bba880504.png" />

### 4. Verificar configuración de Telegram

Verifica la configuración de Telegram en el campo `channels`. El `botToken` se completó automáticamente durante el flujo de configuración inicial y no necesita ser modificado:

```json theme={null}
"channels": {
  "telegram": {
    "enabled": true,
    "botToken": "your-bot-token (auto-filled)",
    "dmPolicy": "pairing",
    "groups": { "*": { "requireMention": true } }
  }
}
```

* `enabled`: Habilitar el canal de Telegram
* `dmPolicy`: Establecido en `"pairing"`, los usuarios no autorizados deben verificarse mediante código de emparejamiento al enviar mensajes directos
* `groups`: `"*"` permite todos los grupos, `requireMention` establecido en `true` significa que el Bot solo responde cuando se le menciona con @ en los grupos

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/0bde6676-6a12-4073-ba74-e2b60986e8c3.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=bb28d72954c216850a5556a7be7e65a2" alt="Telegram Configuration" width="1190" height="334" data-path="images/OpenClaw-Telegram/0bde6676-6a12-4073-ba74-e2b60986e8c3.png" />

## Paso 5: Verificar conexión

### 1. Visitar tu Bot

Busca el nombre de usuario del Bot que acabas de crear en Telegram y abre el chat:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/TelegramOpenBot.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=085f0c8e0eaac4a216a0a9999a5f96f2" alt="Visit Bot" width="1644" height="790" data-path="images/OpenClaw-Telegram/TelegramOpenBot.png" />

### 2. Obtener código de emparejamiento

Envía `/start` al Bot. Devolverá un código de emparejamiento:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/TelegramOpenBot2.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=9241dae6649b8baf3118638f6975ea51" alt="Get Pairing Code" width="1040" height="608" data-path="images/OpenClaw-Telegram/TelegramOpenBot2.png" />

### 3. Completar emparejamiento

Abre una **nueva ventana de terminal** y ejecuta el siguiente comando para completar el emparejamiento:

```bash theme={null}
openclaw pairing approve telegram <pairing-code>
```

<Warning>
  Reemplaza `<pairing-code>` con el código real devuelto por el Bot. Asegúrate de eliminar los corchetes angulares `<>`.
</Warning>

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_021312_775.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=7ace56164fe3f81ed973e60e471343e0" alt="Complete Pairing" width="1988" height="274" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_021312_775.png" />

### 4. Probar conexión

Vuelve a la ventana de terminal original y escribe lo siguiente para probar si la conexión funciona:

```
Wake up, my friend!
```

<img src="https://mintcdn.com/muyutechnology/vltN_QIDGKI6Yi2Q/images/OpenClaw-Telegram/ScreenShot_2026-02-08_020627_904.png?fit=max&auto=format&n=vltN_QIDGKI6Yi2Q&q=85&s=cd3be1b55d8d636ed0e8fbab04ec3da2" alt="Test Connection" width="6336" height="2688" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_020627_904.png" />

Una vez completado el emparejamiento, enviar mensajes al Bot en Telegram también recibirá respuestas de IA, confirmando que la integración fue exitosa.
