Hermes Agent 安装部署攻略60秒入门这个可成长的AI助手实用指南

作者：袖梨 2026-08-22

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Hermes Agent 安装部署攻略60秒入门这个可成长的AI助手”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

目录
  • Hermes Agent 是什么
  • 更快安装（建议）
  • 手动安装（折腾版）
    • Step 1: 克隆仓库
    • Step 2: 安装 uv 和虚拟环境
    • Step 3: 安装依赖
    • Step 4: 建目录和设置
    • Step 5: 填 API Key
    • Step 6: 加到 PATH
    • Step 7: 验证安装
  • 设置 LLM 模型
  • 常用问题
  • 写在最后

实际处理时，说实话，第一次看到 Hermes Agent 的宣传时，我是持怀疑态度的。“可成长的 AI Agent”、“内置学习循环”、“跨会话记忆”——听起来又是一个概念炒作。但研究了一下发现，这是 Nous Research 出的东西，他们之前训过 Hermes 大模型，口碑还不错。抱着试试看的心态装了一下，结果发现确实有点东西。

今天分享下安装部署过程，帮大家省掉我踩的那些坑。

Hermes Agent 是什么

轻松说，这是一个自主运行的 AI Agent从实现思路看，，不是那种在 IDE 里给你补全代码的 Copilot，也不是轻松套了个 API 的聊天机器人。它有几个特点让我觉得值得试试：

  • 可成长：内置记忆系统，会随着采用越来越懂你
  • 多平台：兼容 CLI、T@elegrimm、Discord、飞书、微信等 15+ 平台
  • 技能系统：能自己新建和管理技能，像学到的经验能够沉淀下来
  • 多种运行方式：本地、Docker、SSH、Modal 云端、Daytona 等

官方文档在 （链接已移除）

更快安装（建议）

官方给了一键安装脚本，Linux、macOS、WSL2 都兼容：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Windows 用户需先装 WSL2，不兼容原生 Windows。

脚本会自动处理：

  • Python 3.11（借助 uv）
  • Node.js v22（浏览器自动化和微信桥接需）
  • ripgrep（更快文件搜索）
  • ffmpeg（TTS 音频转换）
  • 仓库克隆
  • 虚拟环境设置
  • hermes 命令全局安装

装完之后：

source ~/.bashrc  # 或 source ~/.zshrc
hermes  # 启动聊天！

手动安装（折腾版）

若你想完全掌控安装过程，或者跟我一样喜欢折腾，能够手动来。

Step 1: 克隆仓库

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

若克隆时忘了 --recurse-submodules，补一下：

git submodule update --init --recursive

Step 2: 安装 uv 和虚拟环境

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11

Step 3: 安装依赖

export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"

.[all] 会装所有功能模块。如果只要核心功能：

uv pip install -e "."  # 核心功能
uv pip install -e ".[messaging]"  # T@elegrimm/Discord 支持
uv pip install -e ".[voice]"  # 语音模式
uv pip install -e ".[mcp]"  # MCP 支持

各模块说明：

模块功能命令
messagingT@elegrimm/Discord 网关.[messaging]
cron定时任务.[cron]
voice麦克风+音频播放.[voice]
mcpMCP 兼容.[mcp]
slackSlack 消息.[slack]
honchoAI 原生记忆.[honcho]

Step 4: 建目录和设置

mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env

Step 5: 填 API Key

echo 'OPENROUTER_API_KEY=sk-or-v1-your-key-here' >> ~/.hermes/.env

至少要有一个 LLM Provider Key。能够选：

  • OpenRouter（建议，接入很多模型）
  • Anthropic
  • OpenAI
  • Nous Portal

Step 6: 加到 PATH

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Step 7: 验证安装

hermes version  # 检查命令是否可用
hermes doctor   # 运行诊断
hermes ch@t -q "Hello! What tools do you available?"  # 测试对话

设置 LLM 模型

hermes model

交互式选择 provider 和模型。也能够直接设置：

hermes config set OPENROUTER_API_KEY sk-or-v1-your-key
hermes model  # 然后用上下键选择

常用问题

Q: hermes: command not found
A: 重新加载 shell source ~/.bashrc，或者检查 PATH 是否包含 ~/.local/bin

Q: API key not set
A: 运行 hermes model 设置 provider，或 hermes config set OPENROUTER_API_KEY your_key

Q: Missing config after update
A: 运行 hermes config check 随后 hermes config migrate

写在最后

从实现思路看，用了一段时间后，我觉得它的记忆系统确实有意思——不是那种轻松的对话历史，而是会主动整理和沉淀知识。技能系统也挺好用，学到的东西能够跨会话复用。

从实现思路看，当然，作为开源项目，还在更快迭代中，有些功能还不完善。感兴趣的能够试试，有问题能够提 Issue。

官方 GitHub：（链接已移除）

实际处理时，到此这篇关于Hermes Agent 安装部署攻略60秒入门这个可成长的AI助手的文章就介绍到这了,更多相关Hermes Agent 安装部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多兼容脚本之家！

相关文章

精彩推荐