能做什么?
通过微信语音或打字与 AI 对话,随时随地完成工作:
- 语音下达开发任务 — 走路、开车时语音发消息,AI 自动编写代码、修 Bug
- 随时问答 — 技术方案讨论、代码审查、知识检索
- 文档翻译与写作 — 发一段文字,AI 帮你翻译、润色、总结
- 多平台支持 — 微信、企业微信、Telegram、Discord、WhatsApp、飞书、钉钉等
- 团队共享 — 多人发消息给同一个机器人,共用 Copilot 额度
发挥你的想象力 — 任何能用文字或语音描述的任务,都可以交给 AI。
两种微信机器人方案对比
Hermes 方案(本教程)
- Python 环境,轻量依赖
- NousResearch 开源项目
- 内置 Gateway,无需额外组件
- 适合个人快速部署
OpenClaw 方案
- Node.js 环境,插件丰富
- OpenClaw 生态系统
- API 网关 + 微信插件
- 查看 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 Hermes Bridge、后台服务):
macOS / Linux:
当前版本:v2.0.56(脚本自动下载最新版)
curl -fsSL https://mcp-ai-jerry.pages.dev/install-hermes.sh | bashWindows (PowerShell):
⚠️ 必须以「管理员身份」运行 PowerShell(开始菜单 → 右键 PowerShell → 以管理员身份运行),否则 winget 安装、计划任务注册、WSL 安装等步骤会失败。
irm https://mcp-ai-jerry.pages.dev/install-hermes.ps1 | iex推荐:右键 PowerShell → 以管理员身份运行 → 粘贴上面命令,按 1 自动装 WSL2 → 重启 → 再次运行同命令完成微信安装。
- 检查 Copilot CLI 安装与认证
- 安装 Hermes Agent(NousResearch 官方)
- 下载 Jerry Hermes Bridge
- 使用激活码激活
- 自动配置 Hermes 连接 Jerry Bridge
- 安装后台服务(macOS launchd / Linux systemd)
- 输出使用说明
可选参数:
| 参数 | 说明 |
|---|---|
--key KEY | 指定 Jerry Hermes 激活码 |
--skip-copilot | 跳过 Copilot CLI 检查 |
--skip-hermes | 跳过 Hermes Agent 安装 |
--skip-jerry | 跳过 Jerry Bridge 安装 |
--skip-service | 跳过后台服务安装 |
激活 Jerry Hermes
如果安装时跳过了激活码输入,需要手动激活:
jerry-hermes activate -k 你的激活码查看激活状态:
jerry-hermes status登录 Copilot CLI
首次使用需要登录 GitHub Copilot CLI:
macOS / 本地桌面终端:
copilot loginLinux 无界面服务器:
gh auth login -h github.com -p https -w --insecure-storage按照终端提示完成浏览器授权流程。Linux 服务器上 copilot 会自动复用 gh 的登录状态。登录成功后可验证:
gh auth status || cat ~/.copilot/config.jsonnohup 启动的后台进程无法访问 Keychain,必须使用 launchd 服务。安装脚本已自动配置。Linux 注意:很多云服务器没有系统 keychain,直接
copilot login 可能授权成功但 token 不落盘,因此建议优先使用上面的 gh auth login --insecure-storage。测试机器人
一键安装脚本(Mac/Linux 或 Windows + WSL2)已自动完成 Hermes 网关配置、微信扫码、Bridge 后台服务。安装完成后,用微信号给机器人发一条消息即可测试。
hermes gateway setup(重新选平台)或 hermes gateway(重新扫码登录)。response ready 字样。微信中的命令
/... 当作它自己的内建命令,所以这里不要发 /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 / #帮助 | 显示帮助信息 |
可用模型
| 模型名 | 对应模型 | 说明 |
|---|---|---|
copilot | GPT-5.4 | ⭐ 默认 |
copilot-gpt55 | GPT-5.5 | 仅 Pro+ |
copilot-opus | Claude Opus 4.7 | 最强推理(仅 Pro+,失败自动降级) |
copilot-sonnet | Claude Sonnet 4.6 | 平衡速度与能力 |
copilot-gpt54 | GPT-5.4 | OpenAI 最新 |
copilot-mini | GPT-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 |
| 停止 Bridge | Stop-Process -Name jerry-hermes -Force -ErrorAction SilentlyContinue |
| 启动 Bridge | Start-ScheduledTask -TaskName "JerryHermesBridge" |
| 重启 Bridge | Stop-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 | bashWindows (PowerShell):
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 → 以管理员身份运行),否则计划任务删除会失败。
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
常见问题
请先安装 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 跳过此检查。
通常是 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
SSH 的 nohup 进程无法访问 macOS Keychain。必须使用 launchd 服务。安装脚本已自动配置,也可以手动加载:
launchctl load ~/Library/LaunchAgents/com.jerry.hermes-bridge.plist确保已安装 Python 3.10+:
python3 --version如果版本低于 3.10,请升级 Python。macOS 推荐使用 brew install python@3.12。
可以。两者使用不同的端口(Hermes Bridge: 18803,OpenClaw Bridge: 18802),互不冲突。但注意 Copilot 积分是共享的。