Configuración detallada de OpenClaw en Windows: Crea tu asistente de IA para Feishu

Introducción

OpenClaw es un sistema de puerta de enlace de IA multiplataforma que permite ejecutar un asistente de IA en múltiples canales, como Feishu (Lark). Esta guía proporciona un proceso paso a paso para implementarlo en un sistema Windows, desde la preparación del entorno hasta la integración completa con Feishu.

  1. Preparación del entorno y dependencias

1.1 Requisitos del sistema

  • Sistema operativo: Windows 10 (versión 21H2 o posterior) o Windows 11 (64 bits)
  • Hardware: Mínimo 4 GB de RAM (recomendado 8 GB o más), al menos 1 GB de espacio libre en disco.
  • Red: Conexión a Internet estable.
  • Permisos: Permisos de administrador para la instalación.

Nota: Para entornos con datos sensibles, se recomienda utilizar una máquina virtual o un dispositivo dedicado.

1.2 Instalación de Node.js

OpenClaw requiere Node.js v22.0.0 o una versión posterior.

  1. Descargue el instalador LTS (.msi) desde el sitio oficial de Node.js.
  2. Ejecute el instalador y siga las instrucciones predeterminadas.
  3. Verifique la instalación en PowerShell (como administrador):
node --version
npm --version

Se debe mostrar la versión de Node.js (≥22.12.0) y npm.

1.3 Instalación de Git (recomendado)

  1. Descargue e instale Git para Windows desde su sitio web oficial.
  2. Verifique la instalación:
git --version

1.4 Configuración de la directiva de ejecución de PowerShell

Abra PowerShell como administrador y ejecute:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Confirme con Y y presione Enter.

1.5 Solución de problemas de codificación (opcional)

Si aparecen caracteres ilegibles, ejecute:

$OutputEncoding = [Console]::InputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
chcp 65001
  1. Instalación de OpenClaw

2.1 Configurar un espejo npm nacional (recomendado para usuarios en China)

npm config set registry https://registry.npmmirror.com

2.2 Ejecutar la instalación

En una ventana de PowerShell de administrador, ejecute el siguiente script de instalación:

iwr -useb https://openclaw.ai/install.ps1 | iex

Espere a que el proceso termine sin cerrar la ventana.

2.3 Verificar la instalación

openclaw --version

La aparición de la versión confirma una instalación exitosa.

  1. Configuración inicial de OpenClaw

El script de instalación inicia un asistente de configuración. Si se interrumpe, reinícielo con:

openclaw onboard --flow quickstart

Siga las indicaciones en la terminal (use las flechas ↑↓ y Enter para seleccionar).

  1. Acuerdo de privacidad: Seleccione Yes.

  2. Modo de configuración: Elija QuickStart.

  3. Configuración del gateway: Acepte los valores predeterminados (Puerto: 18789, Vinculación: Loopback).

  4. Plataforma de IA:

    • Modelo gratuito (ej. Qwen): Seleccione qwen-portal/coder-model y siga las instrucciones para autorizar en el navegador.
    • API Key personal: Elija el proveedor correspondiente (Kimi, OpenAI, etc.) e ingrese la clave.
    • Modelo local: Configure Custom Provider con la dirección local (ej. Ollama).

  5. Canales de comunicación: Seleccione Feishu/Lark. Saltar la solicitud del App ID y Secret por ahora.

  6. Otras opciones: Omita la configuración de skills y hooks por el momento. Finalmente, seleccione Open the Web UI para abrir la consola web en http://127.0.0.1:18789/.

  7. Configuración completa del robot en Feishu

4.1 Crear una aplicación en la plataforma abierta de Feishu

  1. Vaya a la Plataforma Abierta de Feishu y cree una "Aplicación empresarial de autoconstrucción".
  2. Complete la información básica (nombre, descripción, icono) y confirme la creación.

4.2 Obtener App ID y App Secret

En la página de detalles de la aplicación, vaya a "Credenciales e información básica" y copie el App ID y el App Secret. Guárdelos de forma segura.

4.3 Agregar la capacidad de bot

Navegue a "Agregar capacidades de la aplicación" y agregue la capacidad de "Bot".

4.4 Instalar y configurar el plugin de Feishu en OpenClaw

En PowerShell, ejecute:

