返回首页

微信 AI 机器人 — Hermes 方案

基于 Jerry Hermes Bridge + Hermes Agent(NousResearch)—— 轻量 Python 方案。通过微信语音或打字与 AI 对话。

Hermes 微信 Telegram Discord Claude Opus GPT-5.4

能做什么?

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

  • 语音下达开发任务 — 走路、开车时语音发消息,AI 自动编写代码、修 Bug
  • 随时问答 — 技术方案讨论、代码审查、知识检索
  • 文档翻译与写作 — 发一段文字,AI 帮你翻译、润色、总结
  • 多平台支持 — 微信、企业微信、Telegram、Discord、WhatsApp、飞书、钉钉等
  • 团队共享 — 多人发消息给同一个机器人,共用 Copilot 额度

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

两种微信机器人方案对比

Hermes 方案(本教程)

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

OpenClaw 方案

前提条件

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

  • GitHub Copilot Pro/Pro+ 订阅 — 提供 AI 模型能力(账号准备教程
  • macOS 或 Linux(推荐) — Hermes Agent 在 Linux/WSL 下最稳定
  • Windows(仅 Bridge) — 提供 install-hermes.ps1,可在 Windows 主机原生运行 jerry-hermes Bridge;Hermes Agent 本体仍建议放在 WSL2 内
  • Python 3.10+ — Hermes Agent 需要(安装脚本会自动检查)
  • 微信号 — 用于给机器人发消息测试
提示:一键安装脚本会自动安装 Copilot CLI、Hermes Agent、Jerry Bridge 等所有组件,无需手动逐个安装。

一键安装

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

macOS / Linux:

当前版本:v2.0.56(脚本自动下载最新版)

$curl -fsSL https://mcp-ai-jerry.pages.dev/install-hermes.sh | bash

Windows (PowerShell):

⚠️ 必须以「管理员身份」运行 PowerShell(开始菜单 → 右键 PowerShell → 以管理员身份运行),否则 winget 安装、计划任务注册、WSL 安装等步骤会失败。

PS>irm https://mcp-ai-jerry.pages.dev/install-hermes.ps1 | iex
Windows 自适应:脚本会自动检测 WSL2 —— 如已安装 WSL2 + Ubuntu,会询问是否在 WSL 内执行完整安装(含微信扫码);如无 WSL,会引导您选择「自动安装 WSL2 + Ubuntu」(推荐,需管理员+重启)或「仅安装 Windows 原生 Bridge」(仅 AI 模型代理,不含微信)。
推荐:右键 PowerShell → 以管理员身份运行 → 粘贴上面命令,按 1 自动装 WSL2 → 重启 → 再次运行同命令完成微信安装。
激活码通用: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:

macOS / 本地桌面终端:

$copilot login

Linux 无界面服务器:

$gh auth login -h github.com -p https -w --insecure-storage

按照终端提示完成浏览器授权流程。Linux 服务器上 copilot 会自动复用 gh 的登录状态。登录成功后可验证:

$gh auth status || cat ~/.copilot/config.json
macOS 注意:Copilot CLI 凭证存储在 macOS Keychain 中。通过 SSH 使用 nohup 启动的后台进程无法访问 Keychain,必须使用 launchd 服务。安装脚本已自动配置。
Linux 注意:很多云服务器没有系统 keychain,直接 copilot login 可能授权成功但 token 不落盘,因此建议优先使用上面的 gh auth login --insecure-storage

测试机器人

一键安装脚本(Mac/Linux 或 Windows + WSL2)已自动完成 Hermes 网关配置微信扫码Bridge 后台服务。安装完成后,用微信号给机器人发一条消息即可测试。

需要重新配置/扫码?运行 hermes gateway setup(重新选平台)或 hermes gateway(重新扫码登录)。
成功标志:5~10 秒内收到 AI 回复。Bridge 日志会显示 response ready 字样。
注意:Windows 原生只装了 Bridge,微信网关需要在 WSL2 内(一键脚本会引导)。

微信中的命令

注意:Hermes 网关会把 /... 当作它自己的内建命令,所以这里不要发 /opus。请改用 #opus模型 opus 这种格式。
命令说明
#opus / 模型 opus / #opus45切换到 Claude Opus 4.5(3x,需 Pro 以上)
#opus47切换到 Claude Opus 4.7(仅 Pro+,7.5x;失败自动降级到 Sonnet 4.6 → 4.5 → 4 → GPT-5.4)
#sonnet / 模型 sonnet切换到 Claude Sonnet 4.6
#haiku / 模型 haiku切换到 Claude Haiku 4.5(快速)
#gpt / #gpt54 / 模型 gpt切换到 GPT-5.4
#gpt5.5 / #gpt55 / 模型 gpt5.5切换到 GPT-5.5(仅 Pro+;不可用时自动降级到 GPT-5.4)
#codex / 模型 codex切换到 GPT-5.3 Codex
#mini / 模型 mini切换到 GPT-5.4 Mini(快速)
#auto / 模型 auto切换到 Copilot Auto(显式自动选模,遇到 latest 周限额时推荐)
#default / 模型 default切换回本地 Copilot 默认配置(不显式指定模型)
#model / 模型查看当前模型与可用命令
#reset / #新对话重置当前对话
#help / #帮助显示帮助信息
提示:直接发送普通消息即可与 AI 对话,无需任何前缀。斜杠命令仅用于切换模型和管理会话。

可用模型

模型名对应模型说明
copilotGPT-5.4⭐ 默认
copilot-gpt55GPT-5.5仅 Pro+
copilot-opusClaude Opus 4.7最强推理(仅 Pro+,失败自动降级)
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)— 点击展开

