Cómo Usar OpenClaw con WeChat Gratis

TL;DR: Conecte OpenClaw a WeChat instalando el plugin @tencent-weixin/openclaw-weixin, escanee un código QR para autorizar su cuenta y reinicie la pasarela. Todo el proceso toma menos de 5 minutos. El plugin es gratuito, open source y soporta múltiples cuentas de WeChat simultáneamente.

Prueba Apidog hoy

Introducción

Integrar un asistente de IA en WeChat suele ser complicado: muchas soluciones requieren suscripciones pagas, servidores complejos o cuentas empresariales. OpenClaw simplifica completamente este proceso.

El plugin @tencent-weixin/openclaw-weixin conecta tu cuenta personal de WeChat a OpenClaw en minutos. No necesitas cuenta empresarial ni pagos mensuales. Solo escanea un QR y queda listo.

En esta guía aprenderás a instalar el plugin, autorizar tu cuenta, gestionar varias cuentas y aislar contextos de conversación en OpenClaw con WeChat.

💡Si tu bot de WeChat necesita consumir APIs externas (clima, pagos, CRM), requiere una herramienta de prueba de APIs. Usa Apidog Free para diseñar, probar y documentar tus APIs antes de integrarlas con tu bot.

Prerrequisitos

Necesitas tener:

• OpenClaw instalado (versión >=2026.3.22 para el plugin v2.0.x)
• CLI openclaw disponible en tu terminal
• Cuenta de WeChat (personal, no se requiere empresa)
• Node.js (para la instalación con un solo clic)

Comprueba tu versión de OpenClaw:

openclaw --version

Si tu versión es anterior, actualiza antes de continuar. El plugin v2.0.x requiere OpenClaw >=2026.3.22.

Compatibilidad del plugin

Versión del Plugin	Versión de OpenClaw	Estado
2.0.x	>=2026.3.22	Activo
1.0.x	>=2026.1.0 <2026.3.22	Mantenimiento

Si la versión de OpenClaw no es compatible, el plugin no se cargará.

Paso 1: Instale el plugin

Opción A: Instalación con un solo clic (Recomendado)

npx -y @tencent-weixin/openclaw-weixin-cli install

Esto instala, configura y prepara el plugin automáticamente.

Opción B: Instalación manual

Si la opción anterior falla, instala manualmente:

1. Instala el plugin:

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. Habilita el plugin:

openclaw config set plugins.entries.openclaw-weixin.enabled true

Paso 2: Escanea el código QR para autorizar WeChat

Inicia sesión con tu cuenta personal de WeChat:

openclaw channels login --channel openclaw-weixin

Se mostrará un código QR en la terminal. Ábrelo con WeChat en tu móvil, escanea y autoriza.

Las credenciales se guardan localmente. Solo será necesario volver a escanear si cierras sesión.

Paso 3: Reinicia la pasarela

Reinicia la pasarela de OpenClaw para activar el plugin:

openclaw gateway restart

¡Listo! Tu WeChat está ahora conectado a OpenClaw. Los mensajes se procesarán por el agente de IA.

Paso 4: Agrega varias cuentas de WeChat (Opcional)

Para agregar otra cuenta, ejecuta nuevamente el comando de login:

openclaw channels login --channel openclaw-weixin

Cada escaneo crea una nueva cuenta conectada, todas funcionan en paralelo.

Paso 5: Aísla los contextos de conversación (Opcional)

Por defecto, las conversaciones de todos los canales comparten el mismo contexto de IA. Para aislar el contexto por cuenta y contacto:

openclaw config set agents.mode per-channel-per-peer

Así, cada cuenta/contacto mantiene su propia memoria de IA sin mezclar conversaciones.

Cómo funciona el plugin internamente

Si quieres extender o integrar el plugin, estos son los detalles técnicos clave.

Encabezados de autenticación

Las peticiones HTTP usan estos encabezados:

Encabezado	Valor
Content-Type	application/json
AuthorizationType	ilink_bot_token
Authorization	Bearer <token>
X-WECHAT-UIN	uint32 aleatorio codificado en base64

Puntos finales clave de la API

El plugin expone estos endpoints:

