微信里直接调用 Grok？Hermes Agent 配置教程来了

目录

1. 这套方案能实现什么？
2. 准备条件
3. 打开 Mac 终端
4. 安装命令行工具
5. 安装 Hermes Agent
6. 启动 Hermes
7. 把 Grok 接入 Hermes
8. 安装微信接入依赖
9. 配置微信入口
10. 配置微信权限
11. 启动微信网关
12. 完整测试流程
13. Hermes 接入 Grok 后的使用场景
14. 常见问题解决
15. 最终效果

一、这套方案能实现什么？

这套方案可以让你在 Mac 上运行 Hermes Agent，然后把 Grok 接进去，最后通过微信和它聊天。

整体流程是：

也就是说，你可以把 Grok 变成一个微信里的 AI 助手。

二、准备条件

该方案你需要准备：

1. 一台 Mac
2. 一个可用的 Grok 订阅账号
3. 一个微信账号
4. 终端 Terminal
5. 稳定网络环境

Grok 账号建议使用 SuperGrok 或 X Premium+，因为 Hermes 接入 Grok 可以依赖 xAI Grok OAuth 授权。

三、打开 Mac 终端

按下：Command + 空格 ，搜索：Terminal ，打开终端。

如果你的系统是中文，也可以搜索：终端。

四、安装命令行工具

第一次使用 Mac 终端开发工具，建议先安装 Apple Command Line Tools。

在终端输入：xcode-select --install

弹出窗口后，点击安装。

安装完成后，验证一下： git --version

如果能显示 git 版本，说明基础环境没问题。

五、安装 Hermes Agent

在终端输入： curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后，刷新终端配置： source ~/.zshrc

然后检查 Hermes 是否安装成功： hermes --help

如果能看到 Hermes 的命令说明，说明安装成功。

也可以运行诊断： hermes doctor

如果有缺少的依赖，Hermes 会提示你怎么处理。

六、启动 Hermes

安装完成后，先直接启动一次 Hermes： hermes

如果想用终端界面模式，可以输入： hermes --tui

第一次启动时，Hermes 可能会让你配置模型。

如果没有自动弹出，也可以手动执行： hermes model

七、把 Grok 接入 Hermes

执行： hermes model

在模型提供商里选择： xAI Grok OAuth 或者类似： xAI Grok OAuth (SuperGrok Subscription)

选择授权 Grok ：

然后 Hermes 会打开浏览器，让你登录 xAI 或 X 账号。

登录完成后，回到终端。

选择 Grok 模型，例如： grok-4.3

配置完成后，测试一下：hermes --tui

输入：hi，你现在是什么模型

如果 Hermes 能正常回复，说明 Grok 已经接入成功。

八、安装微信接入依赖

Hermes 接入微信需要安装额外依赖。

在终端执行： pip install aiohttp cryptography

如果你希望终端里直接显示微信扫码二维码，再执行：pip install hermes-agent[messaging]

如果提示 pip 找不到，可以试试： python3 -m pip install aiohttp cryptography

或者：python3 -m pip install "hermes-agent[messaging]"

九、配置微信入口

执行：hermes gateway setup，然后在平台列表里选择：Weixin / WeChat

接下来 Hermes 会生成一个微信扫码二维码。

用手机微信扫码，然后在手机上确认登录。

成功后，Hermes 会把微信账号凭证保存到：~/.hermes/weixin/accounts/

十、配置微信权限

打开 Hermes 配置文件：nano ~/.hermes/.env

如果你只是自己用，可以先写： WEIXIN_DM_POLICY=open WEIXIN_GROUP_POLICY=disabled

保存方式：Control + O 回车 Control + X

这里建议先关闭群聊，只用私聊测试。

因为 Hermes 的 Weixin 接入通常更适合私聊，不一定能稳定收到普通微信群消息。

十一、启动微信网关

执行： hermes gateway ，这个窗口不要关闭。

它会持续监听微信消息。

然后你打开微信，给刚才绑定的 iLink Bot 发消息： 你好，帮我写一篇朋友圈文案

如果 Hermes 正常返回内容，说明链路已经跑通。

十二、完整测试流程

你可以按这个顺序测试：

第一步，测试 Grok：hermes --tui，输入：你好。

第二步，测试微信网关：hermes gateway

第三步，打开微信私聊发送：帮我写一篇 Grok 接入微信的教程大纲

如果微信能收到回复，说明配置成功。

十三、Hermes 接入 Grok 后的使用场景

接入成功后，你可以直接在微信里调用 Grok。平时有什么问题，不用打开网页，直接像发微信一样问它就行。

1. 写日常文案

发朋友圈、写通知、写简单介绍，都可以直接让它帮你整理。

帮我写一条朋友圈文案，内容是今天开始健身打卡，语气自然一点，不要太夸张。

2. 总结长内容

朋友发来一大段文字、文章、公告，看不完的时候，可以直接让 Grok 帮你提炼重点。

帮我总结一下这段内容，提炼出 3 个重点，用简单的话说明。

3. 改写表达

有些话不知道怎么说得更清楚、更礼貌，可以直接丢给它优化。

帮我把这句话改得更委婉一点：你这个文件发错了，重新发一下。

4. 制定计划

比如学习计划、健身计划、工作安排、旅行行程，都可以让它帮你整理。

帮我做一个一周健身计划，每天 30 分钟，适合新手。

5. 解决生活问题

遇到不会处理的小问题，也可以直接问。

Mac 电脑突然连不上 Wi-Fi，可能是什么原因？怎么排查？

6. 整理待办清单

把一堆零散的事情发给它，让它帮你整理成清晰的任务列表。

帮我把下面这些事情整理成待办清单，并按重要程度排序：买菜、交房租、改文章、回复客户、整理电脑文件。

7. 辅助学习

学习英语、写作文、看资料、理解概念时，都可以让它用更简单的话解释。

帮我解释一下“人工智能”是什么意思，用小白能听懂的话说。

十四、常见问题解决

1. hermes: command not found

执行：source ~/.zshrc

如果还不行，执行：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc

再检查：hermes --help

2. curl 安装失败

检查网络，或者换成原始 GitHub 安装方式：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

3. Grok 授权失败

重新执行：hermes model

重新选择 xAI Grok OAuth，然后重新登录。

如果浏览器没有自动打开，可以复制终端里的登录链接到浏览器打开。

4. 微信扫码后没反应

重新执行：hermes gateway setup

重新选择 Weixin / WeChat，再扫码。

同时确认手机微信已经点击确认登录。

5. 缺少 aiohttp 或 cryptography

执行：python3 -m pip install aiohttp cryptography

然后重新启动：hermes gateway

6. 私聊可以，微信群不行

这是正常现象。

Hermes 的微信接入使用的是 iLink Bot 身份，不等于完整控制你的个人微信号。

很多情况下，它只能稳定处理私聊，普通微信群消息或 @ 消息不一定会推送到 Hermes。

所以建议： 先用私聊，不要一开始就折腾微信群。

7. 想停止 Hermes

在终端按：Control + C

即可停止当前运行的 Hermes Gateway。

SuperGrok 官方订阅升级服务：http://cnmGrok.com

十五、最终效果

配置完成后，你就可以在 Mac 上运行 Hermes，用 Grok 作为大模型，然后直接在微信里和它聊天。

最大的好处是，不用每次打开 Grok 网页，也不用一直守着终端。

你只需要在微信里发一句话，Hermes 就会调用 Grok 帮你处理。