欢迎使用 wechat-gptbot 👋

一款基于 ChatGPT 的微信机器人，无风险、超稳定！🚀
英文 | 中文文档

🎤 简介

当我使用基于 itchat 和 wechaty 的机器人时，经常遇到扫码登录后账号被封禁的风险。详见 #158。有没有一种安全的微信机器人使用方式呢？答案就在这里~

🌟 功能

• 极其稳定： 基于 Windows 钩子实现，无需担心微信账号被封禁的风险
• 基础对话： 支持私聊与群聊的智能回复，具备多轮会话上下文记忆功能，支持 GPT-3、GPT-3.5、GPT-4、Claude-2、Claude Instant-1、Command Nightly、Palm 等模型，以及 litellm 中的其他模型
• 图像生成： 支持图像生成，目前仅支持 Dall-E 模型
• 灵活配置： 支持提示词设置、代理、命令设置等
• 插件系统： 支持个性化插件扩展，您可以轻松集成所需功能

📝 更新日志

2023.07.13： 引入 插件系统，让 gptbot 更具可能性且易于扩展 #46。这里第一个有趣的插件是：tiktok，快去试试吧，玩得开心！同时请参考 docs 了解使用方法及如何贡献~

🚀 快速入门

环境

支持 Windows 系统（未来可能基于 sandbox 支持 Linux），同时需安装 Python

建议 Python 版本为 3.13 或更高

1. 克隆仓库

git clone https://github.com/iuiaoin/wechat-gptbot && cd wechat-gptbot

2. 安装依赖

pip install -r requirements.txt

配置

根目录下的 config.template.json 包含配置模板，您需要复制该模板以生成最终生效的 config.json

  cp config.template.json config.json

然后在 config.json 中填写配置，以下是默认配置的说明，可根据需求自定义：

{
  "openai_api_key": "YOUR API SECRET KEY",             # 填写您的 OpenAI API 密钥
  "model": "gpt-3.5-turbo",                            # 使用的模型 ID，支持 gpt-3.5-turbo、gpt-4、gpt-4-32k 等
  "use_azure_chatgpt": false,                          # 是否使用 Azure OpenAI API
  "azure_deployment_id": "",                           # Azure 模型部署名称
  "role_desc": "You are a helpful assistant.",         # 作为系统提示的角色描述
  "session_expired_duration": 3600,                    # 会话记忆保持时长
  "max_tokens": 1000,                                  # 会话记忆的最大字符数
  "temperature": 0.9,                                  # 取值范围为 0 到 2，数值越高输出越随机，越低则越专注
  "proxy": "127.0.0.1:3000",                           # 代理客户端 IP 和端口
  "openai_api_base": "",                               # OpenAI 服务使用的 API 地址
  "create_image_size": "256x256",                      # Dall-E 图像尺寸，支持 256x256、512x512、1024x1024
  "create_image_prefix": ["draw", "paint", "imagine"], # 图像生成的文本前缀
  "clear_current_session_command": "#clear session",   # 清除当前会话
  "clear_all_sessions_command": "#clear all sessions", # 清除所有会话
  "chat_group_session_independent": false,             # 群聊中用户会话是否独立
  "single_chat_prefix": ["bot", "@bot"],               # 在单聊中以“bot”或“@bot”开头触发机器人，若希望机器人始终活跃可留空
  "group_chat_reply_prefix": "",                       # 群聊中的回复前缀
  "group_chat_reply_suffix": "",                       # 群聊中的回复后缀
  "single_chat_reply_prefix": "",                      # 单聊中的回复前缀
  "single_chat_reply_suffix": "",                      # 单聊中的回复后缀
  "query_key_command": "#query key"                    # 查询 API 密钥使用情况
  "recent_days": 5                                     # 近几天的使用情况
  "plugins": [{ "name": <插件名称>, 其他配置 }]# 添加您喜欢的插件
}

运行

1. 准备工作

我们需要特定版本的微信及其 DLL 才能让 Windows 钩子正常工作。

1. 从 release 下载相关资源
2. 安装 WeChatSetup-3.2.1.121.exe 并登录
3. 运行 wechat-dll-injectorV1.0.3.exe
4. 选择 3.2.1.121-LTS.dll 并点击“注入 DLL”，您将看到“成功注入：3.2.1.121-LTS.dll”

2. 运行命令

python app.py

好了！祝您探索愉快~

✨ 慷慨支持者

非常感谢您的支持，这将是我的最大动力！

🤝 贡献

欢迎提交贡献、问题和功能请求！
请随时查看 issues 页面。

🙏 表示支持

如果您喜欢这个项目，请给个 ⭐️ 吧！

📢 公告

WeChatSetup 来自 wechat-windows-versions ，wechat-dll-injector 来自 wechat-bot ，因此您可以放心使用。同时也要感谢这两个仓库的作者们的贡献。

💖 赞助

成为 AFDIAN 的赞助商。您的名字将被特别列在“慷慨支持者”名单中~

wechat-gptbot 快速上手指南

环境准备

系统要求

• 操作系统：仅支持 Windows（未来可能支持 Linux，基于 sandbox）
• Python 版本：建议使用 Python 3.13 或更高版本

前置依赖

• 安装好 Python 环境
• 需要安装 WeChat 客户端（推荐版本：WeChatSetup-3.2.1.121）

---

安装步骤

1. 克隆仓库

git clone https://github.com/iuiaoin/wechat-gptbot && cd wechat-gptbot

2. 安装依赖

pip install -r requirements.txt

3. 配置文件

在项目根目录中有一个 config.template.json 模板文件，将其复制并重命名为 config.json：

cp config.template.json config.json

然后根据你的需求编辑 config.json 文件。以下是一些关键配置项说明：

• openai_api_key: 填入你的 OpenAI API 密钥
• model: 指定使用的模型，如 gpt-3.5-turbo
• proxy: 设置代理（如 127.0.0.1:3000）
• plugins: 添加你想要的插件（例如 TikTok 插件）

---

基本使用

1. 准备工作

为了使 Windows Hook 正常运行，需要下载并安装特定版本的 WeChat 和 DLL 文件：

1. 从 release 页面 下载资源包
2. 安装 WeChatSetup-3.2.1.121.exe 并登录
3. 运行 wechat-dll-injectorV1.0.3.exe
4. 选择 3.2.1.121-LTS.dll 并点击 inject dll，成功后会提示注入完成

2. 启动程序

执行以下命令启动机器人：

python app.py

启动后，即可通过微信与 GPT 机器人进行交互。

---

📌 提示：你可以通过发送 #clear session 清除当前会话，或使用 #clear all sessions 清除所有会话记录。