Punto final	Ruta	Propósito
getUpdates	getupdates	Long-poll de mensajes nuevos
sendMessage	sendmessage	Enviar texto/imagen/video/archivo
getUploadUrl	getuploadurl	Obtener URL de carga CDN para medios
getConfig	getconfig	Obtener configuración de cuenta
sendTyping	sendtyping	Mostrar/ocultar indicador de escritura

Recepción de mensajes (Long Polling)

Ejemplo de request y response:

// Solicitud
{
  "get_updates_buf": ""
}

// Respuesta
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

Reutiliza get_updates_buf para obtener solo mensajes nuevos en cada request.

Envío de mensajes

{
  "msg": {
    "to_user_id": "<target_user_id>",
    "context_token": "<session_context_token>",
    "item_list": [
      {
        "type": 1,
        "text_item": { "text": "¡Hola!" }
      }
    ]
  }
}

Tipos de mensajes

Tipo	Valor
TEXTO	1
IMAGEN	2
VOZ	3
ARCHIVO	4
VIDEO	5

Carga de medios (Imágenes, Archivos, Videos)

Flujo de carga:

1. Llama a getUploadUrl con metadatos (tamaño, MD5)
2. Recibe parámetros de carga pre-firmados
3. Cifra el archivo AES-128-ECB
4. Sube a CDN con la URL
5. Referencia el CDN en sendMessage

Problemas comunes y soluciones

El plugin se niega a cargar

Error: El plugin no inicia

Solución: Verifica la versión de OpenClaw (>=2026.3.22):

openclaw --version
# Si es necesario, actualiza OpenClaw

Código QR caducado

Error: El QR expiró

Solución: Ejecuta el login nuevamente. Los QR caducan tras ~30 segundos.

openclaw channels login --channel openclaw-weixin

Mensajes no recibidos

Error: No llegan mensajes de WeChat

Solución: Reinicia la pasarela tras iniciar sesión.

openclaw gateway restart

Múltiples cuentas mezclando contextos

Error: Respuestas de IA se mezclan entre cuentas

Solución: Activa el modo de aislamiento:

openclaw config set agents.mode per-channel-per-peer

Casos de uso en el mundo real

Asistente personal de IA

Conecta tu WeChat y permite que la IA responda mensajes cuando estés ocupado. Usa el aislamiento de contexto para respuestas personalizadas según cada contacto.

Soporte al cliente para pequeñas empresas

Ejecuta múltiples cuentas de WeChat, una por línea de negocio. Cada cuenta maneja consultas con memoria de IA aislada.

Pruebas de desarrollador

Integra la API HTTP JSON del plugin para crear extensiones o modificar el comportamiento predeterminado fácilmente.

Conclusión

Conectar OpenClaw con WeChat se logra en minutos: instala el plugin, escanea el QR, reinicia la pasarela y listo. Es gratuito, soporta múltiples cuentas, aislamiento de contexto y medios (imágenes, voz, archivos, video).

Para desarrolladores, la API HTTP JSON documentada permite integraciones personalizadas.

Puedes comenzar ahora mismo con:

npx -y @tencent-weixin/openclaw-weixin-cli install

Siguiente paso: Cuando tu bot de WeChat requiera integrarse con APIs externas (pagos, CRM, clima, etc.), prueba esas APIs primero con Apidog para garantizar respuestas correctas. Hay plan gratuito y sin necesidad de tarjeta.

Preguntas frecuentes

P: ¿Funciona con cuentas personales de WeChat?

R: Sí. El plugin funciona con cuentas personales, no es necesario tener cuenta empresarial.

P: ¿El plugin es gratuito?

R: Sí, @tencent-weixin/openclaw-weixin es open source y sin costo. Solo requiere OpenClaw.

P: ¿Puedo ejecutar varias cuentas de WeChat al mismo tiempo?

R: Sí. Ejecuta openclaw channels login --channel openclaw-weixin por cada cuenta. Todas operan en paralelo.

P: ¿Qué pasa si reinicio mi computadora?

R: Las credenciales se almacenan localmente. No necesitas volver a escanear el QR. Solo reinicia la pasarela con openclaw gateway restart.

P: ¿Puedo crear integraciones personalizadas?

R: Sí. El plugin expone una API HTTP JSON documentada con 5 endpoints: getUpdates, sendMessage, getUploadUrl, getConfig y sendTyping. Si necesitas validar APIs externas, usa Apidog para probar y validar tus integraciones antes de lanzarlas.