Skills

Usa wecom-cli en el terminal para comprobar la autorización de WeCom antes de empezar el trabajo de oficina

Para quien quiera operar documentos, todos o calendario de WeCom desde el terminal — Node.js >= 18 y una cuenta WeCom, instala primero el CLI y luego el Skill obligatorio.

Official source · wecom-cli

Install

npx skills add WeComTeam/wecom-cli -y -g

Para quién

Usa esta skill cuando quieras operar WeCom desde el terminal — mensajes, correo, documentos, todos, calendario, reuniones, WeDrive o contactos — y quieras que humanos y un AI Agent compartan la misma línea de comandos. No es otra consola web; lleva la capacidad de la plataforma abierta al terminal para subir la eficiencia de oficina. Repositorio oficial:

https://github.com/wecomteam/wecom-cli

Las precondiciones son explícitas: esta máquina necesita Node.js >= 18 y una cuenta WeCom; plataformas limitadas a macOS (x64/arm64), Linux (x64/arm64) y Windows (x64). Sin cuenta, si la versión es baja o estás fuera de esas plataformas, no instales aún. Quien solo quiera pulsar WeCom en el navegador y no deje un comando global aquí no debe empezar por aquí.

La fuente parte la instalación del CLI y la del CLI Skill en dos pasos y escribe que el Skill es obligatorio. Primero la línea de comandos, luego que el Agent aprenda a llamarla. No inventes un instalador que nunca apareció ni añadas un directorio de skill no nombrado. La fuente no escribe «humanos y AI Agent» como exclusividad de unos productos; no estreches tú los clientes nombrados.

Completa el primer intento en 3 minutos

Confirma primero tres cosas: Node.js es 18 o más; tienes cuenta WeCom; el sistema actual está entre las plataformas de arriba. Abre la página oficial y comprueba:

https://github.com/wecomteam/wecom-cli

El camino principal: instala primero el CLI, luego el CLI Skill obligatorio. Instalar el paquete cambia los comandos globales de esta máquina; antes de ejecutar, confirma que quieres dejar @wecom/cli aquí:

npm install -g @wecom/cli

Después ejecuta la instalación de Skill que da la fuente (marcada como obligatoria):

npx skills add WeComTeam/wecom-cli -y -g

No partas estos dos pasos en dos caminos principales paralelos ni cambies los parámetros. La fuente no escribe el directorio de aterrizaje de la skill; no inventes una ruta.

La primera vez en un Agent, solo comprueba; no crees documentos, no envíes correo ni cambies el calendario. Si aún no hay credenciales, la configuración es un efecto secundario: escaneo QR por defecto, o --manual para teclear. Antes de ejecutar, confirma que es tu propia cuenta WeCom y que vas a terminar esta interacción:

wecom-cli auth init

Tras configurar, inspecciona la autorización con un comando de solo lectura:

wecom-cli auth show

Señal de éxito: el comando termina normal y ves el estado de autorización actual. La fuente no da nombres de campo de show; no inventes un formato de salida. La primera vez, no hagas notificaciones de bot, escritura de documentos, reserva de reuniones ni subidas a WeDrive. Si el Agent solo recita «primero init, luego show» y no ha corrido show de verdad, no trates la autorización como ya exitosa.

Casos de uso

Caso 1: Solo comprobar autorización. Tras CLI y Skill obligatorio, ejecuta wecom-cli auth show en el terminal o en un Agent que pueda llamar los mismos comandos. Inspecciona el estado de autorización, para confirmar que las credenciales siguen. Antes de ejecutar, confirma que no cambiarás la configuración de paso; la señal de éxito es ver el estado de autorización. La fuente no escribe un código de salida para no autorizado; si falla, para, no inventes un comando de reparación. No amplíes esta comprobación a enviar correo o leer contactos; esas acciones no tienen redacción de comando correspondiente.

Caso 2: Configurar credenciales la primera vez. La fuente escribe que configurar credenciales es interactivo y solo hace falta una vez, escaneo QR por defecto, --manual para teclear. El comando es wecom-cli auth init. Antes de ejecutar, confirma que quieres dejar credenciales WeCom en esta máquina y que estás listo para escanear o teclear. Tras configurar, corre wecom-cli auth show para comprobar. La fuente no escribe revocación ni cierre de sesión; no inventes un paso para desinstalar credenciales. Las capacidades de negocio — mensajes, documentos, todos, calendario, reuniones, WeDrive, correo, contactos — solo están escritas como nombres de capacidad, por ejemplo crear y leer documentos, búsqueda de documentos, crear y gestionar calendario, reservar y obtener info de reuniones, crear y seguir todos, subir y obtener archivos WeDrive, enviar y obtener correo, obtener miembros de contactos, y notificaciones iniciadas por bot; cuando necesites esas operaciones, vuelve primero al repositorio oficial, no inventes comandos.

Límites de uso

Plataforma, runtime y exigencia de cuenta siguen la fuente: macOS (x64/arm64), Linux (x64/arm64) y Windows (x64), Node.js >= 18, y una cuenta WeCom. Humanos y un AI Agent pueden operar en el terminal, pero la fuente no nombra un producto Agent concreto; no escribas unos pocos clientes como exclusivos.

El orden de instalación es npm install -g @wecom/cli, luego el npx skills add WeComTeam/wecom-cli -y -g obligatorio. No inventes un segundo marketplace ni una variante skills add no escrita. No leas «Skill obligatorio» como permiso para saltarte el CLI; ambos pasos deben terminar en el orden de la fuente.

La configuración de credenciales escribe en esta máquina, escaneo QR por defecto, --manual disponible. La fuente no escribe la ruta del archivo, la política de caducidad ni cómo revocar. La cobertura de negocio incluye mensajes, correo, documentos, todos, calendario, reuniones, WeDrive, contactos, incluidas notificaciones de bot, búsqueda de documentos, reserva de reuniones, subida a WeDrive, pero la evidencia se detiene en la descripción de capacidad y no da la redacción de esos subcomandos; no completes parámetros, ámbitos de permiso ni facturación no escritos. La primera vez, solo verifica autorización; no trates acciones de oficina sin comando como pasos ya copiables. No inventes caminos de desinstalación o actualización que la evidencia nunca escribió.