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

2026-05-19 10:45:42 码绘春秋

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

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

Hermes Agent 是什么

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

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

官方文档在 https://hermes-agent.nousresearch.com/docs/

快速安装（推荐）

官方给了一键安装脚本，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]"  # Telegram/Discord 支持
uv pip install -e ".[voice]"  # 语音模式
uv pip install -e ".[mcp]"  # MCP 支持

各模块说明：

模块	功能	命令
messaging	Telegram/Discord 网关	`.[messaging]`
cron	定时任务	`.[cron]`
voice	麦克风+音频播放	`.[voice]`
mcp	MCP 支持	`.[mcp]`
slack	Slack 消息	`.[slack]`
honcho	AI 原生记忆	`.[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 chat -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：https://github.com/nousresearch/hermes-agent

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