Gemini 3 与微信集成技术指南
Gemini 3 可通过开源项目 chatgpt-on-wechat，结合 Gemini API Key 及微信/企业微信开发配置，实现个人微信、公众号、企业微信三大场景下的 AI 智能对话能力。
一、接入方案
1. 个人微信
适用场景：日常私聊、群聊自动应答
核心工具：chatgpt-on-wechat
部署方式：云服务器或本地环境
注意事项：存在账号风控风险，不建议商用。
2. 微信公众号
适用场景：自动回复、在线客服
实现方式：开启开发者模式，对接 Gemini API
优势：官方接口稳定，适配商业化需求。
3. 企业微信
适用场景：内部沟通、客户管理、智能客服
实现方式：创建自建应用或机器人，配置 Webhook 与 API
优势：官方支持、无风控、支持精细化权限管理。
二、准备工作
1. 获取 Gemini 3 API Key
- 访问 Google AI Studio；
- 创建并保存 API Key；
- 国内网络用户需使用 API 中转服务（如 2233.ai），获取可直连的接口地址及密钥。
2. 微信端准备
- 个人微信：准备可登录账号；
- 公众号：注册后开启 开发者模式，获取 AppID、AppSecret、Token；
- 企业微信：注册企业，创建应用/机器人，获取 CorpID、Secret、AgentID。
3. 服务器及环境准备
推荐使用阿里云/腾讯云服务器，安装 Docker；测试阶段可在本地电脑搭建临时环境。
三、详细接入步骤
1. 拉取并配置项目
- 下载配置文件：
Bash
wget https://open-1317903499.cos.ap-guangzhou.myqcloud.com/docker-compose.yml - 编辑
docker-compose.yml，关键配置如下：
YAML
version: '2.0'
services:
chatgpt-on-wechat:
image: zhayujie/chatgpt-on-wechat
container_name: chatgpt-on-wechat
security_opt: [seccomp:unconfined]
environment:
MODEL: "gemini"
GEMINI_API_KEY: "你的Gemini_API_Key"
GEMINI_MODEL: "gemini-3-pro"
PLATFORM: "wechat"（wechat/wechatmp/wecom）
NICKNAME: "AI助手"
TRIGGER_PREFIX: "@AI助手"
ports: ["3000:3000"]
restart: always
2. 启动服务
Bash |
3. 登录与验证
- 个人微信：扫描日志中二维码完成登录；
- 公众号：在后台配置服务器地址（IP:3000/wechatmp）、Token 及 EncodingAESKey 并验证；
- 企业微信：在“应用管理 → 自建应用 → 接收消息”中填写对应参数。
4. 功能测试
- 个人微信：私聊或群聊中 @AI助手，验证响应；
- 公众号/企业微信：发送消息，确认自动回复正常。
四、不同微信场景的配置差异
1. 个人微信
仅需配置 GEMINI_API_KEY、MODEL、PLATFORM，扫码登录即可。注意：非官方登录存在账号受限风险。
2. 微信公众号
配置示例（YAML）：
YAML |
在公众号后台“开发 → 基本配置”中填写服务器地址及相关参数并启用。
3. 企业微信
配置示例（YAML）：
YAML |
在企业微信后台“应用管理 → 自建应用 → 接收消息”中填写参数。
五、国内网络解决方案
Gemini API 国内无法直连，推荐以下两种方案：
- API 中转服务（推荐）：通过 2233.ai 等平台获取国内可用接口及密钥，在配置中设置 GEMINI_API_BASE_URL 为中转地址；
- 自建代理：确保服务器可访问 Google，配置容器代理环境变量。
六、注意事项
- 合规风控：个人微信建议使用小号，避免高频调用；公众号与企业微信更适用于商业场景；
- API 费用：Gemini 提供免费额度，超出后按量计费；中转服务通常按 Token 收费；
- 功能限制：文本对话全场景支持；多模态能力需在个人微信或企业微信中额外配置；
- 上下文记忆：默认支持多轮对话，可通过配置文件调整记忆长度。