Hermes Agent 保姆级安装教程：从 0 到 1 搭建自己的 AI 微信机器人

文章目录项目地址官方安装方式源码安装方式创建安装目录复制源码目录验证 Hermes 命令是否可用配置文件在哪里运行配置向导选择命令运行环境配置消息平台配置微信私聊权限配置 Home Channel安装 Gateway 后台服务选择服务运行方式配置工具能力Terminal ProcessesFile OperationsMemoryCron JobsComputer Use配置浏览器自动化两个容易卡住的扩展功能Computer Use 安装超时Image Generation 登录 Nous Portal配置 TTS配置联网搜索验证安装是否成功检查环境启动命令行助手查看网关状态查看网关日志重新配置修改模型修改消息平台修改工具配置常用验证命令汇总测试模型测试联网搜索测试微信机器人切换模型总结最近折腾了一下 Hermes Agent整体感觉是它不只是一个终端聊天工具更像一个可以接模型、接工具、接微信的 Agent 框架。这篇文章把我完整跑通的过程记录下来包含Hermes Agent 安装模型和 API Key 配置联网搜索配置微信机器人接入systemd 后台服务常用验证命令模型切换和一些踩坑点我这里演示的是源码安装方式。官方一键脚本当然也能用但国内服务器下载 GitHub、PyPI、uv、Node.js 依赖时经常会比较慢。项目地址项目地址https://github.com/NousResearch/hermes-agent官方文档https://hermes-agent.nousresearch.com/docs/zh-Hans/getting-started/installation支持环境Linux / macOS / WSL2官方安装方式官方推荐的一键安装命令如下curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash安装完成后需要重新加载 shell 配置。先看一下当前 shellecho$SHELL如果输出的是 bash执行source~/.bashrc如果输出的是 zsh$echo$SHELL/bin/zsh则执行source~/.zshrc官方脚本慢主要是因为后续会下载这些内容GitHub PyPI uv 依赖源 Rust 相关组件 Node.js 相关依赖网络好的环境可以直接用官方脚本如果下载经常超时建议用下面的源码安装方式。源码安装方式如果 GitHub 下载慢可以使用 GitCode 同步仓库gitclone https://gitcode.com/GitHub_Trending/he/hermes-agent.git官方文档也可以一起打开备用https://hermes-agent.nousresearch.com/docs/我建议把 Hermes Agent 放到固定目录避免后面移动项目目录导致命令找不到。这里统一放到~/.hermes下面。创建安装目录mkdir-p~/.hermes复制源码目录如果项目下载在用户主目录下可以执行cp-r~/hermes-agent ~/.hermes/hermes-agent进入项目目录并执行安装脚本cd~/.hermes/hermes-agentbashscripts/install.sh安装完成后运行hermes命令会进入配置向导。这里可以输入1进入快速设置模式。最后重新加载环境变量source~/.zshrc如果项目已经放在固定目录比如/root/hermes-agent就不用再复制一遍cd/root/hermes-agentbashscripts/install.sh复制到~/.hermes不是必须步骤只是方便后续管理和升级。确定源码目录不会被移动或删除的话直接在当前目录执行安装脚本也可以。scripts/install.sh会自动处理 Python 依赖、虚拟环境、Node.js 等配置正常情况下不用手动补依赖。验证 Hermes 命令是否可用安装完成后先看版本和帮助信息hermes--versionhermes--help启动 Hermeshermes如果还没配置模型启动后大概率会报错。退出交互界面exit配置文件在哪里Hermes 默认配置在cat~/.hermes/config.yaml这里注意一点Hermes 的默认模型不是从.env里读而是从~/.hermes/config.yaml里读。我这里看到默认模型是默认模型anthropic/claude-opus-4.6 Providerauto 默认走 OpenRouter 接口OpenRouter 是一个模型聚合平台可以接 Claude、GPT、Gemini、DeepSeek、Qwen、GLM、Mistral、Llama 等模型。只要 OpenRouter 支持Hermes 里一般也能配置。但是.env里的OPENROUTER_API_KEY默认是注释状态没有配置 Key。所以启动失败的链路大概是读取 config.yaml ↓ 默认模型是 claude-opus-4.6 ↓ providerauto ↓ 尝试寻找 OPENROUTER_API_KEY ↓ 没有找到 ↓ No inference provider configured因此界面上虽然显示了claude-opus-4.6但模型实际还不能用。接下来需要配置 Provider、API Key 和模型。运行配置向导执行hermes setup这里会出现配置模式选择。三个选项大概是这样选项说明适合场景Quick Setup (Nous Portal)使用 Nous 官方账号登录OAuth 授权自动配置模型不用手动填 API Key快速体验Full Setup手动选择 Provider、填写 API Key、选择模型支持 OpenAI Compatible推荐适合长期使用Blank Slate不做向导配置后续自己改配置文件熟悉配置结构的人我这里选择 Tencent TokenHub因为我手里的国产模型免费额度基本用完了腾讯云 TokenHub 还有一些额度。按提示输入腾讯云 TokenHub 的密钥。后面一些参数直接回车使用默认值即可。模型这里我选择glm-5.2。如果目标模型不在默认列表里可以选择手动输入模型名。选择命令运行环境接下来会询问 Hermes 执行命令时使用什么运行环境。常见选项如下选项说明推荐Local在当前服务器直接执行命令⭐⭐⭐⭐⭐Docker在 Docker 容器中执行⭐⭐⭐⭐ModalModal 云沙箱⭐⭐SSH远程机器执行⭐⭐⭐Daytona云开发环境⭐⭐SingularityHPC 集群环境⭐个人服务器或测试环境直接保持默认的Local就行。配置消息平台这个步骤是配置 Hermes 的消息平台接入。也就是说Hermes 不只能在终端里聊天还可以接入微信、QQ、钉钉、飞书、Slack 等平台。如果你只想在本机终端使用hermes这里一个都不用选直接回车跳过。常见平台如下平台用途WeChat微信机器人QQ BotQQ 机器人Yuanbao腾讯元宝接入DingTalk钉钉机器人Feishu / Lark飞书机器人DiscordDiscord BotSlackSlack BotTeams微软 TeamsEmail邮件收发SignalSignal BotLINELine Botntfy手机推送通知我这里要测试微信机器人所以选择WeChat。用空格选中Esc取消。确认配置微信机器人选择Y。向导会给出一个链接把它复制到本地电脑浏览器打开。打开后用微信扫码。配置微信私聊权限扫码后会配置微信私聊权限也就是谁可以通过微信私聊你的 Hermes。首次安装建议选Use DM pairing approval (recommended)这个选项比较稳陌生人不能直接使用你的 Hermes也不会莫名其妙消耗模型额度。授权流程大概是微信用户私聊 ↓ Hermes 收到请求 ↓ 管理员确认授权 ↓ 用户获得访问权限 ↓ 正常与 Hermes 对话如果是公司内部部署可以选择Only allow listed user IDs然后把允许访问的用户写成白名单例如wxid_admin wxid_dev01 wxid_dev02不太建议选择Allow all direct messages这个选项会让所有添加机器人的用户都可以直接使用个人部署时风险比较大。几个选项对比如下选项说明推荐指数适用场景Use DM pairing approval (recommended)用户首次私聊时需要管理员确认授权⭐⭐⭐⭐⭐个人用户、开发者、家庭使用Allow all direct messages所有微信用户都能直接对话⭐⭐开放测试环境Only allow listed user IDs只允许白名单用户访问⭐⭐⭐⭐企业内部、团队协作Disable direct messages禁止微信私聊 Hermes⭐⭐⭐只允许群聊或其他平台访问下一步是微信群聊响应配置。我这里的配置结果是配置项当前选择效果私聊Allow all direct messages所有微信好友都可以直接与 Hermes 对话群聊Disable group chats微信群消息 Hermes 不响应微信接入已配置微信可以连接 Hermes如果是正式使用我更建议私聊选择审批模式而不是全开放。配置 Home Channel后面会询问是否将当前微信账号设置为 Hermes 的 Home Channel。Home Channel 可以理解为 Hermes 的主通知频道。后续某些状态通知、任务结果可能会发到这里。安装 Gateway 后台服务接下来会询问是否将 Hermes Gateway 安装为 systemd 服务。如果选择YHermes 会创建类似下面的服务文件/etc/systemd/system/hermes-gateway.service并执行systemctlenablehermes-gateway systemctl start hermes-gateway这样服务器重启后微信机器人会自动上线Hermes Gateway 也会自动启动。如果这里选择n每次服务器重启后都要手动启动hermes gateway长期挂微信机器人建议安装成 systemd 服务。选择服务运行方式Hermes Gateway 后台服务有几种运行方式。选项说明推荐User service当前用户级 systemd 服务不需要 sudo 权限⭐⭐⭐System service系统级 systemd 服务开机自启最稳定⭐⭐⭐⭐⭐Skip service install for now暂不安装服务⭐⭐User service适合个人电脑、开发机、笔记本systemctl--userstatus hermes-gatewaySystem service更适合云服务器、VPS、生产环境systemctl status hermes-gateway我这里选择System service后续管理命令如下# 查看状态systemctl status hermes-gateway# 启动systemctl start hermes-gateway# 停止systemctl stop hermes-gateway# 重启systemctl restart hermes-gateway# 开机自启systemctlenablehermes-gateway接下来会问 systemd 服务使用哪个 Linux 用户运行。我这里直接输入root然后选择Y启动服务。配置工具能力Hermes 的 Tools 配置界面里带✓的表示启用空白表示禁用。官方默认开启了大部分 Agent 常用能力。工具功能建议Web Search Scraping联网搜索、网页抓取✅ 开启Browser Automation浏览器自动操作✅ 开启Terminal Processes执行终端命令✅ 开启File Operations文件读写、搜索、补丁✅ 开启Code Execution执行代码✅ 开启Vision / Image Analysis图片识别分析✅ 开启Video Analysis视频分析按需Image GenerationAI 生成图片✅ 开启Video GenerationAI 生成视频按需X(Twitter) Search搜索 X 平台内容国内一般不用Text-to-Speech文本转语音✅ 开启Skills技能管理✅ 开启Task Planning任务规划✅ 开启Memory长期记忆✅ 开启Context Engine上下文引擎新手可关闭Session Search搜索历史会话✅ 开启Clarifying Questions自动追问补充信息✅ 开启Task Delegation多 Agent 协作✅ 开启Cron Jobs定时任务✅ 开启Home Assistant智能家居控制按需SpotifySpotify 音乐控制按需Yuanbao腾讯元宝集成按需Computer Use操作桌面系统✅ 开启我这里基本保持默认。几个能力可以重点看一下。Terminal Processes开启后模型可以执行终端命令例如lspwdps-efsystemctl status这是 Agent 最核心的能力之一。File Operations开启后可以读取文件、修改文件、批量替换代码、生成补丁。写代码、改配置时很有用。Memory开启后Hermes 可以记住项目、常用命令和偏好配置。它更像长期记忆不是每次对话都从零开始。Cron Jobs这个功能挺适合服务器场景例如每天早上 8 点推送服务器状态 每天检查磁盘空间 每天汇总 Git 提交Computer Use类似 Claude Computer Use可以打开浏览器、点击按钮、输入内容、操作桌面。不过如果你只是部署在 Linux 云服务器上这个能力大部分时候用不上。配置浏览器自动化如果前面开启了✓ Browser AutomationHermes 会继续让你选择浏览器自动化的 Provider。选项说明是否收费推荐Local Browser本机 Chromium 浏览器免费⭐⭐⭐⭐⭐Nous SubscriptionNous 官方云浏览器订阅⭐⭐⭐Camofox反检测 Firefox 浏览器免费⭐⭐⭐Browser UseBrowser Use 云服务付费⭐⭐BrowserbaseBrowserbase 云浏览器付费⭐⭐FirecrawlFirecrawl 云抓取服务付费⭐⭐Skip跳过配置-⭐⭐⭐普通用户直接选默认的Local Browser就可以。后面 Hermes 就可以完成这类任务打开网页 登录网站 点击按钮 填写表单 滚动页面 抓取内容 截图例如帮我打开 github.com 搜索 hermes-agent 查看 Star 数量Hermes 会调用本地 Chromium 执行。两个容易卡住的扩展功能Computer Use 安装超时Hermes 会尝试安装cua-driver用来实现桌面自动化能力。它的安装脚本在 GitHubhttps://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh国内服务器可能会遇到下载超时cua-driver installer download failed timed out after 120 seconds如果你只是用 Hermes 做模型对话、代码执行、文件操作、联网搜索和微信机器人这个失败一般不影响核心功能。Image Generation 登录 Nous Portal配置图片生成时Hermes 可能会询问Log in to Nous Portal now? [Y/n]:Nous Portal 是 Nous 官方云服务用来接图片生成、云浏览器等高级能力。如果暂时不需要 AI 绘图可以输入n先跳过后续需要再单独配置。配置 TTS这个步骤是配置 Text-to-Speech也就是文本转语音。如果开启Hermes 的文字回复可以转换成语音播放或者发送语音消息。提供商类型是否收费特点推荐Microsoft Edge TTS云端免费音质不错无需 API Key⭐⭐⭐⭐⭐Nous Subscription云端订阅Nous 官方服务⭐⭐⭐OpenAI TTS云端付费OpenAI 官方语音⭐⭐⭐⭐xAI TTS云端付费Grok 语音⭐⭐⭐ElevenLabs云端付费行业顶级拟真语音⭐⭐⭐⭐⭐Mistral Voxtral云端付费多语言支持较好⭐⭐⭐Google Gemini TTS云端付费Gemini 语音能力⭐⭐⭐KittenTTS本地免费轻量级本地运行⭐⭐⭐Piper本地免费支持 40 种语言⭐⭐⭐⭐Skip跳过-后续再配置⭐⭐⭐如果没有语音需求保持默认或跳过即可。配置联网搜索接下来是 Web Search也就是 Hermes 执行联网搜索时使用哪个搜索服务。例如你在 Hermes 里输入帮我搜索 Spring Boot 3 最新版本 帮我查一下 OpenAI 最近发布了什么 帮我总结这个网站内容Hermes 就会调用这里配置的搜索能力。常见搜索 Provider 如下搜索引擎类型是否收费功能推荐Nous Subscription官方托管订阅搜索 网页提取⭐⭐⭐Firecrawl Self-Hosted自建免费搜索 抓取⭐⭐⭐⭐Brave Search官方 API免费额度仅搜索⭐⭐⭐⭐⭐DuckDuckGo (ddgs)开源免费仅搜索⭐⭐⭐⭐⭐Exa商业服务付费语义搜索⭐⭐⭐⭐Firecrawl商业服务付费搜索 抓取⭐⭐⭐Parallel商业服务付费搜索 内容提取⭐⭐⭐SearXNG自建免费聚合搜索⭐⭐⭐⭐Tavily商业服务付费Agent 专用搜索⭐⭐⭐⭐xAI Web SearchxAI付费Grok 联网搜索⭐⭐⭐Skip跳过-后续配置⭐⭐⭐Hermes 已经内置免费的 DuckDuckGo 搜索能力。如果只是日常搜索可以直接跳过高级搜索服务。后面会询问是否登录 Nous Portal使用官方托管的 Firecrawl 搜索服务。出现下面提示时Loginto Nous Portal now?[Y/n]:普通用户可以输入n这样无需额外账号也能使用基础联网搜索。方案是否需要账号是否收费推荐DuckDuckGo内置不需要免费⭐⭐⭐⭐⭐Nous Subscription需要订阅⭐⭐配置完成后会看到成功提示。验证安装是否成功安装完成后不要急着关终端。建议按下面这组命令检查一遍基本能覆盖环境、模型、网关、日志和后续重新配置。检查环境先跑官方推荐的诊断命令hermes doctor这个命令会检查依赖、配置、安装方式、环境变量等问题。如果缺少组件通常会直接给出修复建议。如果想看当前配置可以执行hermes config如果是排查问题、准备发 issue 或找人帮忙也可以导出一份脱敏摘要hermes dump启动命令行助手进入 Hermes 交互界面hermes能正常进入对话界面并且输入一句话后模型有回复说明模型 Provider、API Key 和推理服务基本没问题。如果只想跑一次命令也可以用hermes chat-q你好请介绍一下你自己查看网关状态如果前面把 Gateway 安装成了 systemd 服务优先看系统服务状态systemctl status hermes-gateway看到类似下面的状态就说明服务正在运行active (running)也可以用 Hermes 自带的 gateway 命令查看hermes gateway status如果你是在 WSL、Docker 或 Termux 里运行官方更推荐前台运行 Gatewayhermes gateway run查看网关日志微信机器人收不到消息、扫码后掉线、Gateway 起不来时先看日志journalctl-uhermes-gateway-f如果你使用的是用户级 systemd 服务则查看journalctl--user-uhermes-gateway-fHermes 也提供了自己的日志命令可以用来查看 agent、gateway 和错误日志hermes logs重新配置如果配置过程中选错了或者后面想重新走一遍完整向导执行hermes setup官方文档里也提供了按模块重新配置的方式。比如只改模型、消息平台或工具不需要完整走一遍安装向导。修改模型官方推荐的模型配置命令是hermes model它会进入 Provider 和模型选择器可以新增 Provider、输入 API Key、选择模型。也可以直接跳到 setup 向导里的模型配置部分hermes setup model注意区分一下hermes model是终端里的完整模型配置向导聊天过程中的/model只是在已经配置好的模型之间切换。修改消息平台如果后面想重新配置微信、QQ、钉钉、飞书、Slack 等消息平台可以执行hermes gateway setup也可以用 setup 分段命令hermes setup gateway如果 Gateway 服务已经在运行改完配置后建议重启一次systemctl restart hermes-gateway修改工具配置如果想重新选择 Web Search、Browser Automation、Terminal、File Operations、Memory、Cron Jobs 等工具能力执行hermes tools或者hermes setup tools修改完工具后再进入 Hermes 测一下搜索、文件操作或终端命令确认工具开关符合预期。常用验证命令汇总最后把常用命令放在一起后面排查时可以直接复制。# 检查环境和依赖hermes doctor# 查看当前配置hermes config# 启动命令行助手hermes# 单次测试模型回复hermes chat-q你好请介绍一下你自己# 查看 Gateway systemd 服务systemctl status hermes-gateway# 查看 Gateway 日志journalctl-uhermes-gateway-f# 查看 Hermes 自身日志hermes logs# 重新完整配置hermes setup# 修改模型hermes model hermes setup model# 修改消息平台hermes gateway setup hermes setup gateway# 修改工具配置hermes tools hermes setup tools测试模型进入 Hermeshermes输入你好请介绍一下你自己如果能正常回复说明这几项已经跑通TokenHub API 模型 推理服务测试联网搜索进入 Hermes 后输入帮我搜索 Spring Boot 最新版本或者搜索 OpenAI 最近一周新闻如果能返回搜索结果说明 DuckDuckGo 搜索能力已经正常工作。测试微信机器人先看 Gateway 服务状态systemctl status hermes-gateway如果显示active (running)就可以直接给刚绑定的微信 Bot 发消息。收到回复说明模型、Gateway、微信接入这条链路已经打通。切换模型Agent 任务比较耗 Token。尤其是联网搜索、网页总结、工具调用多的任务一次下来消耗会比较明显。如果当前模型额度不够可以切换到其他还有额度的模型。执行hermes model如果需要恢复之前的会话也可以在界面里选择历史会话。总结这次完整跑下来Hermes Agent 的核心链路基本就是安装 Hermes ↓ 配置模型 Provider 和 API Key ↓ 开启 Tools ↓ 配置 Web Search ↓ 接入微信 ↓ 安装 Gateway 后台服务 ↓ 测试模型、搜索、微信消息如果只是本机体验装完 Hermes、配好模型就够了。如果想把它当微信机器人长期挂在服务器上建议把 Gateway 配成 systemd 服务并且认真设置私聊权限避免被别人随便调用消耗额度。Hermes Agent 相关命令还有很多后面可以继续看官方文档。欢迎关注我的公众号【兮动人】每天分享技术文章和实战经验。