WeChat

OmeniaClaw se conecta a WeChat mediante el plugin de canal externo @tencent-weixin/OmeniaClaw-weixin de Tencent.

Estado: plugin externo. Los chats directos y los medios son compatibles. Los chats grupales no están anunciados por los metadatos de capacidades del plugin actual.

Nomenclatura

• WeChat es el nombre visible para el usuario en esta documentación.
• Weixin es el nombre usado por el paquete de Tencent y por el id del plugin.
• OmeniaClaw-weixin es el id de canal de OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin es el paquete npm.

Usa OmeniaClaw-weixin en comandos de CLI y rutas de configuración.

Cómo funciona

El código de WeChat no vive en el repositorio principal de OmeniaClaw. OmeniaClaw proporciona el contrato genérico de plugin de canal, y el plugin externo proporciona el entorno de ejecución específico de WeChat:

1. OmeniaClaw plugins install instala @tencent-weixin/OmeniaClaw-weixin.
2. El Gateway descubre el manifiesto del plugin y carga el punto de entrada del plugin.
3. El plugin registra el id de canal OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin inicia el inicio de sesión por QR.
5. El plugin almacena las credenciales de la cuenta en el directorio de estado de OmeniaClaw.
6. Cuando se inicia el Gateway, el plugin inicia su monitor de Weixin para cada cuenta configurada.
7. Los mensajes entrantes de WeChat se normalizan mediante el contrato de canal, se enrutan al agente de OmeniaClaw seleccionado y se devuelven mediante la ruta saliente del plugin.

Esa separación importa: el núcleo de OmeniaClaw debe seguir siendo independiente de los canales. El inicio de sesión de WeChat, las llamadas a la API iLink de Tencent, la carga/descarga de medios, los tokens de contexto y la supervisión de cuentas pertenecen al plugin externo.

Instalación

Instalación rápida:

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

Instalación manual:

OmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin"OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled true

Reinicia el Gateway después de la instalación:

OmeniaClaw gateway restart

Inicio de sesión

Ejecuta el inicio de sesión por QR en la misma máquina que ejecuta el Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

Escanea el código QR con WeChat en tu teléfono y confirma el inicio de sesión. El plugin guarda el token de la cuenta localmente tras un escaneo correcto.

Para agregar otra cuenta de WeChat, ejecuta de nuevo el mismo comando de inicio de sesión. Para varias cuentas, aísla las sesiones de mensaje directo por cuenta, canal y remitente:

OmeniaClaw config set session.dmScope per-account-channel-peer

Control de acceso

Los mensajes directos usan el modelo normal de emparejamiento y lista de permitidos de OmeniaClaw para plugins de canal.

Aprueba nuevos remitentes:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

Para ver el modelo completo de control de acceso, consulta Emparejamiento.

Compatibilidad

El plugin comprueba la versión del host de OmeniaClaw al iniciarse.

Si el plugin informa que tu versión de OmeniaClaw es demasiado antigua, actualiza OmeniaClaw o instala la línea legacy del plugin:

OmeniaClaw plugins install @tencent-weixin/OmeniaClaw-weixin@legacy

Proceso sidecar

El plugin de WeChat puede ejecutar trabajo auxiliar junto al Gateway mientras supervisa la API iLink de Tencent. En el issue #68451, esa ruta auxiliar expuso un error en la limpieza genérica de Gateway obsoleto de OmeniaClaw: un proceso hijo podía intentar limpiar el proceso Gateway padre, lo que causaba bucles de reinicio bajo gestores de procesos como systemd.

La limpieza actual de inicio de OmeniaClaw excluye el proceso actual y sus ancestros, por lo que un auxiliar de canal no debe matar el Gateway que lo inició. Esta corrección es genérica; no es una ruta específica de WeChat en el núcleo.

Solución de problemas

Comprueba la instalación y el estado:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Si el canal aparece como instalado pero no se conecta, confirma que el plugin está habilitado y reinicia:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

Si el Gateway se reinicia repetidamente después de habilitar WeChat, actualiza tanto OmeniaClaw como el plugin:

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

Si el inicio informa que el paquete de plugin instalado requires compiled runtime output for TypeScript entry, el paquete npm se publicó sin los archivos de entorno de ejecución JavaScript compilados que OmeniaClaw necesita. Actualiza/reinstala después de que el publicador del plugin publique un paquete corregido, o deshabilita/desinstala temporalmente el plugin.

Deshabilitación temporal:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

Documentación relacionada

• Resumen de canales: Canales de chat
• Emparejamiento: Emparejamiento
• Enrutamiento de canales: Enrutamiento de canales
• Arquitectura de plugins: Arquitectura de Plugin
• SDK de plugin de canal: SDK de Plugin de canal
• Paquete externo: @tencent-weixin/OmeniaClaw-weixin