Coze en WeChat: el bot Coze (botón) en WeChat

Introducción general

Coze on WeChat es un proyecto de código abierto diseñado para ayudar a los usuarios a integrar sin problemas bots de IA de la plataforma Coze en WeChat. Se basa en chatgpt-on-wechat y dify-on-wechat, y admite chat de texto, reconocimiento de voz y respuesta, funcionalidad de plug-in y envío de imágenes y enlaces. El proyecto utiliza el protocolo iPad de Gewechat para entrar en WeChat, más estable que el itchat tradicional. Los usuarios tienen que crear bots en la plataforma Coze y, mediante una sencilla configuración, pueden lograr una interacción inteligente en WeChat. El proyecto ofrece una interfaz de gestión basada en web para ajustar fácilmente la configuración. Desde marzo de 2025, los desarrolladores lo siguen en GitHub y es adecuado para que personas o equipos creen asistentes inteligentes para WeChat.

Configuración COZE

Configuración de Coze en WeChat Backend

Lista de funciones

• chat de textoEl bot recuerda el contexto de la conversación para ofrecer respuestas coherentes.
• interacción por vozReconoce la entrada de voz en 20 segundos y admite respuestas de voz.
• Soporte para plug-ins: Funcionalidad del plugin Docking Coze para convertir las tarjetas del plugin en enlaces WeChat.
• entrega multimedia: La posibilidad de enviar imágenes, enlaces y otros contenidos para mejorar la experiencia interactiva.
• Interfaz de gestión webAjuste los parámetros del robot a través de la página web sin modificar el código.
• función de base de conocimientosCarga archivos o contenido web y deja que el robot responda a las preguntas basándose en esos datos.

Utilizar la ayuda

Proceso de instalación

Para utilizar Coze en WeChat es necesario preparar el entorno y completar la implantación. A continuación se detallan los pasos a seguir:

1. Trabajos preparatorios

• Registrarse en CozeVisita el sitio web de Coze, regístrate e inicia sesión. Haz clic en "Crear robot" para configurar tu robot.
• Obtener la clave APIEn la página "Personal Access Token" de Coze (enlace (en un sitio web)) Genera el token y guárdalo.
• herramienta de montajeAsegúrese de que su ordenador o servidor tiene Git y Docker instalados; Git para descargar código y Docker para ejecutar servicios.
• Seleccionar método de implantaciónSoporta ejecución local, ejecución en servidor y despliegue en Docker, sólo tiene que elegir uno.

2. Descargar el proyecto

Introdúzcalo en un terminal o en la línea de comandos:

git clone https://github.com/JC0v0/Coze-on-Wechat
cd Coze-on-Wechat

Esto descargará el código del proyecto e irá al directorio.

3. Entorno de configuración

Implantación local o en servidor

• Creación de un entorno virtual(Opcional pero recomendado):
  • Utiliza venv:

    python3 -m venv Coze-on-Wechat
    source Coze-on-Wechat/bin/activate  # Windows 用 Coze-on-Wechat\Scripts\activate
    

  • Utiliza conda:

    conda create -n Coze-on-Wechat python=3.12
    conda activate Coze-on-Wechat
    

• Instalación de dependencias::

pip3 install -r requirements.txt

• Configurar config.json::

cp config.json.example config.json

Abrir con un editor de texto config.jsonRellene los siguientes campos:

{
"coze_api_base": "https://api.coze.cn",
"coze_api_key": "你的API密钥",
"coze_bot_id": "你的机器人ID",  // 从 Coze 开发页面 URL 获取
"channel_type": "gewechat",
"model": "coze",
"single_chat_prefix": ["bot", "@bot"],  // 私聊触发词
"group_chat_prefix": ["@bot"],          // 群聊触发词
"group_name_white_list": ["ALL_GROUP"]  // 允许机器人回复的群
}

Despliegue de Docker

• Tirar de los espejos Gewechat::

docker pull registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine
docker tag registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine gewe

• Crear un catálogo de datos::

mkdir -p gewechat/data

