Hermes Agent 入门指南
2026/6/10 9:26:08 网站建设 项目流程

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 浏览器下载失败等环节。以下脚本已解决所有坑点。

准备工作

依赖版本要求检查命令
Python3.11+python3 --version
Git不限git --version
Node.js22+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

③ 开启联网搜索

  1. 去 app.tavily.com 免费注册,拿到tvly-开头的 API Key
  2. 去 GitHub Settings > Tokens 生成 classic token(勾选 repo + user 权限)
  3. 填入.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 +------------------+

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询