Appearance
Hermes Agent保姆级入门教程：从安装到运行全流程
从零开始，手把手带你把这个会"自我成长"的AI助手跑起来。
安装前的准备
系统要求
| 系统 | 要求 |
|---|---|
| Linux | Ubuntu 20.04以上（推荐） |
| macOS | 10.15以上 |
| Windows | 需先装WSL2 |
| Android | 通过Termux也能跑 |
硬件配置
- 内存：2GB起步，4GB更好
- 磁盘：留出5GB空间
- 网络：能上网就行
准备工作
确保电脑上装了Git，其他东西安装脚本会帮你自动搞定。
bash
# 检查Git
git --version安装Git：
bash
# Ubuntu/Debian
sudo apt update
sudo apt install git
# macOS
brew install git准备API密钥
Hermes Agent本身免费，但需要调用大语言模型。
| 推荐选项 | 说明 |
|---|---|
| OpenRouter | 最省事，一个账号能用200多个模型 |
| Anthropic Claude | 如果你订阅了Claude |
| GitHub Copilot | 如果你订阅了Copilot |
| 国内模型 | 智谱AI、Kimi、MiniMax、Qwen |
快速安装
一键安装
打开终端，复制这行命令：
bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash脚本会帮你搞定：
| 自动安装 | 说明 |
|---|---|
| Python 3.11 | 如果你还没装 |
| Node.js | 浏览器自动化要用 |
| ripgrep | 文件搜索工具 |
| ffmpeg | 音频处理 |
| Hermes Agent代码 | 下载并安装 |
| 虚拟环境 | 装好依赖 |
整个过程大概2-5分钟。
装完之后
重新加载shell配置：
bash
source ~/.bashrc # bash用户
# 或者
source ~/.zshrc # zsh用户验证：
bash
hermes --version能看到版本号就说明装好了。
首次配置
方法一：配置向导（新手推荐）
bash
hermes setup跟着提示走：
- 选LLM提供商：用方向键选（比如OpenRouter），回车确认
- 输入API密钥：粘贴你的API Key，回车
- 选默认模型：推荐anthropic/claude-sonnet-4（性价比高）
- 配置工具集：默认全开就行
方法二：手动配置（老手用）
bash
# 选模型提供商
hermes model
# 设API密钥
hermes config set OPENROUTER_API_KEY sk-or-v1-你的密钥
# 看看配置
hermes config配置文件在哪
~/.hermes/
├── config.yaml # 主配置
├── .env # API密钥（别泄露）
├── SOUL.md # Agent的"人格"
├── memories/ # 记忆存储
├── skills/ # 学到的技能
└── sessions/ # 会话历史开始使用
第一次对话
bash
hermes你会看到欢迎界面，显示：当前用的什么模型、有哪些工具可用、装了哪些技能。
试试这些：
❯ 你好，介绍一下你自己
❯ 你有哪些工具可以用？
❯ 帮我搜索一下2026年最新的AI发展趋势基本操作
| 操作 | 方法 |
|---|---|
| 多行输入 | 按Alt+Enter或Ctrl+J换行 |
| 中断Agent | 输入新消息回车，或Ctrl+C |
| 退出对话 | Ctrl+D 或 /exit |
斜杠命令
| 命令 | 干啥用的 | 例子 |
|---|---|---|
| /help | 看帮助 | /help |
| /model | 换模型 | /model |
| /tools | 看/管理工具 | /tools |
| /save | 保存对话 | /save my-conversation |
| /personality | 改Agent性格 | /personality pirate |
| /voice on | 开语音模式 | /voice on |
| /background | 后台跑任务 | /background 搜索今天的科技新闻 |
试试这个好玩的：
/personality pirate再问它问题，它会用海盗口吻回答你。
恢复之前的对话
bash
hermes --continue # 简写：hermes -c
# 看所有历史会话
hermes sessions list
# 恢复特定会话
hermes --resume <会话ID>进阶功能
1. 安全沙箱（重要）
默认情况下，Hermes的终端命令直接在你电脑上跑，有安全风险。强烈建议配个Docker沙箱。
装Docker：
bash
# Ubuntu/Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 重新登录让权限生效
# macOS：去Docker官网下载Docker Desktop配置Hermes用Docker：
bash
hermes config set terminal.backend docker2. 连接消息平台
想在手机上通过Telegram或Discord跟Hermes聊天？
设置Telegram Bot：
- 在Telegram找 @BotFather
- 发 /newbot，按提示设名字和用户名
- 拿到Bot Token
配置Hermes：
bash
hermes gateway setup
# 选Telegram，输入Bot Token
hermes gateway start在Telegram找到你的Bot，发 /start 就能聊了。
3. 定时任务
bash
❯ 每天早上8点，搜索Hacker News上的AI新闻，总结后通过Telegram发给我Hermes会自动创建定时任务（cron job）。
看所有定时任务：
bash
hermes cron list4. 技能系统
这是Hermes最牛的功能之一。
bash
# 逛技能市场
hermes skills search kubernetes
# 装技能
hermes skills install official/github/pr-workflow装完技能会自动变成斜杠命令：
/github-pr-workflow 帮我为auth重构创建一个PRAgent自动学技能：当你让Hermes完成一个复杂任务后，它可能会问你："要不要我把这个流程保存成技能，下次直接用？"选"是"，Hermes就会自动创建一个可复用的技能。
5. 语音模式
bash
pip install "hermes-agent[voice]"
pip install faster-whisper # 本地语音识别
# 在CLI里用
hermes
/voice on按Ctrl+B开始录音，再按一次停止。
日常维护
更新Hermes
bash
hermes update检查健康状态
bash
hermes doctor管理记忆
bash
# 看记忆统计
hermes memory stats
# 归档旧会话
hermes memory archive --before "2026-03-01"
# 清理低价值记忆
hermes memory prune --importance < 3备份配置
bash
# 备份整个.heroku目录
tar -czf hermes-backup-$(date +%Y%m%d).tar.gz ~/.hermes/
# 恢复备份
tar -xzf hermes-backup-20260410.tar.gz -C ~/常见问题
Q1: 装完提示"command not found: hermes"
bash
source ~/.bashrc
echo $PATH | grep ".local/bin"
# 没有.local/bin的话，手动加上
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcQ2: 提示"API key not set"
bash
hermes model
# 或者
hermes config set OPENROUTER_API_KEY 你的密钥Q3: Docker后端起不来
bash
docker version
# 没跑的话启动
sudo systemctl start dockerQ4: 国内网络环境怎么用
用国内模型：智谱AI、Kimi、MiniMax、Qwen
或配代理：
bash
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890快速命令参考
bash
# 基本操作
hermes # 开始聊天
hermes -c # 继续上次对话
hermes -q "问题" # 单次问答
# 配置管理
hermes setup # 完整配置向导
hermes model # 选模型
hermes config # 看配置
hermes doctor # 健康检查
# 技能管理
hermes skills search 关键词
hermes skills install ID
hermes skills list
# 网关管理
hermes gateway setup
hermes gateway start
hermes gateway stop
# 维护
hermes update
hermes memory stats
hermes memory pruneHermes Agent会随着你的使用越来越聪明，用得越多，它就越懂你。
关键词：Hermes Agent, 安装教程, OpenRouter, Claude, 记忆系统, 技能系统