• Copia de archivos de configuración::

cp config-template.json config.json

• Inicio de los servicios::

docker-compose up -d

4. Activación e inicio de sesión

• funcionamiento local::

python3 app.py

• funcionamiento del servidor::

nohup python3 app.py & tail -f nohup.out

• Funcionamiento de la interfaz web::

cd web
streamlit run Home.py

entrevistas http://localhost:8501La configuración se realiza en la página web.

• Despliegue de Docker: Compruebe el registro tras el arranque:

docker logs -f coze-on-wechat

• Iniciar sesión en WeChat: Aparecerá un enlace con un código QR en el registro, abre el enlace y escanéalo con WeChat para iniciar sesión.

5. Funciones de prueba

Después de iniciar sesión, envíe un mensaje al bot de prueba. Ejemplo:

• Chat privado: Escribe "bot hola" o "@bot hola".
• Chat de grupo: Escribe "@bot El tiempo de hoy" en el grupo de la lista blanca.

Función Flujo de operaciones

chat de texto

• chat privadoEnvía un mensaje directamente al bot, por ejemplo, "bot check weather", y él responderá.
• chat de grupoAñadir disparadores de preguntas con "@bot" en grupos permitidos, por ejemplo "@bot a qué hora llueve mañana".

interacción por voz

• enviar una vozGraba tu voz en 20 segundos y envíasela al robot, que la reconocerá y te responderá.
• recibir un discursoSi la respuesta de voz está activada (el ID de tono debe configurarse en Coze), el robot responderá con la voz.
• Configuración de voz: en config.json Establecido en:

"speech_recognition": true,
"text_to_voice": "coze",
"coze_voice_id": "音色ID"  // 从 Coze 文档获取

Soporte para plug-ins

• Añadir complementos (por ejemplo, consultas de noticias) para bots en la plataforma Coze.
• Envía un comando en WeChat (por ejemplo, "consultar noticias") y el robot te devolverá el enlace WeChat.
• Ejemplo: Envíe "consultar el tiempo" y se le devolverá el enlace del tiempo.

entrega multimedia

• El robot puede enviar imágenes o enlaces. Por ejemplo, pídele "Enséñame una foto de un gato" y te enviará una foto.

Interfaz de gestión web

• Tras iniciar la interfaz web, acceda a http://服务器IP:8501.
• Modifique parámetros como las palabras de activación, la lista blanca de grupos, etc. en la interfaz sin editar el archivo.

advertencia

• estabilidad: El protocolo iPad de Gewechat es más estable, pero se recomienda probarlo con un número pequeño para evitar el riesgo del número principal.
• Dependencia CozeLa funcionalidad se basa en la plataforma Coze para garantizar que la clave API es válida.
• requisitos de la redEl despliegue del servidor requiere que los puertos correspondientes (por ejemplo, 2531, 2532, 9919) estén abiertos.

escenario de aplicación

1. Asistente personal
   Haz preguntas, obtén información o realiza tareas como consultar el tiempo o tomar notas en WeChat en cualquier momento.
2. Gestión de grupos de chat
   Los robots responden automáticamente a las preguntas comunes del grupo, reduciendo la carga de los administradores, lo que resulta idóneo para grupos de interés o de trabajo.
3. Herramientas de aprendizaje
   Tras cargar el material didáctico, el robot puede responder a las preguntas pertinentes y facilitar el repaso de los alumnos.

CONTROL DE CALIDAD

1. ¿Es necesario configurar adicionalmente la respuesta vocal?
   Sí, es necesario establecer el ID de tono en la plataforma Coze y establecer el ID de tono en el config.json Activa la opción de voz.
2. ¿Admite el envío de imágenes?
   el robot puede devolver imágenes o enlaces en función de la configuración de Coze.
3. ¿Cuál es la diferencia entre el despliegue en Docker y el despliegue local?
   Docker es más adecuado para el despliegue de servidores con un solo clic y una gestión sencilla; el despliegue local es adecuado para el desarrollo y la depuración.