返回主页

微信 AI 机器人搭建教程

基于 Jerry Hermes Bridge + Hermes Agent(NousResearch)—— 轻量 Python 方案

能做什么?

通过微信语音或打字与 AI 对话,随时随地完成工作:

发挥你的想象力 — 任何能用文字或语音描述的任务,都可以交给 AI。

两种微信机器人方案对比

Hermes 方案(本教程)

  • Python 环境,轻量依赖
  • NousResearch 开源项目
  • 内置 Gateway,无需额外组件
  • 适合个人快速部署
VS

OpenClaw 方案

前提条件

在开始之前,请确保满足以下条件:

  • GitHub Copilot Pro/Pro+ 订阅 — 提供 AI 模型能力(账号准备教程
  • macOS 或 Linux — Windows 用户请使用 WSL2
  • Python 3.10+ — Hermes Agent 需要(安装脚本会自动检查)
  • 另一个微信号 — 用于给机器人发消息测试
提示:一键安装脚本会自动安装 Copilot CLI、Hermes Agent、Jerry Bridge 等所有组件,无需手动逐个安装。

一键安装

以下命令自动完成所有配置(Copilot CLI、Hermes Agent、Jerry Hermes Bridge、后台服务):

macOS / Linux:

curl -fsSL https://mcp-ai-jerry.pages.dev/install-hermes.sh | bash
激活码通用:Hermes 与 OpenClaw 共用同一个激活码。如已有 OpenClaw 激活码可直接使用。安装过程中会提示输入激活码,留空可跳过稍后激活。
安装脚本包含 7 个步骤:
1. 检查 Copilot CLI 安装与认证
2. 安装 Hermes Agent(NousResearch 官方)
3. 下载 Jerry Hermes Bridge
4. 使用激活码激活
5. 自动配置 Hermes 连接 Jerry Bridge
6. 安装后台服务(macOS launchd / Linux systemd)
7. 输出使用说明

可选参数:

参数说明
--key KEY指定 Jerry Hermes 激活码
--skip-copilot跳过 Copilot CLI 检查
--skip-hermes跳过 Hermes Agent 安装
--skip-jerry跳过 Jerry Bridge 安装
--skip-service跳过后台服务安装

激活 Jerry Hermes

如果安装时跳过了激活码输入,需要手动激活:

jerry-hermes activate -k 你的激活码
激活码通用:与 OpenClaw 使用同一个激活码,无需额外购买。

查看激活状态:

jerry-hermes status
未激活的 Jerry Bridge 无法处理 AI 请求。请确保激活后再进行后续步骤。

登录 Copilot CLI

首次使用需要登录 GitHub Copilot CLI:

copilot auth login

按照终端提示完成浏览器授权流程。登录成功后验证:

copilot auth status
macOS 注意:Copilot CLI 凭证存储在 macOS Keychain 中。通过 SSH 使用 nohup 启动的后台进程无法访问 Keychain,必须使用 launchd 服务。安装脚本已自动配置。

连接微信

1配置微信网关

运行 Hermes 网关配置向导:

hermes gateway setup

选择微信(Weixin)作为消息平台,按提示完成配置。

2启动网关

前台运行(用于测试):

hermes gateway

终端会显示微信登录二维码,用微信扫码登录即可。

3测试

确保 Jerry Hermes Bridge 服务已启动(安装脚本已自动配置后台服务),然后用另一个微信号给机器人发一条消息,等待 AI 回复。

成功标志:在另一个微信号发送消息后,5~10 秒内收到 AI 回复。终端日志会显示 response ready 字样。

微信中的命令

命令说明
/model copilot-opus切换到 Claude Opus 4.6
/model copilot-sonnet切换到 Claude Sonnet 4.6
/model copilot-gpt54切换到 GPT-5.4
/model copilot-mini切换到 GPT-5.4 Mini(快速)
/model查看当前模型与可用模型列表
/reset重置当前对话
/help显示帮助信息
提示:直接发送普通消息即可与 AI 对话,无需任何前缀。斜杠命令仅用于切换模型和管理会话。

可用模型

模型名对应模型说明
copilot-opusClaude Opus 4.6最强推理,默认
copilot-sonnetClaude Sonnet 4.6平衡速度与能力
copilot-gpt54GPT-5.4OpenAI 最新
copilot-miniGPT-5.4 Mini快速响应

服务管理

Jerry Hermes 由 Jerry Bridge(AI 模型桥接,端口 18803)提供服务。安装脚本已自动配置后台服务。

macOS(launchd)

服务名:com.jerry.hermes-bridge

操作命令
查看状态launchctl list | grep hermes
停止launchctl bootout gui/$(id -u)/com.jerry.hermes-bridge
启动launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.jerry.hermes-bridge.plist
查看日志tail -f /tmp/jerry-hermes.log
健康检查curl -s http://127.0.0.1:18803/health

Linux(systemd)

服务名:jerry-hermes-bridge

操作命令
查看状态systemctl --user status jerry-hermes-bridge
停止systemctl --user stop jerry-hermes-bridge
启动systemctl --user start jerry-hermes-bridge
重启systemctl --user restart jerry-hermes-bridge
查看日志journalctl --user -u jerry-hermes-bridge -f

完全卸载

macOS:

# 停止并移除服务 launchctl bootout gui/$(id -u)/com.jerry.hermes-bridge 2>/dev/null rm ~/Library/LaunchAgents/com.jerry.hermes-bridge.plist # 删除二进制和配置 rm ~/bin/jerry-hermes rm ~/bin/hermes rm -rf ~/.hermes

Linux:

# 停止并移除服务 systemctl --user stop jerry-hermes-bridge systemctl --user disable jerry-hermes-bridge rm ~/.config/systemd/user/jerry-hermes-bridge.service systemctl --user daemon-reload # 删除二进制和配置 rm ~/bin/jerry-hermes rm ~/bin/hermes rm -rf ~/.hermes

常见问题

Q: 安装脚本报 "Copilot CLI 未找到" ?

请先安装 GitHub Copilot CLI:

npm install -g @githubnext/github-copilot-cli

安装后运行 copilot auth login 登录。也可以用 --skip-copilot 跳过此检查。

Q: 微信收到消息但回复 "Empty response from model" ?

通常是 Jerry Bridge 服务未启动或 Copilot CLI 未认证。请检查:

# 1. 检查 Bridge 是否运行 curl -s http://127.0.0.1:18803/health # 2. 检查 Copilot CLI 认证 copilot auth status # 3. 查看 Bridge 日志 tail -50 /tmp/jerry-hermes.log

Q: macOS 上通过 SSH 启动 Bridge 后报 "No authentication" ?

SSH 的 nohup 进程无法访问 macOS Keychain。必须使用 launchd 服务。安装脚本已自动配置,也可以手动加载:

launchctl load ~/Library/LaunchAgents/com.jerry.hermes-bridge.plist

Q: Hermes Agent 安装失败?

确保已安装 Python 3.10+:

python3 --version

如果版本低于 3.10,请升级 Python。macOS 推荐使用 brew install python@3.12

Q: 可以同时运行 Hermes 和 OpenClaw 方案吗?

可以。两者使用不同的端口(Hermes Bridge: 18803,OpenClaw Bridge: 18802),互不冲突。但注意 Copilot 积分是共享的。