Coze no WeChat: Trazendo o bot Coze (botão) para o WeChat

Introdução geral

Coze on WeChat é um projeto de código aberto criado para ajudar os usuários a integrar perfeitamente os bots de IA da plataforma Coze ao WeChat. Ele se baseia no chatgpt-on-wechat e no dify-on-wechat e oferece suporte a bate-papo de texto, reconhecimento e resposta de voz, funcionalidade de plug-in e envio de imagens e links. O projeto usa o protocolo do iPad do Gewechat para fazer login no WeChat, que é mais estável do que o itchat tradicional. Os usuários precisam criar bots na plataforma Coze e, por meio de uma configuração simples, podem obter uma interação inteligente no WeChat. O projeto oferece uma interface de gerenciamento baseada na Web para facilitar o ajuste das configurações. Desde março de 2025, ele está sendo seguido por desenvolvedores no GitHub e é adequado para indivíduos ou equipes criarem assistentes inteligentes para o WeChat.

Configuração do COZE

Configuração de back-end do Coze no WeChat

Lista de funções

• bate-papo por textoBate-papos privados e em grupo são suportados, e o bot se lembra do contexto da conversa para fornecer respostas coerentes.
• interação por vozReconhece a entrada de voz em 20 segundos e oferece suporte a respostas de voz.
• Suporte a plug-insFuncionalidade do plug-in Docking Coze para transformar cartões de plug-in em links do WeChat.
• entrega de multimídiaCapacidade de enviar imagens, links e outros conteúdos para aprimorar a experiência interativa.
• Interface de gerenciamento da WebAjuste dos parâmetros do robô por meio da página da Web sem modificar o código.
• função de base de conhecimentoCarregar arquivos ou conteúdo da Web e permitir que o robô responda a perguntas com base nesses dados.

Usando a Ajuda

Processo de instalação

O uso do Coze no WeChat requer a preparação do ambiente e a conclusão da implantação. Veja a seguir as etapas detalhadas:

1. trabalho preparatório

• Inscreva-se em uma conta CozeVisite o site da Coze, registre-se e faça login. Clique em "Create Robot" para configurar seu robô.
• Obtendo a chave da APINa página "Personal Access Token" do Coze (link (em um site)) Gere o token e salve-o.
• ferramenta de montagemGit para fazer download de código e Docker para executar serviços.
• Selecione o método de implantaçãoSuporte para execução local, execução no servidor e implantação do Docker, basta escolher um.

2. fazer o download do projeto

Digite-o em um terminal ou na linha de comando:

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

Isso fará o download do código do projeto e entrará no diretório.

3. ambiente de configuração

Implementação local ou em servidor

• Criação de um ambiente virtual(Opcional, mas recomendado):
  • Use venv:

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

  • Use conda:

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

• Instalação de dependências::

pip3 install -r requirements.txt

• Configurar o config.json::

cp config.json.example config.json

Abrir com um editor de texto config.jsonPreencha os campos-chave abaixo:

{
"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"]  // 允许机器人回复的群
}

Implementação do Docker

• Puxando espelhos Gewechat::

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

• Criação de um catálogo de dados::

mkdir -p gewechat/data

• Cópia de arquivos de configuração::

cp config-template.json config.json

• Início dos serviços::

docker-compose up -d

4. ativação e login

• operação local::

python3 app.py

• operação do servidor::

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

• Operação da interface da Web::

cd web
streamlit run Home.py

entrevistas http://localhost:8501A configuração é feita na página da Web.

• Implementação do DockerVerificação do registro após a inicialização: Verifique o registro após a inicialização:

docker logs -f coze-on-wechat

• Faça login no WeChatUm link de código QR será exibido no registro, abra o link e faça a leitura com o WeChat para fazer login.

5. funções de teste

Depois de fazer login, envie uma mensagem para o teste de bot. Exemplo:

• Bate-papo privado: digite "bot hello" ou "@bot hello".
• Bate-papo em grupo: digite "@bot Today's Weather" no grupo da lista de permissões.

Função Fluxo de operação

bate-papo por texto

• bate-papo privadoMensagem: Envie uma mensagem diretamente para o bot, por exemplo, "bot check weather", e ele responderá.
• bate-papo em grupoAdicionar acionadores de perguntas com "@bot" em grupos permitidos, por exemplo, "@bot que horas chove amanhã".

interação por voz

• enviar uma vozGravação de voz: grave sua voz em 20 segundos e envie-a para o robô, que a reconhecerá e responderá.
• receber um discursoSe a resposta de voz estiver ativada (a ID do tom precisa ser definida em Coze), o robô responderá com voz.
• Configuração de voz: em config.json Situado em:

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

Suporte a plug-ins

• Adicionar plug-ins (por exemplo, consultas de notícias) para bots na plataforma Coze.
• Envie um comando no WeChat (por exemplo, "verificar notícias") e o robô retornará o link do WeChat.
• Exemplo: Envie "check the weather" e o link do clima será retornado.

entrega de multimídia

• O robô pode enviar imagens ou links. Por exemplo, peça "Show me a picture of a cat" (Mostre-me a foto de um gato) e ele enviará uma foto.

Interface de gerenciamento da Web

• Depois de iniciar a interface da Web, acesse a http://服务器IP:8501.
• Modifique parâmetros como palavras de acionamento, lista branca de grupos etc. na interface sem editar o arquivo.

advertência

• estabilidadeO protocolo do Gewechat para iPad é mais estável, mas é recomendável testá-lo com um número pequeno para evitar o risco do número principal.
• Código de DependênciaA funcionalidade depende da plataforma Coze para garantir que a chave da API seja válida.
• requisito de redeA implementação do servidor exige que as portas correspondentes (por exemplo, 2531, 2532, 9919) estejam abertas.

cenário do aplicativo

1. Assistente pessoal
   Faça perguntas, obtenha informações ou realize tarefas, como verificar o clima ou fazer anotações no WeChat a qualquer momento.
2. Gerenciamento de bate-papo em grupo
   Os robôs respondem automaticamente a perguntas comuns no grupo, reduzindo a carga sobre os administradores, o que é adequado para grupos de interesse ou de trabalho.
3. Ferramentas de aprendizado
   Após o upload dos materiais de aprendizagem, o robô pode responder a perguntas relevantes e facilitar a revisão dos alunos.

QA

1. Preciso configurar a resposta de voz adicionalmente?
   Sim, você precisa definir a ID de tom na plataforma Coze e definir a ID de tom na plataforma Coze. config.json Ative a opção de voz.
2. Ele suporta o envio de fotos?
   o robô pode retornar imagens ou links com base na configuração do Coze.
3. Qual é a diferença entre a implantação do Docker e a implantação local?
   O Docker é mais adequado para implantação de servidor com um clique e gerenciamento simples; a implantação local é adequada para desenvolvimento e depuração.