Hermes Agent 入门指南
Nous Research 出品的有记忆的开源 AI 智能体,越用越聪明。66k+ GitHub Stars,能接入微信的自我进化 AI 助手。
概述
Hermes Agent 是 Nous Research 于 2026 年 2 月发布的开源自主 AI 智能体(MIT 许可证)。不是 IDE 代码补全工具,也不是套壳聊天机器人——部署在你自己的服务器上,拥有持久记忆、自动技能创建和多平台接入能力。
- 发布时间:2026 年 2 月
- GitHub Stars:66k+,Fork 9k+,首月斩获 2.2 万 Stars,4 月突破 7 万
- 核心理念:The agent that grows with you — 你用得越久,它就越懂你
- 许可证:MIT,完全开源可审计
- 数据存储:本地
~/.hermes/目录,零遥测、零追踪
三大核心系统
Hermes Agent 通过三个系统实现"自我进化":
| 系统 | 说明 |
|---|---|
| Memory(持久记忆) | 跨会话记住你的偏好、项目和上下文。运行越久越了解你,无需每次重新解释 |
| Skill(自动技能) | 解决难题后自动写下可复用的技能文档,兼容 agentskills.io 开放标准。内置 40+ 技能 |
| Nudge Engine(主动引擎) | 主动提醒、主动学习。不再是被动等待命令,而是会主动推送 |
核心特性
- 多平台消息网关:支持 Telegram、Discord、Slack、WhatsApp、Signal、微信、CLI
- 微信原生接入:装好之后直接在微信里发消息,远程指挥它写周报、搜资料、执行任务
- 定时自动化(Cron):内置 cron 调度器,每日报告、夜间备份、每周审计、晨间简报
- 并行子智能体:生成隔离的子智能体,每个有独立对话和终端,通过 RPC 压缩多步骤流水线
- 浏览器与网页控制:网页搜索、页面提取、完整浏览器自动化(导航、点击、输入、截图)
- 视觉分析 & 图像生成:多模态支持
- 本地终端 / Docker / SSH / Modal 执行后端
模型支持
| 方式 | 说明 |
|---|---|
| Nous Portal | 原生 OAuth 集成 |
| OpenRouter | 通过 API Key 访问 200+ 模型 |
| 自定义 API | 任何 OpenAI 兼容端点,推荐国内用 DeepSeek |
| 本地 vLLM | 完全本地化运行模型 |
国内环境一键部署
官方安装指令在国内大概率卡在 git clone 超时、pip install 挂掉、npm 依赖下不动、Playwright 浏览器下载失败等环节。以下脚本已解决所有坑点。
准备工作
| 依赖 | 版本要求 | 检查命令 |
|---|---|---|
| Python | 3.11+ | python3 --version |
| Git | 不限 | git --version |
| Node.js | 22+ | node --version |
六个坑点及解决方案
| 坑点 | 问题 | 解决方案 |
|---|---|---|
| git clone 超时 | GitHub 443 端口被干扰,报错 GnuTLS recv error (-110) | 走 GitCode 镜像 |
| pip 安装卡住 | PyPI 官方源速度感人 | 换清华源 |
| npm 安装卡住 | npm 官方源慢 | 换淘宝源 |
| Playwright 下载失败 | 浏览器二进制文件被墙 | 设 PLAYWRIGHT_DOWNLOAD_HOST=淘宝镜像 |
| GitHub Token 未配 | Skills Hub 被限速 | 生成 classic token 配进 .env |
| 模型 API 不可用 | Anthropic/Claude 无法直连 | 用 DeepSeek(OpenAI 兼容) |
一键安装脚本
保存为install_hermes_cn.sh,执行./install_hermes_cn.sh:
#!/bin/bashset-eecho"=========================================="echo" Hermes Agent 国内版一键部署脚本"echo"=========================================="# ---------- 1. 设置国内镜像源 ----------echo"[1/8] 配置国内镜像加速..."mkdir-p~/.pipcat>~/.pip/pip.conf<<EOF [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn EOFexportUV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"npmconfigsetregistry https://registry.npmmirror.comexportPLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwrightecho"✓ 镜像源配置完成"# ---------- 2. 安装系统依赖 ----------echo"[2/8] 安装系统依赖..."ifcommand-vapt-get&>/dev/null;thensudoapt-getupdate-qqsudoapt-getinstall-y-qqpython3 python3-pip python3-venvgitcurlnodejsnpmffmpeg ripgrep2>/dev/null||trueelifcommand-vyum&>/dev/null;thensudoyuminstall-ypython3 python3-pipgitcurlnodejsnpmffmpeg ripgrep2>/dev/null||truefiecho"✓ 系统依赖安装完成"# ---------- 3. 安装 uv ----------echo"[3/8] 安装 uv 包管理器..."curl-LsSfhttps://astral.sh/uv/install.sh|shexportPATH="$HOME/.cargo/bin:$PATH"echo"✓ uv 安装完成"# ---------- 4. 克隆仓库(GitCode 镜像) ----------echo"[4/8] 克隆 Hermes Agent 仓库..."HERMES_DIR="$HOME/.hermes"if[-d"$HERMES_DIR/hermes-agent"];thenecho" 目录已存在,跳过克隆"elsemkdir-p"$HERMES_DIR"gitclone https://gitcode.com/GitHub_Trending/he/hermes-agent.git"$HERMES_DIR/hermes-agent"||\gitclone https://ghfast.top/https://github.com/NousResearch/hermes-agent.git"$HERMES_DIR/hermes-agent"||\gitclone https://ghproxy.cn/https://github.com/NousResearch/hermes-agent.git"$HERMES_DIR/hermes-agent"fiecho"✓ 仓库克隆完成"# ---------- 5. 创建虚拟环境并安装 Python 依赖 ----------echo"[5/8] 安装 Python 依赖..."cd"$HERMES_DIR/hermes-agent"uv venv"$HERMES_DIR/venv"source"$HERMES_DIR/venv/bin/activate"uv pipinstall-e.echo"✓ Python 依赖安装完成"# ---------- 6. 安装 Node.js 依赖 ----------echo"[6/8] 安装 Node.js 依赖..."npminstall-gagent-browser2>/dev/null||trueecho"✓ Node.js 依赖安装完成"# ---------- 7. 安装 Playwright 浏览器 ----------echo"[7/8] 安装 Playwright 浏览器..."playwrightinstallchromium2>/dev/null||trueecho"✓ Playwright 安装完成"# ---------- 8. 配置环境变量 ----------echo"[8/8] 配置环境变量..."SHELL_RC=""[-f"$HOME/.bashrc"]&&SHELL_RC="$HOME/.bashrc"[-f"$HOME/.zshrc"]&&SHELL_RC="$HOME/.zshrc"if[-n"$SHELL_RC"]&&!grep-q"hermes""$SHELL_RC"2>/dev/null;thenecho'export PATH="$HOME/.hermes/venv/bin:$PATH"'>>"$SHELL_RC"fiecho""echo"=========================================="echo" ✓ 安装完成!"echo"=========================================="echo""echo" 接下来请执行:"echo" source ~/.bashrc # 刷新环境变量"echo" hermes setup # 初始化配置向导"echo""echo" 推荐配置:"echo" - 大模型:DeepSeek(OPENAI_BASE_URL=https://api.deepseek.com/v1)"echo" - 搜索工具:Tavily(https://app.tavily.com 免费注册)"echo" - GitHub Token:https://github.com/settings/tokens"echo""echo" 验证安装:hermes doctor"echo"=========================================="安装后配置
① 运行初始化向导
source~/.bashrc hermes setup交互式配置界面,按提示选择工具。注意:问到消息平台时,务必勾选14. 📱 weixin以支持微信通道。之后会生成二维码链接,浏览器打开后用微信扫码即可绑定。
② 配置大模型
编辑~/.hermes/.env,推荐国内直连 DeepSeek:
OPENAI_BASE_URL=https://api.deepseek.com/v1OPENAI_API_KEY=sk-你的DeepSeek密钥LLM_MODEL=deepseek-chat③ 开启联网搜索
- 去 app.tavily.com 免费注册,拿到
tvly-开头的 API Key - 去 GitHub Settings > Tokens 生成 classic token(勾选 repo + user 权限)
- 填入
.env:
TAVILY_API_KEY=tvly-你的密钥GITHUB_TOKEN=ghp_你的token微信绑定配置
获取微信凭证
需要企业微信或微信客服 Bot 账号,拿到以下信息:
WEIXIN_ACCOUNT_ID:机器人账号ID,格式如 xxx@im.bot WEIXIN_TOKEN:对应 token,格式 account_id:secret WEIXIN_BASE_URL:接口地址,默认 https://ilinkai.weixin.qq.com WEIXIN_CDN_BASE_URL:CDN 地址,保持默认写入 .env
# ---------- 微信通道 ----------WEIXIN_ACCOUNT_ID=055ec21e2a4b@im.botWEIXIN_TOKEN=055ec21e2a4b@im.bot:你的secretWEIXIN_BASE_URL=https://ilinkai.weixin.qq.comWEIXIN_CDN_BASE_URL=https://novac2c.cdn.weixin.qq.com/c2c# 访问控制WEIXIN_ALLOW_ALL_USERS=trueWEIXIN_DM_POLICY=pairing# pairing=需审批,open=开放,disabled=关闭WEIXIN_GROUP_POLICY=disabled启动微信网关
hermes gateway看到[weixin] Connected说明上线成功。建议后台常驻:
screen-Shermes hermes gateway# Ctrl+A 然后 D 分离新用户配对审批
首次给机器人发消息时收到配对码回复,在服务器执行:
hermes pairing approve weixin YK5Y467L即刻生效,对方可正常对话。
安全命令审批
日常聊天中,Hermes 认为有风险的命令会暂停并发送审批请求,在微信对话框回复:
| 回复 | 作用 |
|---|---|
/approve | 仅本次放行 |
/approve session | 本次会话内同类命令自动放行 |
/approve always | 永远不再拦截 |
/deny | 拒绝执行 |
验收
hermes doctor看到全部绿勾即部署完成。绑定了微信通道后,可以直接在微信发指令:
- “帮我查一下今天北京的天气”→ 联网搜索 + 回复
- “写一个C语言课设图书管理系统”→ 自动写代码 + 编译 + 执行
- “生成周报”→ 定时自动化任务
架构
+------------------+ | 消息网关 | ← 微信 / Telegram / Discord / Slack / Signal / CLI +--------+---------+ | +--------v---------+ | Hermes Agent 核心 | ← Memory + Skill + Nudge Engine +--------+---------+ | +--------v---------+ | 执行后端 | ← 本地终端 / Docker / SSH / Modal +------------------+