DeepSeek接入微信公众号小白保姆教程

2026-05-14 05:06:0860 阅读量

基本原理&潜在风险&过程概览

基本原理:本教程将使用Github开源项目chatgot-on-wechat,将DeepSeek API以及微信公众号API接入上述程序,在服务器运行,实现自动将公众号接收到的消息转发至服务器,由服务器上的程序调用大模型获得返回后再回复给用户。

相关服务:香港VPS服务器

潜在风险:本教程涉及微信公众号的管理员风险操作,可能会存在误操作风险,建议用不重要的公众号测试;本教程还涉及云服务器的使用,免费额度过期后可能会产生服务器费用;本教程还涉及DeepSeekAPI接口的调用,免费额度过期后可能会产生API调用费用。
注意:本教程仅供学习用途,如有任何损失本教程概不负责,建议用不重要的公众号测试。

本教程将依据以下流程推进:
DeepSeekAPI key获取->微信公众平台信息获取->云服务器创建->代码配置->微信公众平台配置

1.DeepSeekAPI key获取

  1. 登录DeepSeek开发者平台并注册->传送门
  2. 在开发者平台首页->API keys->创建API key这里创建API key,名称随便填,复制APIkey并保存供后续使用,见下图,一定要复制下来保存好并备注这是什么,因为后面还有别的要保存,防止弄混!后面的也一样!
    在这里插入图片描述

2.微信公众平台信息获取

  1. 登录微信公众平台(没注册的话自行注册并实名)->传送门

  2. 在微信公众平台首页->设置与开发->开发接口管理这里成为开发者身份,然后分别复制AppID和AppSecret并保存备注好,见下图,随后点击服务器配置中的“修改配置”进入下一步。
    在这里插入图片描述

  3. 点击上图中S5处的“修改配置”,然后点击AESKey栏目右边的“随机生成”,复制、保存并注备注好! 这个页面不要关闭,最后一步还要用。
    在这里插入图片描述

3.云服务器创建(阿里云)

  1. 进入阿里云官网,注册并登录->传送门

  2. 进入阿里云首页->权益中心->免费试用,见下图:

在这里插入图片描述

  1. 在阿里云免费试用页面,找到“云服务器ECS免费试用(个人版)”,一般第一个就是,然后点击立即试用,见下图:
    在这里插入图片描述
  2. 提交免费试用订单(无需付费)后,进入阿里云云服务器管理控制台->传送门
    在云服务器控制台中,如有“我的试用进度”栏目则为试用成功,如下图,可进入下一步,若没有则未试用成功,请刷新再看后再次尝试去创建免费试用订单。
    在这里插入图片描述
  3. 点击“我的试用进度”栏目下的**“创建更多试用ECS”**打开ECS创建页面(会从右侧弹出),选择配置(配置在下方)并勾选同意服务协议后,点击右下角的“立即试用”创建试用订单,见下图:

在这里插入图片描述

按如下列表选择配置:
※免费地域:选择中国香港(因为别的地方可能要SSL证书)
※ECS实例及系统盘:选择2核2GiB的(完全够用)
※操作系统:选择Ubuntu22.04 64位
※预装应用:不预装(不选择任何项目)

在这里插入图片描述

  1. 创建好试用ECS后,休息5分钟等它初始化,随后进入ECS控制台->传送门
    在ECS控制台页面,首先点击进入安全组,确认上方的地域分类是中国香港,然后再点击管理规则进入安全组规则配置页面,见下图:
    在这里插入图片描述
  2. 在安全组规则配置页面,需要放行HTTP协议的默认端口号80,以便微信服务器可以访问,具体操作为:首先点击入方向的快速添加,然后确认授权对象为所有IP地址,即0.0.0.0/0,再勾选上HTTP协议的80号端口,最后再点击确定保存配置,见下图:
    在这里插入图片描述
  3. 配置完安全组策略后,点击进入实例页面,先再次确认地域分类是中国香港,然后复制服务器的公网IP地址,保存并备注好,随后点击右侧的远程连接按钮,会有一个弹窗,点击立即登录即可,见下图:
    在这里插入图片描述
  4. 在登录实例页面,选择临时SSH密钥认证(这样可以免设密码),随后点击确定,加载完毕即可进入云服务器的终端,见下图,长时间断开重连时操作一样。
    在这里插入图片描述

3.1 云服务器创建(AWS)