root 安装:服务名是 jerry-hermes普通用户安装:服务名是 jerry-hermes-bridge

操作命令
查看状态systemctl status jerry-hermes(root)
systemctl --user status jerry-hermes-bridge(普通用户)
停止systemctl stop jerry-hermes(root)
systemctl --user stop jerry-hermes-bridge(普通用户)
启动systemctl start jerry-hermes(root)
systemctl --user start jerry-hermes-bridge(普通用户)
重启systemctl restart jerry-hermes(root)
systemctl --user restart jerry-hermes-bridge(普通用户)
查看日志journalctl -u jerry-hermes -f(root)
journalctl --user -u jerry-hermes-bridge -f(普通用户)
Windows(计划任务 + PowerShell)— 点击展开

任务名:JerryHermesBridge(仅 Bridge;微信网关位于 WSL2 内,请用 WSL 内的 systemd 命令管理)

操作PowerShell 命令
查看状态Get-ScheduledTask -TaskName "JerryHermesBridge" | Select State
停止 BridgeStop-Process -Name jerry-hermes -Force -ErrorAction SilentlyContinue
启动 BridgeStart-ScheduledTask -TaskName "JerryHermesBridge"
重启 BridgeStop-Process -Name jerry-hermes -Force -ErrorAction SilentlyContinue; Start-ScheduledTask -TaskName "JerryHermesBridge"
禁用自启Disable-ScheduledTask -TaskName "JerryHermesBridge"
启用自启Enable-ScheduledTask -TaskName "JerryHermesBridge"
卸载任务Unregister-ScheduledTask -TaskName "JerryHermesBridge" -Confirm:$false
查看 Bridge 日志Get-Content $env:TEMP\jerry-hermes.log -Tail 50 -Wait
查看错误日志Get-Content $env:TEMP\jerry-hermes.err.log -Tail 50
健康检查curl.exe http://127.0.0.1:18803/health
WSL 内重启网关wsl -- bash -c "systemctl --user restart hermes-gateway"

一键升级

升级到最新版 Jerry Hermes Bridge,不影响 Copilot CLI、Hermes Agent、激活码和 MCP 配置。

macOS / Linux:

$curl -fsSL https://mcp-ai-jerry.pages.dev/update-hermes.sh | bash

Windows (PowerShell):

PS>irm https://mcp-ai-jerry.pages.dev/update-hermes.ps1 | iex

脚本会自动下载对应平台二进制、替换旧版、重启后台服务。耗时约 10 秒。如果 WSL 内也部署了 Bridge,请在 WSL 内同样运行 sh 命令。

完全卸载

一键卸载(macOS / Linux):

$curl -fsSL https://mcp-ai-jerry.pages.dev/uninstall-hermes.sh | bash

一键卸载(Windows):

⚠️ 必须以「管理员身份」运行 PowerShell(开始菜单 → 右键 PowerShell → 以管理员身份运行),否则计划任务删除会失败。

PS>irm https://mcp-ai-jerry.pages.dev/uninstall-hermes.ps1 | iex

卸载 Jerry Hermes Bridge + Hermes Agent + 后台服务,不影响 Copilot CLI 和激活信息。
如果在 WSL 内还安装了完整 Hermes(含微信网关),请在 WSL 内运行同样的 sh 卸载命令。

手动卸载命令(点击展开)

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:

# root 安装:停止并移除系统服务
systemctl stop jerry-hermes 2>/dev/null
systemctl disable jerry-hermes 2>/dev/null
rm /etc/systemd/system/jerry-hermes.service 2>/dev/null
systemctl daemon-reload 2>/dev/null

# 普通用户安装:停止并移除用户服务
systemctl --user stop jerry-hermes-bridge 2>/dev/null
systemctl --user disable jerry-hermes-bridge 2>/dev/null
rm ~/.config/systemd/user/jerry-hermes-bridge.service 2>/dev/null
systemctl --user daemon-reload 2>/dev/null
# 删除二进制和配置
rm ~/bin/jerry-hermes
rm ~/bin/hermes
rm -rf ~/.hermes

Windows (PowerShell):

Stop-Process -Name jerry-hermes -Force -ErrorAction SilentlyContinue
Unregister-ScheduledTask -TaskName "JerryHermesBridge" -Confirm:$false
Remove-Item "$env:LOCALAPPDATA\JerryHermes" -Recurse -Force

常见问题

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

请先安装 GitHub Copilot CLI:

$npm install -g @github/copilot

安装后,macOS / 本地终端运行 copilot login;Linux 服务器建议运行 gh auth login -h github.com -p https -w --insecure-storage。也可以用 --skip-copilot 跳过此检查。

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

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

# 1. 检查 Bridge 是否运行
curl -s http://127.0.0.1:18803/health

# 2. 检查 Copilot CLI 认证(Linux 优先 gh)
gh auth status || cat ~/.copilot/config.json

# 3. 查看 Bridge 日志
journalctl -u jerry-hermes -n 50 --no-pager 2>/dev/null || \
journalctl --user -u jerry-hermes-bridge -n 50 --no-pager 2>/dev/null || \
tail -50 /tmp/jerry-hermes.log
macOS 上通过 SSH 启动 Bridge 后报 "No authentication"?

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

$launchctl load ~/Library/LaunchAgents/com.jerry.hermes-bridge.plist
Hermes Agent 安装失败?

确保已安装 Python 3.10+:

$python3 --version

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

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

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