Canal de Bot QQ de OpenClaw

OpenClaw se conecta a QQ Open Platform a través del plugin @openclaw-china/qqbot. Este plugin es mantenido oficialmente por Tencent y utiliza la Bot API de QQ Open Platform para gestionar el envío y recepción de mensajes. Flujo de mensajes: el usuario envía un mensaje en QQ → QQ Open Platform → push al OpenClaw Gateway → procesamiento por IA → respuesta vía QQ Bot API → mensaje entregado en QQ. Este plugin admite múltiples escenarios de mensajería: mensajes directos, chats grupales (requiere activación por @), mensajes de canal y DMs de canal, cubriendo las principales formas de interacción del ecosistema QQ.

La instalación del plugin de QQ es sencilla y se completa con un solo comando: openclaw plugins install @openclaw-china/qqbot Tras la instalación, el plugin se registra automáticamente en el OpenClaw Gateway. Puedes confirmar la instalación con 'openclaw plugins list'.

# Instalar plugin de QQ
openclaw plugins install @openclaw-china/qqbot

# Confirmar instalación
openclaw plugins list

# Actualizar plugin
openclaw plugins update @openclaw-china/qqbot

# Iniciar asistente de configuración interactivo
openclaw china setup

Para configurar la integración con QQ necesitas crear una aplicación de bot en QQ Open Platform: 1. Inicia sesión en QQ Open Platform (q.qq.com) y accede a la consola de desarrollador. 2. Haz clic en 'Crear bot' e introduce el nombre, descripción y avatar del bot. 3. Una vez creado, localiza el AppID y ClientSecret en la página de configuración de la app. 4. En la configuración de funciones, activa los tipos de mensaje necesarios (mensajes directos, chats grupales, canales, etc.). 5. Una vez completada la configuración, envíala para revisión y espera la aprobación de la plataforma.

# Mediante variables de entorno
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"

# O mediante CLI
openclaw channels add

El plugin de QQ admite una amplia variedad de tipos de mensaje: **Recepción**: texto, imágenes, audio, video, archivos **Envío**: texto, Markdown, imágenes, audio, video, archivos **Funciones destacadas**: • Voz a texto — convierte automáticamente los mensajes de voz a texto antes de pasarlos a la IA • Mensajes programados — soporte para envío de mensajes según horario • Formato Markdown — soporte para respuestas con formato • Contexto de mensaje citado — posibilidad de citar mensajes anteriores como contexto de conversación

El plugin de QQ admite la configuración independiente de tres escenarios de mensajería: **Mensajes directos (dmEnabled)**: controla la respuesta a mensajes directos. **Chat grupal (groupEnabled)**: controla la respuesta a mensajes de chat grupal. En chats grupales, se requiere @mencionar al bot para activar una respuesta, evitando respuestas excesivas en grupos activos. **Canal (channelEnabled)**: controla la respuesta a mensajes en canales QQ, incluyendo mensajes públicos de canal y DMs de canal. Cada escenario puede activarse o desactivarse de forma independiente, permitiendo un control flexible del alcance de respuesta del bot.

{
  "channels": {
    "qqbot": {
      "dmEnabled": true,
      "groupEnabled": true,
      "channelEnabled": true
    }
  }
}

OpenClaw ofrece varios comandos para gestionar tu bot de QQ: • openclaw gateway status — verificar el estado de conexión del Gateway • openclaw gateway restart — reiniciar el servicio Gateway • openclaw logs --follow — ver logs en tiempo real • openclaw channels add — añadir un canal de forma interactiva • openclaw plugins list — ver plugins instalados • openclaw plugins update @openclaw-china/qqbot — actualizar el plugin de QQ • openclaw china setup — iniciar el asistente de configuración interactivo • openclaw doctor — ejecutar diagnóstico integral