3.1.1 注册AWS账号

  1. 开通亚马逊云AWS账号 -> 传送门
  2. 填入邮箱和账户名称,邮箱建议使用google邮箱,没有的话可以使用163邮箱或者QQ邮箱,接着验证邮箱

在这里插入图片描述

  1. 登录注册邮箱,会收到一个AWS验证码:

在这里插入图片描述

  1. 回到申请页面,输入验证码,验证邮箱
  2. 创建密码,输入根用户密码
    在这里插入图片描述
  3. 输入联系方式信息
  4. 填写信用卡或借记卡信息,这里国内信用卡也是可以的,需要填写信用卡有效期和安全码,可以在信用卡手机银行里查看
  5. 短信验证
  6. 注册完成

3.1.2 登录控制台

  1. 登录控制台 -> 传送门
  2. 选择根用户,填写注册时使用的邮箱地址,点击下一步
    在这里插入图片描述
  3. 输入注册时的密码,点击登录在这里插入图片描述
  4. 成功进入亚马逊云控制台
    在这里插入图片描述

3.1.3 服务器选择与相关配置

  1. 打开免费套餐信息页面

注册成功以后,亚马逊会发一封邮件到你的邮箱,点击邮件里 【库和应用程序服务】 这个链接
在这里插入图片描述

  1. 找到免费套餐详细信息
    页面往下拉,会出现免费套餐详细
    在这里插入图片描述

  2. 根据实际情况,筛选自己需要的服务器
    因为我需要的是一台VPS服务器,所以这里就以VPS为例:
    在这里插入图片描述

  3. 点击【开始使用Amazon EC2】
    在这里插入图片描述

  4. 进入服务器后台管理页面
    在这里插入图片描述

  5. 选择服务器所在区域
    这里我选择的系统默认的斯德哥尔摩的云服务器,在右上角选择斯德哥尔摩地区的机子,再选择启动实例:
    在这里插入图片描述

  6. 创建实例
    <1> 输入主机的名称 -> 选择服务器镜像(操作系统)

AMI是包含操作系统和预装软件的虚拟服务器镜像。您可以选择AWS提供的预定义AMI,也可以使用您自己的自定义AMI。从列表中选择一个适合您需求的AMI。本文以Ubuntu为例,然后对应点击后面的选择按钮。这里选择的操作系统会影响我们后面连接云服务器的指令。

在这里插入图片描述
<2> 选择实例类型
在此步骤中,您可以选择不同的EC2实例类型,这些类型具有不同的计算、内存和存储资源。根据您的应用程序需求选择适合的实例类型,一般选择它推荐的就行。需要不同的配置可以搜,例:如需要两核搜“2 vcpu”,本示例以t2.large为例。
在这里插入图片描述
<3> 创建密钥对
我们在设置EC2实例完毕之后,启动的时候会提示创建密钥的窗口,输入便于记忆的秘钥对名称,点击“创建密钥对”会自动下载,切记保存好!

这个很重要,要保存好,之后登录你的VPS需要用到的。也就是你的VPS的登录密码

在这里插入图片描述
在这里插入图片描述

这个pem文件会下载到本地,记得保存好!后面会用到!

<4> 配置网络与安全组
vpc网络没有特殊需求建议保存默认。

可以开放一些常用的端口,比如80,443等,我们也可以先不设置,后面可以陆续开放。
在这里插入图片描述
<5> 配置存储
默认是8GB空间,我们可以扩展到它提示的30GB。
在这里插入图片描述
<6> 启动实例
在这里插入图片描述
<7> 查看实例
在这里插入图片描述
<8> 访问服务器

共有IPv4地址就是我们访问服务器的IP地址,因为我这里选择的Linux系统,所以需要使用ssh方式访问

点击实例ID -> 选择右上方的连接 -> 查看提示

进入到刚刚下载到本地的pem文件的路径,以我本地为例,下载路径为:

E:\deepseek\deepseek\SpeedSeek.pem
在该路径下,打开git bash终端,cmd终端是不可以的,没有git的需要先安装git,在git bash终端下输入以下指令:

ssh -i "SpeedSeek.pem" [email protected]

4. 项目代码配置

4.1 复制项目代码

进入云服务器终端后便可以开始代码配置,本项目基于GitHub的开源项目COW,使用过程请遵循其协议。

  1. 首先从GitHub把COW项目代码复制进服务器,指令如下,复制后粘贴进云服务器终端,然后点回车即可执行,后面的指令也是这样执行。
git clone https://github.com/zhayujie/chatgpt-on-wechat.git

终端有以下输出则复制成功:
在这里插入图片描述

