苏米注：Hermes Agent 是由 Nous Research 打造的自进化 AI 助手，内置技能学习循环，能在完成任务后自动总结经验。今天这篇教程，我来一步步演示如何安装 Hermes Agent 并接入个人微信。
一、Hermes Agent 是什么
Hermes Agent 是一款支持多平台的 AI 助手，主要特性包括：
- 7×24 小时待命，支持 Telegram、Discord、Slack、WhatsApp、Signal 和个人微信
- 能操作终端、读写文件、搜索网页、调用 MCP 工具、定时执行任务
- 支持在 $5 的 VPS 上运行，也可部署在云端
- 要求模型上下文至少 64K tokens，主流大模型均可满足
二、环境准备
操作系统要求：
- Linux（Ubuntu / Debian / CentOS 等）
- macOS
- WSL2（Windows 用户需先安装 WSL2）
- Android（通过 Termux）
需要提前准备：
- 一台能联网的电脑或服务器
- 个人微信账号（用于后续扫码接入）
- 大模型 API Key（OpenRouter、OpenAI、Anthropic、DeepSeek、Kimi、智谱等）
三、安装 Hermes Agent
Linux / macOS / Android（Termux）
执行官方一键安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完成后，重新加载 shell 配置：
source ~/.bashrc
# 如果使用 zsh，执行：source ~/.zshrcWindows（必须先装 WSL2）
苏米注：原生 Windows 不能直接运行 Hermes，必须通过 WSL2。这是很多新手容易踩的坑。
Step 1：安装 WSL2
以管理员身份打开 PowerShell，执行：
wsl --install安装完成后重启电脑，按提示设置 Ubuntu 用户名和密码。
Step 2：在 WSL2 里安装 Hermes
打开 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 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
- Tools：全部选择
- Provider：选择 Local Browser
- Search Provider：选择 Firecrawl Self-Hosted（免费，需本地部署，可先跳过）
五、连接个人微信（核心步骤）
苏米注：Hermes 的微信接入是通过微信官方的 iLink Bot API，支持个人微信号扫码登录，不是企业微信。
Step 1：安装微信网关的 Python 依赖
pip install aiohttp cryptography
# 可选：终端二维码显示
pip install qrcodeStep 2：运行网关配置向导
hermes gateway setup在菜单中选择 "Weixin / WeChat"。向导会：
- 向 iLink Bot API 申请登录二维码
- 在终端显示二维码（或给出扫码链接）
- 等待手机微信扫码并确认登录
- 自动保存账号凭据到 ~/.hermes/weixin/accounts/
看到"微信连接成功，account_id=your-account-id"即表示接入成功。
Step 3：启动网关服务
hermes gateway install
hermes gateway start最佳实践：
- Windows 用户选择 user service
- Mac/Linux 用户选择 systemd service
Step 4：配置环境变量（可选）
在 ~/.hermes/.env 中添加：
WEIXIN_ACCOUNT_ID=your-account-id
# 私信权限策略：open（任何人可发）/ allowlist（白名单）/ disabled（关闭）
WEIXIN_DM_POLICY=open
# 群组权限策略（默认 disabled，避免 AI 在群里乱回消息）
WEIXIN_GROUP_POLICY=disabled
# 默认"主频道"，用于定时任务推送
WEIXIN_HOME_CHANNEL=chat_id
WEIXIN_HOME_CHANNEL_NAME=Home六、后台运行配置
将网关注册为系统服务，实现长期运行：
# 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 qrcode实践经验：如果遇到 pip 权限问题，可以加上 --user 参数：
pip install --user aiohttp cryptography qrcode