在点击"访问API"后，我们会跳转到上图的API管理页面，在这个页面我们按照如下步骤获取API密钥：
在保存密钥后，还需要查看右上角的API服务器，如果是Dify官网的应用，API服务器地址为 "https://api.dify.ai/v1", 如果是私有部署的，请确认你自己的API服务器地址。
至此，创建聊天助手的准备工作结束，在此小节中我们只需要保存好两个东西：API密钥与API服务器地址
2.1.2. 下载Dify on WeChat项目
（1）Dify on WeChat项目简介
Dify on WeChat是 ChatGPT on WeChat的下游分支，额外实现了对接Dify API，支持Dify聊天助手、支持Agent调用工具和知识库，支持Dify工作流，详情请查看GitHub仓库Dify on WeChat。
（2）下载代码并安装依赖
git clone https://github.com/hanfangyuan4396/dify-on-wechat
cd dify-on-wechat/
Dify on WeChat项目使用python语言编写，请在python官网下载安装python，推荐安装python3.8以上版本，我在ubuntu测试过3.11.6版本，可以正常运行。
pip3 install -r requirements.txt # 国内可以在该命令末尾添加 "-i https://mirrors.aliyun.com/pypi/simple" 参数，使用阿里云镜像源安装依赖
pip3 install -r requirements-optional.txt # 国内可以在该命令末尾添加 "-i https://mirrors.aliyun.com/pypi/simple" 参数，使用阿里云镜像源安装依赖
（3）填写配置文件
我们在项目根目录创建名为config.json的文件，文件内容如下，我们在2.1.1小节（4） 最后保存了API密钥与API服务器地址，请把dify_api_base配置为API服务器地址；dify_api_key配置为API密钥其他配置保持不变。
(PS: 很多朋友可能并不是严格按照我教程给出的步骤创建聊天助手类型的Dify应用，在此特别说明一下dify_app_type配置方法，如果你创建了聊天助手应用请配置为chatbot；创建了Agent应用请配置为agent 创建了工作流应用请配置为workflow。)
{
"dify_api_base": "https://api.dify.ai/v1",
"dify_api_key": "app-xxx",
"dify_app_type": "chatbot",
"channel_type": "wx",
"model": "dify",
"single_chat_prefix": [""],
"single_chat_reply_prefix": "",
"group_chat_prefix": ["@bot"],
"group_name_white_list": ["ALL_GROUP"]
}
3.把基础编排聊天助手接入微信
如果没看过之前的文章，那么请自行申请腾讯云宝塔服务器。可参考参考COW初级使用教程。
Dify-On-Wechat项目部署需要参考上面步骤。
3.1. 部署GEWE
这里我们使用Docker部署，这里为了方便小白操作，咱直接放宝塔上的步骤，不使用指令了。
先下载GEWE镜像，从下选择合适自己的：
# 从阿里云镜像仓库拉取(国内)
docker pull registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine
docker tag registry.cn-chengdu.aliyuncs.com/tu1h/wechotd:alpine gewe
# 或从GitHub镜像仓库拉取
docker pull ghcr.io/tu1h/wechotd/wechotd:alpine
docker tag ghcr.io/tu1h/wechotd/wechotd:alpine gewe
root下新建一个gewechat文件夹。
创建data文件夹和docker-compose.yml文件。
复制以下内容到docker-compose.yml文件。
version: '3'
services:
gewechat:
image: gewe
container_name: gewe
volumes:
- ./data:/root/temp
ports:
- "2531:2531"
- "2532:2532"
networks:
- gewe-network
extra_hosts:
- "host.docker.internal:host-gateway"# 添加这行，允许容器访问宿主机
restart: always
networks:
gewe-network:
driver: bridge
然后点击终端，执行指令，启动Docker，直接执行第2个，第1个只是备注给大家说明。
docker-compose down #会停止并移除所有容器
docker-compose up -d #以 后台模式 启动所有容器
看到如下日志，代表启动成功。
然后查看Docker中是否已经启动，如果已经启动了，那么代表GEWE部署完成。
3.2. 部署DOW（Dify-On-Wechat）
以下简称为DOW。下载安装我就不多解释了，看老金之前的文章教学，DOW使用教程
这里只说怎么连接GEWE。
dify-on-wechat、dify、gewechat服务的调用关系
在dify-on-wechat项目的config.json中需要配置以下Gewechat相关的参数，注意删除解释的文字：
这里如果你和老金一样Gewe是在Docker中部署的，那么直接和老金写一样的就行。
Dify相关的请自行配置。
{
"channel_type": "gewechat" # 通道类型，请设置为gewechat
"gewechat_app_id": "",
"gewechat_token": "",
"gewechat_base_url": "http://172.17.0.1:2531/v2/api",
"gewechat_callback_url": "http://172.17.0.1:9919/v2/api/callback/collect",
"gewechat_download_url": "http://172.17.0.1:2532/download",
}
参数说明：
gewechat_token: gewechat服务的认证token，首次登录时，可以留空，启动dify-on-wechat服务时，会自动获取token并自动保存到config.json中
gewechat_app_id: gewechat服务分配的设备ID，首次登录时，可以留空，启动dify-on-wechat服务时，会自动获取appid并自动保存到config.json中
gewechat_base_url: gewechat服务的API基础地址，请根据实际情况配置，如果gewechat服务与dify-on-wechat服务部署在同一台机器上，可以配置为http://本机ip:2531/v2/api
gewechat_callback_url: 接收gewechat消息的回调地址，请根据实际情况配置，如果gewechat服务与dify-on-wechat服务部署在同一台机器上，可以配置为http://本机ip:9919/v2/api/callback/collect，如无特殊需要，请使用9919端口号
gewechat_download_url: 文件下载地址，用于下载语音、图片等文件，请根据实际部署情况配置，如果gewechat服务与dify-on-wechat服务部署在同一台机器上，可以配置为http://本机ip:2532/download
{
"channel_type": "gewechat" # 通道类型，请设置为gewechat
"gewechat_app_id": "",
"gewechat_token": "",
"gewechat_base_url": "http://172.17.0.1:2531/v2/api",
"gewechat_callback_url": "http://172.17.0.1:9919/v2/api/callback/collect",
"gewechat_download_url": "http://172.17.0.1:2532/download",
}
启动成功后，可以看到如下日志信息，注意token和appid会自动保存到config.json，无需手动保存
⚠️如果遇到gewechat创建设备失败，unexpected EOF错误，请排查网络是否是以下情况：
- 若手机上退出了Ipad，则需要把config里面GEWE的id和token的值删除；
语音条说明
老金我自己还没接，有兴趣的小伙伴可以自己试试。
语音相关配置如下，另外需要在dify应用中开启语音转文字以及文字转语音功能，注意语音功能需要安装ffmpeg依赖，如使用docker部署dify，已集成ffmpeg依赖，无需额外安装。
{
"dify_api_base": "https://api.dify.ai/v1",
"dify_api_key": "app-xxx",
"dify_app_type": "chatbot", # 或agent
"channel_type": "gewechat", # 通道类型设置为gewechat
"model": "dify",
"speech_recognition": true, # 是否开启语音识别
"voice_reply_voice": true, # 是否使用语音回复语音
"always_reply_voice": false, # 是否一直使用语音回复
"voice_to_text": "dify", # 语音识别引擎
"text_to_voice": "dify" # 语音合成引擎
}
Gewe支持发送语音条消息，但是Gewe服务只能获取到20s以内的语音
所以你只能给bot发送20s以内的语音，而bot给你发送语音时无此限制。
Gewechat_channel 限制
- gewechat 要求必须搭建服务到同省服务器或者电脑里方可正常使用，即登录微信的手机与gewechat服务必须在同一省
- gewechat 开源框架只支持下载接收到的图片，不支持下载文件
- gewechat_channel 目前暂时只支持接收文字消息，只支持发送文字消息与图片消息，后续支持的消息类型会逐步完善
粤ICP备14082021号
免费POC，
零成本试错