如果遇到报错:-bash: git: command not found;表明在 云服务器上的终端环境中没有安装 git,执行以下步骤:

在Linux系统下:
sudo yum update -y
sudo yum install git -y
git --version

在Ubuntu 系统下:
sudo apt update
sudo apt install git -y
git --version

  1. 在云服务器下载并安装项目的相关依赖包,依次在云服务器终端执行下面两条指令即可,这两条命令执行过程需要一些时间,请耐心等待,一条一条来。
pip3 install -r ./chatgpt-on-wechat/requirements.txt
pip3 install -r ./chatgpt-on-wechat/requirements-optional.txt

如果遇到报错:-bash: pip3: command not found;表明在 云服务器上的终端环境中没有安装 pip3,执行以下步骤:

在Linux系统下:
sudo yum update -y
sudo yum install python3-pip -y
pip3 --version

在Ubuntu 系统下:
sudo apt update
sudo apt install python3-pip -y
pip3 --version

然后再次运行以上两条指令
pip3 install -r ./chatgpt-on-wechat/requirements.txt
pip3 install -r ./chatgpt-on-wechat/requirements-optional.txt

  1. 如果御道以下报错信息:
admin@ip-172-31-32-31:~$ pip3 install -r ./chatgpt-on-wechat/requirements.txt
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.

    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.

    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.

    See /usr/share/doc/python3.11/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

这个错误表明你当前的环境是由操作系统管理的,也就是说,系统默认不允许你通过 pip3 安装全局的 Python 包。这通常是出于保护系统环境的目的,避免安装或升级包时影响到系统的其他部分。

使用 --break-system-packages 参数 强制安装

sudo pip3 install --break-system-packages -r ./chatgpt-on-wechat/requirements.txt
sudo pip3 install --break-system-packages -r ./chatgpt-on-wechat/requirements-optional.txt
  1. 再次依次执行上面两条指令,检查依赖包是否齐全,这一次会快很多,若输出第一句均为“Requirement already satisfied:”则无异常,见下图示例:

在这里插入图片描述

4.2 编辑配置信息

打开电脑记事本,复制下列文本,一定要小心,不要增删符号,不要动到其它部分,推荐输入法在英文状态下进行:

{
  "channel_type": "wechatmp",
  "model": "deepseek-chat",
  "open_ai_api_key": "你获取的DeepSeek的APIkey",
  "open_ai_api_base": "https://api.deepseek.com/v1",
  "single_chat_prefix": [""],
  "single_chat_reply_prefix": "",

  "wechatmp_app_id": "你的微信开发者ID,即APPID",
  "wechatmp_app_secret": "你的微信开发者密钥,即APP Secret",
  "wechatmp_aes_key": "前面随机生成的43位AESKey",
  "wechatmp_token": "这里可以自定义3-32位字符,但是要记住",
  "wechatmp_port": 80,

  "conversation_max_tokens": 3000,
  "expires_in_seconds": 3600,
  "character_desc": "你是基于大语言模型的AI智能助手,旨在回答并解决人们的任何问题,并且可以使用多种语言与人交流。",
  "temperature": 0.8,
  "subscribe_msg": "感谢您的关注!\n公众号已接入DeepSeek-V3,可以自由对话。\n受微信限制,较长的输出会先回复一句【正在思考中】,等待片刻后发送任意文字即可获取输出。",
  "use_linkai": false
}


wechatmp_token字段可以自定义3-32位字符,但是要记录、保存并备注,最后一步要用,其余各项目含义在此便不介绍了,有兴趣可以去DeepSeek官方文档以及 GithubCOW项目介绍页了解。可以参考硅基流动或者华为云等镜像api的token设置。

model 字段对应的是deepseek的模型,deepseek-chat对应的是DeepSeek-V3模型,deepseek-reasoner对应的是 DeepSeek-R1模型,如果是使用的硅基流动的DeepSeek模型,则需要修改为对应的model,可查看文档说明,已硅基流动api文档为例:

curl --request POST \
  --url https://api.siliconflow.cn/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "deepseek-ai/DeepSeek-V3",
  "messages": [
    {
      "role": "user",
      "content": "中国大模型行业2025年将会迎来哪些机遇和挑战?"
    }
  ],
  "stream": false,
  "max_tokens": 512,
  "stop": [
    "null"
  ],
  "temperature": 0.7,
  "top_p": 0.7,
  "top_k": 50,
  "frequency_penalty": 0.5,
  "n": 1,
  "response_format": {
    "type": "text"
  },
  "tools": [
    {
      "type": "function",
      "function": {
        "description": "<string>",
        "name": "<string>",
        "parameters": {},
        "strict": false
      }
    }
  ]
}'

