微信 Bot Plus Gemini

运行在 Windows 微信客户端上的 Gemini 聊天机器人。当前建议使用 Gemini API 模式；Gemini 网页端模式因 Gemini Web 更新已无法正常使用。机器人能读取文本、图片、部分微信表情/动画表情。

重要状态说明： 由于 Gemini 网页端近期更新，本项目中的 Gemini Web 后端/网页反代模式目前已无法正常使用。下文保留的 Web 模式配置仅作历史和技术参考；实际使用请优先选择 Gemini API 模式。

主要功能

• Gemini API 后端可用；Gemini Web 后端目前已因 Gemini 更新失效
• 支持 Gemini 官方 Google Search 工具
• 支持微信群/私聊关键词触发、冷却、上下文记忆
• 支持图片输入，正常图片优先于表情截图上传
• Gemini 网页端生图能力目前随 Web 后端一并不可用
• 支持引用/回复消息上下文
• 支持本地知识库，可按需开启

安装

仅支持 Windows 微信客户端。建议使用 conda：

conda create -n wechat_bot python=3.11 -y
conda activate wechat_bot
pip install -r requirements.txt

也可以在 Git Bash / WSL 风格 shell 里运行：

bash setup_env.sh

配置

仓库不会提交真实 settings.yaml。首次 clone 后复制示例配置：

copy settings.example.yaml settings.yaml

然后编辑 settings.yaml。

Gemini API 模式

llm:
  backend: "api"
  free_api_key: "YOUR_FREE_GEMINI_API_KEY"
  api_key: "YOUR_PAID_GEMINI_API_KEY"
  model: "gemini-2.5-flash"

free_api_key 会优先使用，失败后回退到 api_key / paid_api_key。

Gemini Web 模式

当前不可用： 由于 Gemini Web 更新，网页端反代/自动化访问流程已经失效。本节仅作历史配置参考，不建议在当前版本中继续使用 backend: "web"。

llm:
  backend: "web"
  web_default_model: "Fast"
  web_browser_channel: "chrome"
  web_headless: false

Web 模式需要你在自动打开的 Chrome / Edge 里登录 Gemini。浏览器 profile 会保存在本地目录，不会提交到 GitHub。

微信适配器

wechat:
  adapter: "wxauto4"
  faked_version: "3.9.10.19"

可选值：wxauto4、wxautox4、wxauto、wxhook。

监听聊天

先登录微信，然后列出聊天：

conda activate wechat_bot
python main.py --list-chats

把要监听的群聊或联系人名称填进 settings.yaml 的 chats:：

chats:
  - chat_id: "文件传输助手"
    chat_name: "文件传输助手"
    enabled: true
    owner_wxid: ""
    system_prompt: ""
    extra_keywords: []
    always_reply_all: false

运行

测试 LLM：

python main.py --test-llm

启动机器人：

python main.py

本地数据

以下内容只保存在本机，不会提交：

• settings.yaml
• memory/ 聊天记录
• logs/ 日志
• database/knowledge_base.json 本地知识库
• gemini_chrome_profile/、gemini_web_profile/
• gemini_generated_images/
• wxautox文件下载/、wxauto文件下载/、downloads/
• WXAUTOX_LICENSE

管理命令

• #状态
• #清除记忆
• #保存
• #帮助

注意事项

• 仅支持 Windows 微信客户端。
• 微信自动化/Hook 有账号风险，建议先用小号测试。
• 使用 Gemini API 和 Google Search 可能产生费用。
• Gemini Web 后端和网页端生图功能目前已无法使用，请优先使用 Gemini API 模式。
• 不要提交真实 API Key、微信聊天记录、浏览器 profile 或本地下载文件。

免责声明

本项目是非官方个人项目，仅用于学习、研究和个人自动化实验，不隶属于微信、腾讯、Google、Gemini 或任何相关组织，也不代表上述组织的立场。

本项目依赖微信客户端自动化、第三方适配库以及 Gemini 相关接口。微信客户端、Gemini Web、Gemini API 或相关平台策略发生变化时，本项目的部分或全部功能可能随时失效。尤其是 Gemini Web 后端/网页反代模式目前已因 Gemini 更新无法正常使用。

使用者应自行遵守适用法律法规、平台服务条款、账号使用规范、学校或组织的相关规定，并自行承担使用风险。请勿将本项目用于骚扰、刷屏、绕过平台限制、未授权访问、商业滥用或任何不当用途。

请勿提交或公开真实 API Key、Cookie、微信聊天记录、联系人信息、浏览器 profile、本地下载文件或其他敏感数据。如果本仓库中的任何内容不适合公开分享或侵犯了任何权利人的合法权益，请联系维护者，我会尽快删除或修改相关内容。