Hermes Agent 是由 Nous Research 打造的自进化 AI 助手，内置技能学习循环，能在完成任务后自动总结经验并越用越聪明。与普通聊天机器人不同，它支持个人微信接入，能在 5 美元的 VPS 上运行，实现 7×24 小时待命。
苏米注：我实际测试过 Hermes 和 OpenClaw，两者定位不同。Hermes 更适合个人用户快速上手，10 分钟内完成部署并接入微信；OpenClaw 则更适合需要深度定制的企业场景。本文专注于 Hermes 的完整部署流程。
在开始之前，请确保满足以下要求：
- 操作系统：Linux（Ubuntu/Debian/CentOS）、macOS、WSL2（Windows 用户）、Android（Termux）
- 硬件要求：能联网的电脑或服务器
- 微信账号：个人微信账号（用于扫码接入）
- API Key：大模型 API Key（OpenRouter、OpenAI、Anthropic、DeepSeek、Kimi、智谱等均可）
技术要求：Hermes 要求模型上下文至少 64K tokens，目前主流模型都能满足。
步骤一：安装 Hermes Agent
不同系统的安装方式略有区别，请根据系统选择对应方式。
Linux / macOS / Android（Termux）
- 执行官方一键安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash苏米注：如果在国内访问 GitHub 超时，可以使用镜像源，详见文末常见问题。
- 安装完成后，重新加载 shell 配置：
source ~/.bashrc # 如果用的是 zsh，则执行： source ~/.zshrc
Windows（必须先装 WSL2）
重要：原生 Windows 不能直接运行 Hermes，必须先安装 WSL2（Windows Subsystem for Linux）。
- 以管理员身份打开 PowerShell，执行：
wsl --install - 安装完成后重启电脑，按提示设置 Ubuntu 用户名和密码
- 打开 WSL2 终端（Ubuntu），执行和 Linux 一样的安装命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash - 重新加载配置：
source ~/.bashrc
苏米注：WSL2 里的 Hermes 默认只能访问 WSL2 文件系统。如果想让它操作 Windows 上的项目文件，建议把项目放在 WSL2 的 /home/用户名/ 目录下，或通过 /mnt/c/ 这样的路径访问。
验证安装
无论在哪个系统，安装完成后都可以执行：
hermes --version看到版本号即表示安装成功。
步骤二：配置大模型提供商
Hermes 的强大离不开底层大模型。使用 hermes setup 进行配置。
苏米注：使用脚本安装完成后，一般会有两个引导选项：快速设置（quick setup）和全量设置（full setup）。这里选择全量设置以获得更精细的控制。
- 启动配置向导：
hermes setup - 选择
full setup（全量设置） - 模型配置：如果没有自己的提供商，选择自定义配置，会引导输入 baseUrl、API Key 等信息
- TTS 使用默认的 Edge TTS
- Terminal backend 选择
local（默认） - Max iterations（最大循环次数）设置为 200（高一些，因为有些任务逻辑链条非常长）
- Tool progress mode 选择
all（默认） - Compression threshold（上下文压缩阈值）设为 0.85
- Reset mode（重置会话）选择
Never auto-reset（可通过/reset命令手动重置） - 通讯平台选择
Weixin（微信） - 工具全部选择
- Provider 选择
Local Browser - Image Generation (FAL.ai)：如果没有可跳过，后续再配置
- Search Provider 选择
Firecrawl Self-Hosted（免费，但需要本地部署，可先跳过后续再配置）
配置完成后，系统会自动保存设置。
步骤三：连接个人微信（核心步骤）
Hermes 的微信接入是通过微信官方的 iLink Bot API，支持个人微信号扫码登录。
重要提醒：这是给个人微信用的。如果要对接企业微信，请参考 Hermes 官方文档的 WeCom 配置指南。
3.1 安装微信网关依赖
微信适配器需要 aiohttp 和 cryptography 两个包，另外建议装上 qrcode，这样终端能直接显示二维码，不用复制链接。
pip install aiohttp cryptography
# 可选：终端二维码显示
pip install qrcode踩坑记录：如果提示 externally-managed-environment 错误，可以添加 --break-system-packages 参数，或使用虚拟环境。
3.2 运行网关配置向导
- 启动配置向导：
hermes gateway setup - 在菜单中选择 "Weixin / WeChat"（微信）
- 向导会自动完成以下操作：
- 向 iLink Bot API 申请一个登录二维码
- 在终端里显示二维码（或给出扫码链接）
- 等待用手机微信扫码并确认登录
- 自动保存账号凭据到
~/.hermes/weixin/accounts/
- 当看到终端输出
微信连接成功，account_id=your-account-id时，说明微信已成功接入
3.3 启动网关服务
- 安装网关服务：
hermes gateway install - 启动服务：
hermes gateway start - 系统选择：
- Windows 用户：选择 user service
- macOS/Linux 用户：可选择 systemd service
3.4 配置微信账号环境变量
虽然向导已经保存了凭据，但建议在 ~/.hermes/.env 里确认有以下配置（一般会自动添加）：
WEIXIN_ACCOUNT_ID=your-account-id可选配置项：
# 私信权限策略：open（任何人可发）/ allowlist（白名单）/ disabled（关闭私信）/ pairing（配对模式）
WEIXIN_DM_POLICY=open
# 如果设为 allowlist，需要指定允许的用户 ID
WEIXIN_ALLOWED_USERS=user_id_1,user_id_2
# 群组权限策略：open / allowlist / disabled（默认是 disabled，不响应任何群消息）
WEIXIN_GROUP_POLICY=disabled
# 默认"主频道"，用于定时任务（Cron）推送消息
WEIXIN_HOME_CHANNEL=chat_id
WEIXIN_HOME_CHANNEL_NAME=Home苏米注：为什么群消息默认关闭？个人微信号通常加了很多群，为避免 AI 在群里乱回消息，Hermes 默认把群组策略设成 disabled。如果想让 AI 在特定群里工作，手动改成 allowlist 并填写群 ID 即可。
步骤四：设置后台服务（长期运行）
如果希望 Hermes 一直在线，不用开着终端窗口，可以把它注册为系统服务。
macOS / Linux 用户
# 用户服务
hermes gateway install
hermes gateway start
# Linux 如需开机自启的系统级服务
sudo hermes gateway install --system
sudo hermes gateway start常用管理命令：
hermes gateway status # 查看运行状态
hermes gateway stop # 停止服务
hermes gateway restart # 重启服务Windows 用户（使用 tmux）
- 安装 tmux（如果还没装）：
sudo apt update && sudo apt install tmux - 创建 tmux 会话，在里面运行网关：
tmux new -s hermes -d 'hermes gateway run' - 关掉终端窗口，网关继续运行
- 想查看日志时，重新打开终端，执行：
tmux attach -t hermes - 想停止网关：在 tmux 会话里按
Ctrl+C，然后输入exit
微信里的功能与指令
接入微信后，Hermes 支持丰富的功能：
| 功能 | 说明 |
|---|---|
| 文字对话 | 支持多轮上下文、记忆恢复 |
| 图片收发 | 可接收用户发的图，也能生成/发送图片 |
| 文件传输 | 支持文档、PDF、代码文件等 |
| 语音消息 | 支持语音输入（如启用语音插件）和 TTS 回复 |
| Markdown 优化 | 自动把 Markdown 表格、代码块转成微信可读格式 |
| 消息分片 | 超长回复会自动拆成多条消息，避免被截断 |
| 打字状态 | 处理中会在微信聊天顶部显示"对方正在输入..." |
微信常用指令
在微信聊天窗口里，可以直接发送以下指令：
| 指令 | 作用 |
|---|---|
/new 或 /reset |
开启新对话，清空上下文 |
/model |
查看或切换当前模型 |
/tools |
查看当前启用的工具 |
/personality pirate |
切换人格（比如"海盗模式"） |
/compress |
压缩上下文，节省 token |
/skills |
浏览已安装的技能 |
常见问题与排错
问题 1：安装脚本执行失败
可能原因：网络不通、缺少 curl、bash 权限不足。
解决方案：确保能访问 GitHub，或在 WSL2/Linux 环境下重试。Windows 原生系统不支持，请务必使用 WSL2。
问题 2：Weixin startup failed: aiohttp and cryptography are required
解决方案：
pip install aiohttp cryptography问题 3：Weixin startup failed: WEIXIN_ACCOUNT_ID is required
解决方案：运行 hermes gateway setup 重新完成 QR 登录，或手动在 ~/.hermes/.env 里补 WEIXIN_ACCOUNT_ID。
问题 4：二维码扫了没反应 / 超时
排查步骤：
- 检查手机网络，确保微信能正常联网
- 二维码会自动刷新 3 次，如果一直超时，可能是本地网络到 ilinkai.weixin.qq.com 不稳定
- 终端没显示二维码时，可以复制二维码上方的 URL，用浏览器打开再扫
问题 5：AI 不回复群消息
这是正常设计。默认 WEIXIN_GROUP_POLICY=disabled。如需开启：
# 允许所有群（慎用）
WEIXIN_GROUP_POLICY=open
# 或只允许特定群
WEIXIN_GROUP_POLICY=allowlist
WEIXIN_GROUP_ALLOWED_USERS=group_id_1,group_id_2问题 6：AI 不回复私信
检查 WEIXIN_DM_POLICY：
- 如果设为
allowlist，发消息的人必须在WEIXIN_ALLOWED_USERS里 - 如果设为
disabled，所有私信都会被忽略
问题 7：出现 errcode=-14（Session expired）
解决方案：微信登录 session 过期了，重新运行 hermes gateway setup，扫码登录即可。
问题 8：提示 "Another local Hermes gateway is already using this Weixin token"
原因：每个微信 token 只能被一个网关实例使用。
解决方案：检查是否有其他终端或服务器在运行 Hermes gateway，先停止旧的再启动新的。
进阶玩法（可选）
语音模式
安装语音依赖后，Hermes 可以在微信里发语音回复：
pip install "hermes-agent[voice]"
pip install faster-whisper # 本地免费语音识别（可选）在微信对话里发 /voice on 即可开启。
定时任务（Cron）
可以直接在微信里对 Hermes 说："每天早上 9 点，给我发一份 AI 领域的新闻摘要。"
Hermes 会自动生成一个 cron 定时任务，并在设定时间把结果推送到微信主频道。
技能市场
Hermes 支持安装和创作技能（Skills），类似给 AI 装插件：
hermes skills search kubernetes
hermes skills install openai/skills/k8s也可以在微信里直接发 /skills 查看已加载的技能。
总结
把 Hermes Agent 接入微信，相当于在手机里放了一个 24 小时在线的超级助手。无论是在地铁上发消息让它查资料，还是在群里让它帮忙整理会议纪要，它都能胜任。
完整部署流程：
- 按系统选择安装方式（Windows 用户先装 WSL2）
- 使用
hermes setup配置大模型 - 使用
hermes gateway setup扫码连微信 - 使用
hermes gateway start启动服务
苏米注：整个流程通常在 10 分钟内完成。如果在安装或连接微信的过程中遇到问题，可以去 Hermes 官方 Discord 或 GitHub Discussions 寻求帮助。