model字段即为:deepseek-ai/DeepSeek-V3,这代表了之前提到的DeepSeek-V3模型

open_ai_api_key 字段对应的是你获取的DeepSeek的APIkey,类似的,也可以使用硅基流动的APIKey

open_ai_api_base字段对应的是DeepSeek的base_url ,类似的,也可以使用硅基流动的base_url: https://api.siliconflow.cn/v1

model、open_ai_api_key、open_ai_api_base是需要对应的,可以使用ApiFox工具测试接口是否正常,如果遇到报错400,可以查看是否这三个字段的值不对。ApiFox的使用可以查看这篇文章 -> 传送门

编辑完项目配置信息后保留备用,下一步和最后一步还要用,请保证随时可复制的状态,下面给出一个示例,里面的信息都是乱填的,仅用于对比检查。

在这里插入图片描述

4.3 创建配置文件

在服务器中创建并写入项目配置文件,请保持输入法为英文模式,并严格遵守下面的步骤,谨防出错。

  1. 进入项目文件夹,指令如下,复制后粘贴进服务器终端然后回车:
cd chatgpt-on-wechat
  1. 使用Vim编辑器创建配置文件并打开编辑,指令如下,复制后粘贴进服务器终端然后回车:
vi config.json
  1. 按下【I】键,进入Vim编辑模式,注意这是键盘上的字母I。
  2. 复制4.2步骤中编辑好的项目配置信息,然后粘贴进Vim编辑器。使用快捷键【Shift + Insert 】键 或者 【Ctrl + Shift + V】键。
  3. 依次按键【Esc】、【:】、【w】、【q】、【Enter】以保存编辑并退出Vim编辑器(注意第二个按键是英文冒号而非分号)。
  4. 若成功退出Vim编辑器,则输出配置文件信息并最后一次检查,指令如下:
cat config.json

指令执行后会输出配置文件信息,即我们之前粘贴进去的文本,请检查是否有误,下图为示例,若信息无误,则完成了代码配置。

在这里插入图片描述

在云服务器运行项目,使用以下指令运行项目:

sudo python3 app.py

若输出如下图则运行正常无报错,此时云服务器的终端暂时先不要关闭(浏览器选项卡不要关掉)

在这里插入图片描述

5. 微信公众平台配置

  1. 在云服务器运行程序后,便只剩最后一步啦!成功很接近啦!

  2. 回到微信公众平台,若之前关闭了,请进传送门->传送门
    进入微信公众平台首页->设置与开发->开发接口管理->修改服务器配置,如下图:
    在这里插入图片描述

  3. 修改服务器配置,按如下规则填写,示例如下图:

注意URL 是http开头而不是https

※URL:http://你的服务器公网IP/wx
※Token:要和前面步骤的配置文件中的一样
※AESKey:要和前面步骤的配置文件中的一样
※加密方式:兼容模式
在这里插入图片描述

  1. 填写完成后点击提交,弹窗点确定,确定后若上方显示“提交成功”则配置验证成功!!最后再点击启用,启用成功便配置完成啦!现在你的公众号已经接入了DeepSeek啦!!请到公众号测试!!

6.完善工作&后续工作

  1. 当前为了便于测试,所执行的指令会使服务器响应终端的关闭信号,即终端关闭后项目进程便会终止。在测试成功后若想让程序无值守运行在云服务器,可以先到阿里云ECS控制台重启云服务器后重新连接,进入终端后执行下面的指令运行程序,这样本地电脑关机也不会影响服务器程序的运行啦。
(cd chatgpt-on-wechat && nohup python3 app.py &); tail -f ./chatgpt-on-wechat/nohup.out
  1. 建议定期重启服务器,重启后执行上面的指令即可重新无值守运行程序。
  2. 在了解配置文件各条目含义后,可自定义配置文件,例如换成DeepSeekR1模型、自定义触发格式、回复格式等。
  3. 阿里云ECS免费试用额度是300元(大概能用2个月),请定期在[阿里云用户中心]关注试用进度,在额度耗尽前续费或释放试用资源。
  4. DeepSeek的API调用赠送金额为10元,请在[DeepSeek开发者平台]关注用量情况,根据自身需求续费或停用API。

本文地址:https://www.idc504.com/news/9_30828.html