openclaw plugins install @m1heng-clawd/feishu

Complete la configuración interactiva:

  1. App ID: Pegue el ID copiado.
  2. App Secret: Pegue el secreto copiado.
  3. Connection mode: Seleccione WebSocket (default).
  4. Region: Seleccione China.

4.5 Importar permisos de aplicación

En la plataforma de Feishu, bajo "Gestión de permisos", use "Importación por lotes" para añadir el siguiente JSON:

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

Importe, revise y solicite la activación de los permisos.

4.6 Configurar la suscripción a eventos

  1. Vaya a "Eventos y devoluciones de llamada".
  2. Seleccione Usar conexión de larga duración para recibir eventos (WebSocket).
  3. Añada el evento im.message.receive_v1 (recibir mensajes).

4.7 Publicar y verificar la aplicación

  1. Cree y publique una nueva versión de la aplicación en "Gestión de versiones".

  2. Espere a que la revisión de Feishu se apruebe.

  3. Inicie una conversación con el bot en Feishu y envíe un mensaje.

  4. El bot responderá con un código de emparejamiento (ej. openclaw pairing approve feishu XXXX).

  5. Pegue el código completo en la terminal de PowerShell donde se ejecuta OpenClaw para completar el vínculo.

  6. Módulos funcionales clave

  • Chat (Mensajería): Interfaz principal para conversaciones con la IA, con soporte multi-modal y multi-sesión.
  • Cron (Tareas Programadas): Para automatizar recordatorios, monitoreo, copias de seguridad y reportes periódicos.
  • Agents (Agentes): Permite crear múltiples agentes especializados con roles, modelos y espacios de trabajo independientes.
  • Browser Relay (Relé del Navegador): Una extensión de Chrome que permite la interacción directa entre OpenClaw y el navegador.
  1. Comandos de administración comunes
Comando Descripción Uso típico
openclaw gateway run Inicia el gateway en primer plano con logs Depuración y pruebas
openclaw gateway start Inicia el servicio de gateway en segundo plano Uso continuo
openclaw gateway stop Detiene el servicio de gateway Detener el servicio
openclaw configure Reinicia el asistente de configuración Cambiar modelos o claves API
openclaw doctor Ejecuta el diagnóstico de configuración Identificar problemas comunes
openclaw logs follow Muestra los logs en tiempo real Rastrear errores
openclaw status Muestra el estado del servicio Verificar que el gateway está activo
openclaw dashboard Abre la consola web de gestión Acceso rápido al panel de control
  1. Solución de problemas frecuentes

7.1 Errores de instalación

P: "No se puede cargar el archivo porque la ejecución de scripts está deshabilitada en este sistema".
R: Ejecute PowerShell como administrador y establezca la directiva de ejecución: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

7.2 Problemas con el modelo de IA

P: La conversación no responde o da error tras configurar la API Key.
R: Verifique que la API Key sea correcta, que no haya problemas de red (especialmente con proveedores internacionales) y que no se haya excedido la cuota de uso. Utilice openclaw configure para reconfigurarla.

7.3 Problemas de integración con Feishu

P: El bot no recibe los mensajes enviados.
R: Verfiique en orden: 1) Que la aplicación esté publicada. 2) Que el evento im.message.receive_v1 esté suscrito. 3) Que el método de recepción sea "Conexión de larga duración" (WebSocket). 4) Que el permiso im:message esté aprobado. 5) Que el gateway de OpenClaw esté en ejecución (openclaw gateway status).

P: Error de permisos al enviar mensajes.
R: Asegúrese de que el permiso im:message:send_as_bot esté activado en la configuración de la aplicación.

P: El App Secret se ha comprometido.
R: Regenree inmediatamente el App Secret en la plataforma de Feishu y actualice la configuración de OpenClaw.

  1. Mantenimiento tras reiniciar el equipo

El servicio de gateway de OpenClaw suele iniciarse automáticamente mediante tareas programadas de Windows. Si es necesario iniciarlo manualmente, ejecute:

openclaw gateway

O directamente el script generado durante la instalación, ubicado típicamente en C:\Users\TuUsuario\.openclaw\gateway.cmd.

Etiquetas: OpenClaw Feishu Windows Node.js AI-Gateway

Publicado el 6-28 04:05

Etiquetas populares

©2026 Friki Work